发布评论 - 出海兽Agent · 开放平台

发布评论

curl --request POST \
  --url https://api.aichs365.com/api/v1/socialCommentCreate \
  --header 'Content-Type: application/json' \
  --header 'X-Legacy-Token: <api-key>' \
  --data '
{
  "post_id": "123456",
  "content": "很喜欢这款配色！"
}
'

const options = {
  method: 'POST',
  headers: {'X-Legacy-Token': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({post_id: '123456', content: '很喜欢这款配色！'})
};

fetch('https://api.aichs365.com/api/v1/socialCommentCreate', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.aichs365.com/api/v1/socialCommentCreate"

payload = {
    "post_id": "123456",
    "content": "很喜欢这款配色！"
}
headers = {
    "X-Legacy-Token": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "requestId": "01HZY8QK5W6N7P8R9S0T1U2V3W",
  "success": true,
  "message": "请求成功",
  "code": 200,
  "data": {
    "action_sn": "SGA20260830000002",
    "comment_id": "comment_xxx",
    "external_id": "",
    "published_at": "",
    "status": "processing"
  }
}

POST

/

api

/

v1

/

socialCommentCreate

发布评论

curl --request POST \
  --url https://api.aichs365.com/api/v1/socialCommentCreate \
  --header 'Content-Type: application/json' \
  --header 'X-Legacy-Token: <api-key>' \
  --data '
{
  "post_id": "123456",
  "content": "很喜欢这款配色！"
}
'

const options = {
  method: 'POST',
  headers: {'X-Legacy-Token': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({post_id: '123456', content: '很喜欢这款配色！'})
};

fetch('https://api.aichs365.com/api/v1/socialCommentCreate', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.aichs365.com/api/v1/socialCommentCreate"

payload = {
    "post_id": "123456",
    "content": "很喜欢这款配色！"
}
headers = {
    "X-Legacy-Token": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "requestId": "01HZY8QK5W6N7P8R9S0T1U2V3W",
  "success": true,
  "message": "请求成功",
  "code": 200,
  "data": {
    "action_sn": "SGA20260830000002",
    "comment_id": "comment_xxx",
    "external_id": "",
    "published_at": "",
    "status": "processing"
  }
}

Authorizations

X-Legacy-Token

string

header

required

调用业务接口时携带的访问 Token；请先通过获取访问 Token 接口生成。

Body

application/json

post_id

string

required

帖子ID

Maximum string length: 64

content

string

required

评论内容

Maximum string length: 5000

parent_comment_id

string | null

父评论ID

Maximum string length: 64

Response

200 - application/json

业务响应；请同时检查 success 与 code

Option 1
Option 2
Option 3

接口处理成功时返回的统一业务响应信封。

requestId

string

required

本次请求的唯一追踪 ID，用于排查问题。

success

boolean

required

业务是否处理成功；成功响应固定为 true。

message

string

required

本次业务处理结果的中文提示信息。

code

integer

required

业务状态码；应与 success 一并判断，不等同于 HTTP 状态码。

data

object

required

海外社媒操作结果，可使用动作流水号追踪处理状态。

Hide child attributes

data.action_sn

string

required

本次社媒动作的流水号，用于追踪动作执行状态。

data.status

enum<string>

required

评论当前处理状态。

Available options:

processing,

published,

failed,

deleted

data.comment_id

string

required

平台本地评论 ID，用于查询或删除评论。

data.external_id

string

required

第三方平台评论 ID；尚未发布时可能为空字符串。

data.published_at

string

required

评论实际发布时间；尚未发布时可能为空字符串。

社媒账号唯一标识，用于后续账号、帖子和评论接口。

社媒帖子唯一标识，用于后续帖子和评论接口。

data.post_id

string

帖子资源 ID；具体来源取决于当前动作。