自动化打包 API
面向开发者的 REST 接口文档。支持网页封装、多端打包、任务查询与账户管理。
接口前缀
/xcapi示例域名
api.tt906.com
数据格式
application/json
技术支持
微信 ksfsbmz
鉴权说明
所有业务接口通过 Query 参数 key 传递用户密钥,密钥可在登录后的「个人信息」中查看。
Web 端可选签名头(服务端识别来源):
| Header | 说明 |
|---|---|
Xc-Timestamp | Unix 时间戳(秒) |
Xc-Source | 来源标识,如 web / api |
Xc-Signature | Base64(timestamp + source + secret) |
统一响应结构:
{
"code": 0, // 0=成功,非 0=失败
"message": "提示信息",
"data": {}, // 业务数据
"total_count": 0 // 列表接口总数(可选)
}POST 上传图片
/xcapi/files?key={密钥}
| 参数 | 类型 | 必填 | 位置 | 说明 |
|---|---|---|---|---|
| key | String | 是 | Query | 用户密钥 |
| file | File | 是 | Form | jpg / jpeg / png |
// 成功响应
{
"code": 0,
"data": { "id": 123 },
"message": "上传成功"
}POST 提交打包任务
/xcapi/tasks?key={密钥}
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| project_id | Int | 是 | 项目 ID,见 /projects |
| name | String | 是 | 应用名称 |
| icon | Int | 是 | 图标文件 ID(1=公共图标) |
| background | Int | 是 | 启动图 ID(2=公共启动图) |
| args | JSON 字符串 | 是 | 项目参数,见下方示例 |
| package | String | 否 | 包名,留空随机 |
| notice_url | String | 否 | 完成回调 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_vip | 0 按次;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_method | 1 余额 / 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_level | 0 无 / 1 普通 / 2 高级 |
| vip_active | 包月是否在有效期内 |
| daily_quota | 每日免费生成额度 |
| icon_id, background_id | 默认图标与启动图 |
任务 status 说明
| 值 | 含义 |
|---|---|
| 1 | 生成成功,可下载 |
| 0 / 2 | 正在生成或重新打包 |
| 3 | 队列等待中 |
| -1 | 生成失败(通常自动退款) |
| 4 | 下载链接已过期 |