自动化打包开发文档

简单、高效、实用的 App 生成平台 Open API。对接问题请联系微信：ksfsbmz

新版交互文档：new_md.html

基础说明

接口前缀：/xcapi（示例域名：https://api.tt906.com/xcapi）
鉴权方式：绝大多数接口通过 Query 参数 key 传递用户密钥
统一响应：code（0 成功）、message、data；列表接口额外返回 total_count
Web 端请求可携带签名头（可选）：Xc-Timestamp、Xc-Source、Xc-Signature

上传图片

POST/files?key={密钥}

请求参数

字段名	类型	必填	方式	说明	示例
key	String	是	Query	用户密钥	c4ca4238...
file	File	是	Form	图片文件 jpg/jpeg/png	—

返回示例

{
  "code": 0,
  "data": { "id": 1 },
  "message": "上传成功"
}

提交任务

POST/tasks?key={密钥}

请求参数

字段名	类型	必填	方式	说明	示例
key	String	是	Query	用户密钥	—
project_id	Int	是	POST	项目 ID	3
package	String	否	POST	包名，留空随机	com.demo.app
name	String	是	POST	应用名称	我的应用
icon	Int	是	POST	图标文件 ID	1 为公共图标
background	Int	是	POST	启动图文件 ID	2 为公共启动图
args	JSON	是	POST	项目参数 JSON 字符串	{"url":"https://example.com"}
notice_url	String	否	POST	任务完成回调 URL（GET，参数 id=任务ID）	—

包月用户生成部分项目时可能免费（消耗每日额度），具体以项目 is_vip 与用户包月等级为准。

返回示例

{
  "code": 0,
  "data": { "id": 10086 },
  "message": "创建任务成功"
}

查看 App 类型 / 项目 ID

GET/projects?key={密钥}

返回字段（data 数组项）

字段	说明
project_id	提交任务时使用的项目 ID
name	项目名称
money	单次价格（元）
is_vip	0 按次付费；1 普通包月可免费；2 高级包月可免费
keys	在线表单字段定义，用于构造 args
tags / img	标签与预览图

部分项目 args 示例

普通网页封装 project_id=1：{"url":"https://www.example.com"}
彩虹 project_id=3：{"url":"https://www.example.com","theme":"#1c97f5"}
网页菜单版 project_id=5：{"url":"...","menus":[{"name":"首页","url":"...","type":0}],"theme":"#1c97f5","load_theme":"#1c97f5"}

更多字段含义请在平台首页「在线提交」选择对应 App 类型后，查看表单字段名称。

查询任务进度

GET/tasks/query?key={密钥}

常用 Query 参数

字段名	类型	说明
id	Int	任务 ID
project_id	Int	项目 ID
status	Int	-1 失败；0/2 生成中；1 成功；4 链接失效
page / limit	Int	分页，limit 最大 50
url 等	String	按 args 内字段筛选

data 项主要字段

字段	说明
id	任务 ID
name / package	应用名称、包名
icon	图标地址，如 `/xcapi/icon/{md5}`
pay_method	1 余额；2 包月额度；3 卡密
pay_money	实际支付金额
android_url / ios_url	安卓、iOS 下载链接
windows_url / macos_url / ubuntu_url	桌面端下载链接
download_expire_days	下载链接剩余有效天数
status	1 成功；0/2 生成中；3 队列；-1 失败；4 过期
is_refunded	失败是否已退款：0 否，1 是
created_at / updated_at	创建、完成时间

返回示例

{
  "code": 0,
  "total_count": 1,
  "data": [{
    "id": 1,
    "name": "我的应用",
    "icon": "/xcapi/icon/abc123...",
    "pay_method": 1,
    "pay_money": "1.00",
    "android_url": "https://...",
    "ios_url": "https://...",
    "status": 1,
    "is_refunded": 0
  }],
  "message": "查询成功"
}

获取本地分发页 ZIP

GET/tasks/create_download_page_zip/{任务ID}?key={密钥}

{
  "code": 0,
  "data": { "download_url": "https://..." },
  "message": "生成成功"
}

查询账户信息

GET/users/{密钥}

data 主要字段

字段	说明
key / phone / email	密钥与账号信息
money	账户余额
vip_status	包月状态描述
vip_level	0 无；1 普通包月；2 高级包月
vip_active	包月是否在有效期内
daily_quota	包月每日生成额度
icon_id / background_id	默认图标、启动图 ID
task_succeeded_total_count	成功生成次数
task_failed_total_count	失败次数

{
  "code": 0,
  "data": {
    "key": "c4ca4238a0b923820dcc509a6f75849b",
    "money": "100.00",
    "vip_status": "普通包月（2026-12-01 00:00:00），每日限额200次",
    "vip_level": 1,
    "vip_active": true,
    "daily_quota": 200
  },
  "message": "查询成功"
}