开发者文档

回填作品链接

POST/api/publishing-shares/:token/submissions

权限与前置条件

当前任务领取者;受任务状态、截止时间和档案状态约束。

支持账号中心 API Key:Authorization: Bearer <ltak_…>。中心每次实时校验,仍执行当前用户的工作区角色和业务权限。Cookie 写入仍需允许来源的 Origin 和 X-Requested-With: suren360。不能同时携带 Cookie 与 API Key。所有路径参数须使用真实 ID。

请求参数

token · 路径参数 · 必填字符串

JSON 请求体

字段类型必填约束
urlsarray是{"minItems":1,"maxItems":50}
previewTokenstring否{"minLength":48,"maxLength":48}
accountobject否{"required":["platform","nickname","homepage"]}
查看完整请求 JSON Schema
JSON Schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "urls": {
      "minItems": 1,
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 2000,
        "format": "uri"
      }
    },
    "previewToken": {
      "type": "string",
      "minLength": 48,
      "maxLength": 48
    },
    "account": {
      "type": "object",
      "properties": {
        "platform": {
          "type": "string",
          "enum": [
            "小红书",
            "抖音",
            "微信视频号",
            "微信公众号"
          ]
        },
        "nickname": {
          "type": "string",
          "minLength": 1,
          "maxLength": 120
        },
        "homepage": {
          "type": "string",
          "maxLength": 2000,
          "format": "uri"
        },
        "stableId": {
          "type": "string",
          "maxLength": 191
        }
      },
      "required": [
        "platform",
        "nickname",
        "homepage"
      ]
    }
  },
  "required": [
    "urls"
  ],
  "additionalProperties": false
}

调用示例

先在统一账号中心创建 Key,并授权素人种草 360 应用,将密钥安全设置为 LINGTU_API_KEY 环境变量。 请替换部署地址与示例字段,不要将凭证粘贴到聊天或日志中。

cURL · 示例占位值需替换
curl --request POST \
  'https://YOUR_DEPLOYMENT_HOST/api/publishing-shares/YOUR_token/submissions' \
  --header "Authorization: Bearer $LINGTU_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "urls": [
    "https://example.com/work/123"
  ]
}'

响应结构

成功返回 HTTP 200 的 JSON 对象。下方为响应结构定义,不是虚构的业务数据。

字段类型必填约束
submittednumber是{}
duplicatesnumber是{}
查看完整响应 JSON Schema
JSON Schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "submitted": {
      "type": "number"
    },
    "duplicates": {
      "type": "number"
    }
  },
  "required": [
    "submitted",
    "duplicates"
  ],
  "additionalProperties": false
}
查看错误码与重试规则