开发者文档

分享任务详情

GET/api/publishing-shares/:token

权限与前置条件

匿名仅返回任务摘要;领取者才可查看正文和素材。

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

请求参数

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

Query 查询参数

无额外字段;联合结构请查看完整定义。

查看完整请求 JSON Schema
JSON Schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

调用示例

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

cURL · 示例占位值需替换
curl --request GET \
  'https://YOUR_DEPLOYMENT_HOST/api/publishing-shares/YOUR_token' \
  --header "Authorization: Bearer $LINGTU_API_KEY"

响应结构

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

字段类型必填约束
organizationobject是{"required":["name","companyName","contactEmail","contactPhone","reportEmail","reportWechat"],"additionalProperties":false}
projectstring是{}
kindstring是{"enum":["video","image"]}
deadlinestring是{"format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}
statusstring是{}
availabilitystring是{"enum":["available","mine","claimed","expired","stopped"]}
documentTextstring否{}
notesstring否{}
filesarray否{}
submissionsarray否{}
查看完整响应 JSON Schema
JSON Schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "organization": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string"
        },
        "companyName": {
          "type": "string"
        },
        "contactEmail": {
          "type": "string"
        },
        "contactPhone": {
          "type": "string"
        },
        "reportEmail": {
          "type": "string"
        },
        "reportWechat": {
          "type": "string"
        }
      },
      "required": [
        "name",
        "companyName",
        "contactEmail",
        "contactPhone",
        "reportEmail",
        "reportWechat"
      ],
      "additionalProperties": false
    },
    "project": {
      "type": "string"
    },
    "kind": {
      "type": "string",
      "enum": [
        "video",
        "image"
      ]
    },
    "deadline": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
    },
    "status": {
      "type": "string"
    },
    "availability": {
      "type": "string",
      "enum": [
        "available",
        "mine",
        "claimed",
        "expired",
        "stopped"
      ]
    },
    "documentText": {
      "type": "string"
    },
    "notes": {
      "type": "string"
    },
    "files": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "mime": {
            "type": "string"
          },
          "size": {
            "type": "number"
          },
          "kind": {
            "type": "string",
            "enum": [
              "video",
              "image",
              "document"
            ]
          },
          "status": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "name",
          "mime",
          "size",
          "kind",
          "status"
        ],
        "additionalProperties": false
      }
    },
    "submissions": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "url": {
            "type": "string"
          },
          "platform": {
            "type": "string"
          },
          "accountName": {
            "type": "string"
          },
          "accountHomepage": {
            "type": "string"
          },
          "resolution": {
            "type": "string"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
          }
        },
        "required": [
          "id",
          "url",
          "platform",
          "accountName",
          "accountHomepage",
          "resolution",
          "createdAt"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "organization",
    "project",
    "kind",
    "deadline",
    "status",
    "availability"
  ],
  "additionalProperties": false
}
查看错误码与重试规则