发布INSTAGRAM帖子
curl --request POST \
--url https://api.aichs365.com/api/v1/socialPostCreateInstagram \
--header 'Content-Type: application/json' \
--header 'X-Legacy-Token: <api-key>' \
--data '
{
"social_account_id": "12345",
"title": "秋季新品发布",
"type": "POST",
"text": "秋季新品现已上线。",
"media_urls": [
"https://static.example.com/products/autumn.jpg"
],
"post_date": "2026-09-01T10:00:00+08:00",
"exclusive": {
"alt_text": "模特展示秋季新品外套",
"share_to_feed": true,
"auto_fit_image": true
}
}
'const options = {
method: 'POST',
headers: {'X-Legacy-Token': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
social_account_id: '12345',
title: '秋季新品发布',
type: 'POST',
text: '秋季新品现已上线。',
media_urls: ['https://static.example.com/products/autumn.jpg'],
post_date: '2026-09-01T10:00:00+08:00',
exclusive: {alt_text: '模特展示秋季新品外套', share_to_feed: true, auto_fit_image: true}
})
};
fetch('https://api.aichs365.com/api/v1/socialPostCreateInstagram', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.aichs365.com/api/v1/socialPostCreateInstagram"
payload = {
"social_account_id": "12345",
"title": "秋季新品发布",
"type": "POST",
"text": "秋季新品现已上线。",
"media_urls": ["https://static.example.com/products/autumn.jpg"],
"post_date": "2026-09-01T10:00:00+08:00",
"exclusive": {
"alt_text": "模特展示秋季新品外套",
"share_to_feed": True,
"auto_fit_image": True
}
}
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": "SGA20260830000001",
"social_post_id": 123456,
"status": "processing",
"platform": "INSTAGRAM"
}
}社媒帖子
发布INSTAGRAM帖子
发布INSTAGRAM帖子接口。
接口状态:可用。接口当前可正常接入和调用。
POST
/
api
/
v1
/
socialPostCreateInstagram
发布INSTAGRAM帖子
curl --request POST \
--url https://api.aichs365.com/api/v1/socialPostCreateInstagram \
--header 'Content-Type: application/json' \
--header 'X-Legacy-Token: <api-key>' \
--data '
{
"social_account_id": "12345",
"title": "秋季新品发布",
"type": "POST",
"text": "秋季新品现已上线。",
"media_urls": [
"https://static.example.com/products/autumn.jpg"
],
"post_date": "2026-09-01T10:00:00+08:00",
"exclusive": {
"alt_text": "模特展示秋季新品外套",
"share_to_feed": true,
"auto_fit_image": true
}
}
'const options = {
method: 'POST',
headers: {'X-Legacy-Token': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
social_account_id: '12345',
title: '秋季新品发布',
type: 'POST',
text: '秋季新品现已上线。',
media_urls: ['https://static.example.com/products/autumn.jpg'],
post_date: '2026-09-01T10:00:00+08:00',
exclusive: {alt_text: '模特展示秋季新品外套', share_to_feed: true, auto_fit_image: true}
})
};
fetch('https://api.aichs365.com/api/v1/socialPostCreateInstagram', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.aichs365.com/api/v1/socialPostCreateInstagram"
payload = {
"social_account_id": "12345",
"title": "秋季新品发布",
"type": "POST",
"text": "秋季新品现已上线。",
"media_urls": ["https://static.example.com/products/autumn.jpg"],
"post_date": "2026-09-01T10:00:00+08:00",
"exclusive": {
"alt_text": "模特展示秋季新品外套",
"share_to_feed": True,
"auto_fit_image": True
}
}
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": "SGA20260830000001",
"social_post_id": 123456,
"status": "processing",
"platform": "INSTAGRAM"
}
}Authorizations
调用业务接口时携带的访问 Token;请先通过获取访问 Token 接口生成。
Body
application/json
社媒账号ID
Maximum string length:
128发布时间
Maximum string length:
64社媒帖子标题
Maximum string length:
255发布内容类型
Maximum string length:
64社媒帖子正文
素材URL列表
待发布的单个素材URL
Maximum string length:
1000视频封面图地址
Maximum string length:
1000当前发布平台的专属选项
Hide child attributes
Hide child attributes
Instagram 无障碍替代文本
视频封面在视频中的毫秒偏移量
Required range:
x >= 0是否同步展示到 Instagram 主页动态
Instagram 协作者用户名列表
单个 Instagram 协作者用户名
Maximum string length:
128是否自动适配 Instagram 图片尺寸
是否自动裁剪 Instagram 图片
Instagram 地点ID
Maximum string length:
128Instagram 试发设置列表
单项 Instagram 试发设置
Response
200 - application/json
业务响应;请同时检查 success 与 code
- Option 1
- Option 2
- Option 3
接口处理成功时返回的统一业务响应信封。
本次请求的唯一追踪 ID,用于排查问题。
业务是否处理成功;成功响应固定为 true。
本次业务处理结果的中文提示信息。
业务状态码;应与 success 一并判断,不等同于 HTTP 状态码。
海外社媒操作结果,可使用动作流水号追踪处理状态。
Hide child attributes
Hide child attributes
本次社媒动作的流水号,用于追踪动作执行状态。
帖子当前发布状态。
Available options:
queued, submitting, accepted, processing, retrying, published, failed, deleted 平台本地帖子 ID;后续帖子与评论接口应将其作为 post_id。
本次发帖的目标平台,固定为 INSTAGRAM。
Allowed value:
"INSTAGRAM"社媒账号唯一标识,用于后续账号、帖子和评论接口。
帖子资源 ID;具体来源取决于当前动作。
评论资源 ID。