# 查询发布任务详情

- API 版本：1.10.0
- 最后更新：2026-09-29
- 服务地址：`https://api.ailingtu.com`
- 网页文档：[查询发布任务详情](/openapi/post-detail)
- 完整接口约束：[JSON Schema](/openapi/operations/getCreatorPost.json)
- 接口发现：[接口索引](/openapi/operations/index.json)

## GET /v1/creator/post/detail

接口标识：`getCreatorPost`

查询发布任务详情。

鉴权：请求头 `x-api-key: <YOUR_API_KEY>`；密钥仅保存在服务端。

成功判断：HTTP 2xx 且响应 code=0；异步任务还需查询最终状态。

### 请求参数

| 字段 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| `postId` | query | string | 是 | 发布任务 ID |

### 成功响应

```json
{
  "code": 0,
  "message": "success",
  "data": {
    "postId": "2011014932023390208",
    "platform": "TIKTOK_BUSINESS",
    "businessType": "FILE",
    "businessId": "591",
    "title": "New collection",
    "videoUrl": "https://cdn.example.com/video.mp4",
    "snapshot": {
      "sourceFiles": [
        {
          "materialType": "VIDEO",
          "name": "video.mp4",
          "uploadedAt": "2026-09-29 10:00:00"
        }
      ]
    },
    "scheduledAt": 1790640000000,
    "scheduledTz": "Asia/Shanghai",
    "status": "SCHEDULED",
    "tiktokBusiness": {
      "musicSoundInfo": {
        "musicSoundId": "7123456789012345678",
        "musicSoundName": "Sunrise",
        "musicSoundArtist": "Example artist",
        "musicSoundVolume": 50,
        "videoOriginalSoundVolume": 50
      },
      "locationInfo": {
        "locationId": "loc-1",
        "locationName": "London"
      }
    }
  },
  "timestamp": 1790640000000
}
```

### 响应字段

以下列出主要层级；完整结构、联合类型及校验规则以接口 JSON Schema 为准。必填指字段所在对象中的约束。

| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| `code` | integer | 是 | — |
| `message` | string | 是 | — |
| `data` | object | 是 | — |
| `data.postId` | string | 是 | — |
| `data.platform` | string | 是 | — |
| `data.businessType` | string | 否 | 素材来源，例如 FILE、EXTERNAL_URL |
| `data.businessId` | string | 否 | FILE 为文件 ID；EXTERNAL_URL 为原始 URL 的 SHA-256。原始 URL 见 videoUrl。 |
| `data.title` | string | 是 | — |
| `data.videoUrl` | string | 是 | — |
| `data.snapshot` | object \| null | 否 | 创建发布任务时保存的原始媒体快照；老数据或无文件快照时为 null。PHOTO 会返回全部源文件。 |
| `data.snapshot.sourceFiles` | object[] | 否 | 源文件列表，VIDEO 为单个文件，PHOTO 按原始图序返回全部文件。 |
| `data.snapshot.sourceFiles[].materialType` | string | 是 | 源媒体类型：VIDEO 或 PHOTO |
| `data.snapshot.sourceFiles[].name` | string | 是 | 源文件名称 |
| `data.snapshot.sourceFiles[].uploadedAt` | string | 是 | 源文件上传时间 |
| `data.scheduledAt` | integer | 是 | — |
| `data.scheduledTz` | string | 是 | — |
| `data.status` | string | 是 | — |
| `data.tiktokShop` | union | 否 | — |
| `data.tiktok` | object | 否 | — |
| `data.tiktok.coverTimestampMs` | integer | 是 | — |
| `data.tiktok.privacyLevel` | string | 是 | — |
| `data.tiktok.disableComment` | boolean | 是 | — |
| `data.tiktok.disableDuet` | boolean | 是 | — |
| `data.tiktok.disableStitch` | boolean | 是 | — |
| `data.tiktok.brandContentToggle` | boolean | 是 | — |
| `data.tiktok.brandOrganicToggle` | boolean | 是 | — |
| `data.tiktok.aigc` | boolean | 是 | — |
| `data.tiktokBusiness` | object | 否 | 可选的 Business 视频设置，不包含 privacyLevel。coverFileId 优先于 coverTimestampMs；账号已禁用的互动只能设为禁用。 |
| `data.tiktokBusiness.disableComment` | boolean | 否 | 禁用评论；账号级已禁止评论时只能为 true |
| `data.tiktokBusiness.disableDuet` | boolean | 否 | 禁用合拍；账号级已禁止合拍时只能为 true |
| `data.tiktokBusiness.disableStitch` | boolean | 否 | 禁用拼接；账号级已禁止拼接时只能为 true |
| `data.tiktokBusiness.coverTimestampMs` | integer | 否 | 视频封面截帧时间点（毫秒） |
| `data.tiktokBusiness.brandContentToggle` | boolean | 否 | 品牌内容（付费合作推广） |
| `data.tiktokBusiness.brandOrganicToggle` | boolean | 否 | 品牌自然流量（推广自己的业务） |
| `data.tiktokBusiness.aigc` | boolean | 否 | AI 生成内容 |
| `data.tiktokBusiness.musicSoundInfo` | object | 否 | 使用 musicSoundId（song_clip_id），不要使用 commercialMusicId。不传时不添加平台音乐；名称与作者仅为展示快照。 |
| `data.tiktokBusiness.musicSoundInfo.musicSoundId` | string | 否 | 热门曲目接口返回的 musicSoundId（平台的 song_clip_id），不能用 commercialMusicId |
| `data.tiktokBusiness.musicSoundInfo.musicSoundName` | string | 否 | 曲名快照，仅用于展示与详情回填；发布以 musicSoundId 为准 |
| `data.tiktokBusiness.musicSoundInfo.musicSoundArtist` | string | 否 | 歌手快照，仅用于展示与详情回填 |
| `data.tiktokBusiness.musicSoundInfo.musicSoundVolume` | integer | 否 | 音乐音量 0-100；不传按 50（平台对未传的音量按 0 处理，等于静音） |
| `data.tiktokBusiness.musicSoundInfo.videoOriginalSoundVolume` | integer | 否 | 原视频声音音量 0-100；不传按 50 |
| `data.tiktokBusiness.locationInfo` | object | 否 | locationId 与 locationName 必须同时提交；locationAddress 仅用于展示。 |
| `data.tiktokBusiness.locationInfo.locationId` | string | 否 | 地域搜索接口返回的 locationId，发布时落到 post_info.location_id |
| `data.tiktokBusiness.locationInfo.locationName` | string | 否 | 地域名称，发布时与 ID 一起传（post_info.location_name） |
| `data.tiktokBusiness.locationInfo.locationAddress` | string | 否 | 地域补充地址，仅展示与详情回填，不发给平台 |
| `data.tiktokBusinessPhoto` | object | 否 | TikTok Business 照片发布参数；platform=TIKTOK_BUSINESS 且 mediaType=PHOTO 时必填，不能与 tiktokShopPhoto 混用。图片用本系统文件 ID 传入，服务端解析成公开图片地址后发送；隐私级别取自该账号发布设置里可选的级别，不在列表里会直接判任务失败。 |
| `data.tiktokBusinessPhoto.businessIds` | integer[] | 是 | 图片文件 ID，顺序即图序，1～15 张 |
| `data.tiktokBusinessPhoto.photoUrls` | string[] | 否 | 服务端解析出的图片地址，请求不用传 |
| `data.tiktokBusinessPhoto.photoCoverIndex` | integer | 否 | 封面图下标，从 0 开始；不传按 0 |
| `data.tiktokBusinessPhoto.privacyLevel` | string | 是 | 隐私级别，必填；必须是该账号发布设置里可选的级别 |
| `data.tiktokBusinessPhoto.autoAddMusic` | boolean | 否 | 传入 musicSoundInfo.musicSoundId 时忽略此字段，服务端固定发送 false。 |
| `data.tiktokBusinessPhoto.disableComment` | boolean | 否 | 禁用评论；账号级已禁止评论时只能为 true |
| `data.tiktokBusinessPhoto.brandOrganicToggle` | boolean | 否 | 品牌自然流量（推广自己的业务） |
| `data.tiktokBusinessPhoto.brandContentToggle` | boolean | 否 | 品牌内容（付费合作推广） |
| `data.tiktokBusinessPhoto.locationInfo` | object | 否 | locationId 与 locationName 必须同时提交；locationAddress 仅用于展示。 |
| `data.tiktokBusinessPhoto.locationInfo.locationId` | string | 否 | 地域搜索接口返回的 locationId，发布时落到 post_info.location_id |
| `data.tiktokBusinessPhoto.locationInfo.locationName` | string | 否 | 地域名称，发布时与 ID 一起传（post_info.location_name） |
| `data.tiktokBusinessPhoto.locationInfo.locationAddress` | string | 否 | 地域补充地址，仅展示与详情回填，不发给平台 |
| `data.tiktokBusinessPhoto.musicSoundInfo` | object | 否 | 选中的商用音乐，与非带货视频是同一份结构；不传（或不传 musicSoundId）表示这次不加平台音乐。图文发布没有音量参数：只把 musicSoundId 发给 TikTok（落到 post_info.music_sound_info.music_sound_id），曲名与歌手仅供展示与详情回填。 |
| `data.tiktokBusinessPhoto.musicSoundInfo.musicSoundId` | string | 否 | 热门曲目接口返回的 musicSoundId（平台的 song_clip_id），不能用 commercialMusicId；图文发布时落到 post_info.music_sound_info.music_sound_id |
| `data.tiktokBusinessPhoto.musicSoundInfo.musicSoundName` | string | 否 | 曲名快照，仅用于展示与详情回填；发布以 musicSoundId 为准 |
| `data.tiktokBusinessPhoto.musicSoundInfo.musicSoundArtist` | string | 否 | 歌手快照，仅用于展示与详情回填 |
| `timestamp` | integer | 是 | — |

### 接入说明与限制

- 查询发布任务详情，包括 businessType、businessId 和 videoUrl。

### 相关接口

- [编辑发布记录](/openapi/update-post) · [Markdown](/openapi/operations/updateCreatorPost.md)
- [带货视频立即发布](/openapi/submit-post) · [Markdown](/openapi/operations/submitCreatorPost.md)
- [查询发布记录](/openapi/post-records) · [Markdown](/openapi/operations/listCreatorPosts.md)