点赞/取消点赞自有视频的评论

您可以使用本接口点赞或取消点赞自有TikTok 账号所发布原生视频的某条现有评论。

v1.2与v1.3版本对比

以下表格概括了 v1.2与v1.3接口的变化。

|变化内容{30%}|v1.2{35%}|v1.3{35%}|
|---|---|---|
|接口路径| /v1.2/business/comments/like/| /v1.3/business/comment/like/|

请求

地址 https://business-api.tiktok.com/open_api/v1.3/business/comment/like/

方法 POST

Header

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|Access-Token {必填}|string|经 TikTok 创作者授权的访问令牌。<br>若想获取访问令牌，需使用[/tt_user/oauth2/token/](https://business-api.tiktok.com/portal/docs?id=1738084387220481#item-link-获取访问令牌)接口。|
|Content-Type {必填}|string|请求信息类型。<br>允许格式：`application/json`。|

参数

请将下列参数作为查询字符串进行传递。

|字段{25%}|类型{10%}|参数位置{10%}|描述{55%}|
|--- |--- |--- |--- |
|business_id {必填}| string |Body| TikTok 账户的应用唯一识别ID。<br>您需将[/tt_user/oauth2/token/](https://business-api.tiktok.com/portal/docs?id=1738084387220481#item-link-获取访问令牌)接口返回的`open_id`字段值传给本字段。|
|comment_id {必填}|string| Body|自有 TikTok 视频评论的唯一标识符，点赞或取消点赞的对象。可通过[/business/comment/list/](https://ads.tiktok.com/marketing_api/docs?id=1760232109619202) 接口的<code>comment_id</code>字段获取所列的各个评论的 ID。|
|action {必填}|string| Body|要对评论进行的特定操作 - 点赞或取消点赞。<br><br><strong>枚举值</strong>：<ul><li>`LIKE`</li><li>`UNLIKE`</li></ul><br><strong>示例</strong>：`LIKE`|

示例

(code curl http)
curl -L -X POST 'https://business-api.tiktok.com/open_api/v1.3/business/comment/like/' \
-H 'Content-Type: application/json' \
-H 'Access-Token: 1234a16d2e08c3f17d1984a1be07d00406p3LIAF7vEpxliox8GRpCINv70x' \
--data-raw '{
  "business_id" : "b3d2f73d-4b8c-47fb-85c3-cd571287754b",
  "comment_id" : "b3d2f73d-4b8c-47fb-85c3-cd571287754b",
  "action": "like"
}'
(/code)

返回

Header

这些header很重要，可用于记录问题报告和故障排查信息。下表列出了部分返回的header。

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
| Date | string | 收到返回时的(GMT)日期和时间 。 <br><strong>示例</strong>：Fri, 13 Aug 2021 08:04:42 GMT |
| X-Tt-Logid | string | 接口请求的唯一标识符。|

Body

|字段{30%}|类型{15%}|描述{55%}|
|-|-|-|
| request_id | string | 接口请求的唯一标识符。<br><br>请记录此字段，用于所有接口请求。此字段对于问题报告和故障排查十分重要。 |
| code | integer | 返回码。完整返回码列表及描述，可查看[附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|message| string | 返回信息。更多信息可查看[附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。 |
| data | object | 返回数据。<br>操作成功时返回空对象：`{}`。 |

示例

(code Success-Response http)
HTTPS/1.1 200 OK
{
  "code": 0,
  "message": "Ok",
  "request_id": "20210817034316010245031056097316BA",
  "data": {}
}
(/code)