自动化打包 API

面向开发者的 REST 接口文档。支持网页封装、多端打包、任务查询与账户管理。

REST API JSON 响应 密钥鉴权 包月免费额度
接口前缀
/xcapi
示例域名
api.tt906.com
数据格式
application/json
技术支持
微信 ksfsbmz
鉴权说明

所有业务接口通过 Query 参数 key 传递用户密钥,密钥可在登录后的「个人信息」中查看。

Web 端可选签名头(服务端识别来源):

Header说明
Xc-TimestampUnix 时间戳(秒)
Xc-Source来源标识,如 web / api
Xc-SignatureBase64(timestamp + source + secret)

统一响应结构:

{
  "code": 0,           // 0=成功,非 0=失败
  "message": "提示信息",
  "data": {},          // 业务数据
  "total_count": 0     // 列表接口总数(可选)
}
POST 上传图片
/xcapi/files?key={密钥}
参数类型必填位置说明
keyStringQuery用户密钥
fileFileFormjpg / jpeg / png
// 成功响应
{
  "code": 0,
  "data": { "id": 123 },
  "message": "上传成功"
}
POST 提交打包任务
/xcapi/tasks?key={密钥}
参数类型必填说明
project_idInt项目 ID,见 /projects
nameString应用名称
iconInt图标文件 ID(1=公共图标)
backgroundInt启动图 ID(2=公共启动图)
argsJSON 字符串项目参数,见下方示例
packageString包名,留空随机
notice_urlString完成回调 GET 地址,参数 id=任务ID
包月用户:部分 App 类型在每日额度内可免费生成。普通包月可免 is_vip=1 的项目;高级包月可免 is_vip=1/2 的项目。
{
  "code": 0,
  "data": { "id": 10086 },
  "message": "创建任务成功"
}
GET 获取 App 类型列表
/xcapi/projects?key={密钥}
字段说明
project_id提交任务时使用
name / img / tags名称、预览图、标签
money单次价格(元)
is_vip0 按次;1 普通包月免费;2 高级包月免费
keys表单字段定义,用于构造 args
常见 args 示例

普通网页封装 (project_id=1)

{"url": "https://www.example.com"}

彩虹 (project_id=3)

{
  "url": "https://www.example.com",
  "theme": "#1c97f5"
}

网页菜单版 (project_id=5)

{
  "url": "https://www.example.com",
  "menus": [
    { "name": "首页", "url": "https://www.example.com", "type": 0 }
  ],
  "theme": "#1c97f5",
  "load_theme": "#1c97f5"
}

更多字段请在前台「在线提交」选择 App 类型后,对照表单字段名构造 JSON。

GET 查询任务列表
/xcapi/tasks/query?key={密钥}
参数说明
id指定任务 ID
project_id按项目筛选
status-1 失败 / 0·2 生成中 / 1 成功 / 4 过期
page, limit分页,limit ≤ 50

返回 data 数组主要字段:

字段说明
icon/xcapi/icon/{md5}
pay_method1 余额 / 2 包月额度 / 3 卡密
android_url, ios_url移动端下载
windows_url, macos_url, ubuntu_url桌面端下载
download_expire_days链接剩余天数
is_refunded失败是否已退款
GET 生成本地分发页 ZIP
/xcapi/tasks/create_download_page_zip/{任务ID}?key={密钥}
{
  "code": 0,
  "data": { "download_url": "https://..." },
  "message": "生成成功"
}
GET 查询账户信息
/xcapi/users/{密钥}
字段说明
money账户余额
vip_status包月状态文字描述
vip_level0 无 / 1 普通 / 2 高级
vip_active包月是否在有效期内
daily_quota每日免费生成额度
icon_id, background_id默认图标与启动图
任务 status 说明
含义
1生成成功,可下载
0 / 2正在生成或重新打包
3队列等待中
-1生成失败(通常自动退款)
4下载链接已过期