多平台分享图片 API

服务端自动识别分享链接所属平台，解析单页或多页作品，并为选中的作品生成独立下载地址。推荐使用两步流程：先获取作品列表，再提交需要下载的 item_ids。

1. 调用 POST /v1/works，获得平台、作品数量和每页的 item_id。
2. 调用 POST /v1/download-selected，提交一个或多个 item_ids。
3. 访问返回的 download_url，下载对应的单张图片。

支持平台

链接可以是原始 URL、Markdown 包装链接，或带中文句号等尾部标点的 URL。服务端会先清洗链接，再识别平台并选择对应 Cookie 配置。

身份认证

业务接口通过请求头传入 API Key：

X-API-Key: gda_xxxxxxxxxxxxxxxxx
Content-Type: application/json

平台识别

{
  "share_url": "https://www.chuangkit.com/sharedesign?d=DESIGN_ID。"
}

{
  "ok": true,
  "platform": "chuangkit",
  "share_url": "https://www.chuangkit.com/sharedesign?d=DESIGN_ID",
  "connector_status": "active"
}

1. 解析作品列表

返回分享链接中的全部已解析作品。单页作品返回一个条目，多页作品按页面顺序生成连续的 item_id。此步骤不扣费。

请求

{
  "share_url": "https://www.chuangkit.com/sharedesign?d=DESIGN_ID"
}

多页响应示例

{
  "ok": true,
  "platform": "chuangkit",
  "share_url": "https://www.chuangkit.com/sharedesign?d=DESIGN_ID",
  "count": 4,
  "items": [
    {"id": 1, "thumbnail_url": "https://.../page-1"},
    {"id": 2, "thumbnail_url": "https://.../page-2"},
    {"id": 3, "thumbnail_url": "https://.../page-3"},
    {"id": 4, "thumbnail_url": "https://.../page-4"}
  ]
}

2. 选择作品并生成下载地址

使用第一次调用返回的标准化 share_url 和 item_id。可以只选择一页，也可以一次选择多页。每页返回独立下载地址，不生成 ZIP。此步骤不扣费。

选择单页

{
  "share_url": "https://www.chuangkit.com/sharedesign?d=DESIGN_ID",
  "item_ids": [2]
}

选择多页

{
  "share_url": "https://www.chuangkit.com/sharedesign?d=DESIGN_ID",
  "item_ids": [1, 3, 4]
}

响应

{
  "ok": true,
  "count": 1,
  "items": [
    {
      "id": 2,
      "thumbnail_url": "https://.../page-2",
      "download_url": "/v1/download-link/TOKEN"
    }
  ]
}

获取图片文件

返回所选作品的图片二进制内容，并设置附件文件名。下载地址有效期约 30 分钟。临时平台签名失效时，服务端会重新解析作品地址后重试。

可能的响应类型：

直接解析与下载

解析单个资源

返回第一个解析结果的图片地址，适用于旧版单资源接入。该接口调用成功后立即扣费。

{"share_url":"https://SUPPORTED_SHARE_URL"}

直接返回图片

解析分享链接并直接返回第一张图片文件，调用成功后立即扣费。多页选择场景应使用推荐的两步流程。

Cookie 配置

管理后台添加 Cookie 时必须选择平台。解析和下载只会读取识别平台对应的 Cookie 池，避免跨平台分配。

Authorization: Bearer ADMIN_TOKEN

{
  "platform": "chuangkit",
  "name": "chuangkit-main",
  "value": "cookie_name=cookie_value; another=value"
}

平台值：

错误码

账户充值

注册用户通过电子邮件地址创建充值订单。订单支付成功后，服务端验签、增加用户与 API Key 额度，并通过已启用的 SMTP 配置发送到账邮件。

查询可用支付方式

{
  "credits_per_cny": "1",
  "payment_methods": [
    {"value": "alipay", "label": "支付宝"},
    {"value": "wechat", "label": "微信支付"}
  ]
}

创建支付订单

{
  "email": "name@example.com",
  "amount": "10.00",
  "payment_method": "alipay"
}

{
  "ok": true,
  "order_no": "DD20260815000000XXXXXXXXXX",
  "amount": "10.00",
  "credits": 10,
  "payment_url": "https://payment-gateway.example/..."
}

查询订单状态

status 为 pending 或 paid。用户端只提交支付宝或微信支付，实际支付渠道由管理员后台配置。支付回调采用金额核对、平台验签和幂等入账，同一订单的重复回调只计入一次额度。

计费说明

每次成功下载一张图片，扣除后台设置的单张下载额度。选择多个页面后，每个下载地址分别计费。