API 开放接口文档 - Pixel 订阅

POST /api/open/submit 提交需要绑定或处理的账号任务

请求参数说明 (Headers & Body)

字段名	类型	必填	说明
card_secret	string	必填	系统卡密密钥，用于扣除并激活订阅订单。
mode	string	必填	提交模式：`single` (单账号提交) 或 `batch` (批量账号提交)。
accounts	array	必填	包含账号具体信息的数组对象列表。
accounts[].username	string	必填	需要绑定的目标账号（邮箱或用户名）。
accounts[].password	string	必填	目标账号密码。
accounts[].two_factor	string	必填	账号的二步验证(2FA)密钥（32位密钥）或备用验证码。
accounts[].extra_email	string	选填	辅助验证邮箱，主要用于某些安全登录场景下的验证码接收。

请求 Payload 示例 (JSON)

{
  "card_secret": "ABCD1234EFGH5678",
  "mode": "single",
  "accounts": [
    {
      "username": "user@example.com",
      "password": "yourpassword123",
      "two_factor": "JBSWY3DPEHPK3PXP",
      "extra_email": "backup@example.com"
    }
  ]
}

返回数据示例 (JSON)

{
  "success": true,
  "message": "已成功提交任务，排队处理中"
}

GET /api/open/query 查询卡密关联订单的全部账号执行状态

请求 Query 参数说明

参数名	类型	必填	说明
card_secret	string	必填	卡密，用于反查对应的订单和历史账号提交明细。

请求 URL 示例

http://domain.com/api/open/query?card_secret=ABCD1234EFGH5678

返回数据示例 (JSON)

{
  "success": true,
  "records": [
    {
      "id": 142,
      "username": "user@example.com",
      "status": "success",
      "message": "订阅成功绑定，绑卡信息已生效",
      "discount_url": "https://pixel.sub/discount/CLAIM-MOCK-ABCD-user",
      "created_at": "2026-07-06T10:00:00Z",
      "completed_at": "2026-07-06T10:01:20Z"
    }
  ]
}

状态码说明 (status)

pending：任务正在排队中，系统将在几分钟内启动处理。
running：系统正在登录账号并绑定订阅产品。
success：绑定成功，结果字段中会包含优惠提取链接。
failed：任务执行失败，可在消息字段中查看具体失败原因（如密码错误、2FA失效）。

POST /api/open/reset 批量重置已绑定的卡密并生成新激活卡密

请求 Header 说明

Header名	类型	必填	说明
Content-Type	string	必填	必须为 `application/json`

请求 JSON Body 参数

字段名	类型	必填	说明
old_keys	string[]	必填	需要被重置的旧卡密列表。单次最大支持 50 个。

请求 Payload 示例 (JSON)

{
  "old_keys": [
    "ABCD1234EFGH5678"
  ]
}

返回数据示例 (JSON)

{
  "success": true,
  "new_keys": [
    "WXYZ5678ABCD1234"
  ],
  "original_keys": [
    "ABCD1234EFGH5678"
  ],
  "message": "重置密钥成功"
}

POST /api/open/cancel 取消处于排队中 (pending) 状态的订阅任务

请求 Header 说明

Header名	类型	必填	说明
Content-Type	string	必填	必须为 `application/json`

请求 JSON Body 参数

字段名	类型	必填	说明
card_secret	string	必填	提交任务时使用的授权卡密。
username	string	必填	需要取消的订阅账号（用户名/邮箱）。
lang	string	可选	可选：`zh` / `en` / `ko`，用于控制接口返回消息的语言。

请求 Payload 示例 (JSON)

{
  "card_secret": "ABCD1234EFGH5678",
  "username": "user@example.com",
  "lang": "zh"
}

返回数据示例 (JSON)

{
  "success": true,
  "message": "取消排队成功，积分已退还"
}