Unified API

​

能做什么

• 一种请求格式。 帖子、广告系列、商品在每个平台上字段相同。要同时发到 LinkedIn 和 X，一个请求带上两个账户即可。
• 托管授权。 各平台的授权页面由 AIsa 托管。你的应用不保存平台密码或 token。
• 可读可写。 AIsa Social 可以在 TikTok、Instagram、X、YouTube、Facebook、LinkedIn、Pinterest、Threads 和 Reddit 上发布、排期、编辑和删除帖子，回复评论和私信。AIsa Ads 可以创建和修改广告系列、广告组、广告、素材、受众和线索表单。
• Webhook 推送事件。 AIsa 把帖子和账户事件推送到你的 HTTPS 地址，不用轮询。
• 每个值都带来源。 AIsa commerce 的每个值都标明来源。采集时间、许可、出处和值类型放在 meta.sources 里。

​

AIsa 在你的应用和平台之间

1. AIsa API 有响应。 请求到达 AIsa，并通过鉴权。
2. 平台连接可用。 已连接的账户仍有授权，平台也接受这个操作。

​

平台连接为什么会失效

• 用户撤销了授权、改了密码，或授权已过期。
• 平台改了鉴权方式、接口或规则。
• 平台故障，或对账户限流、限制功能。
• 该账户不允许这个操作，例如 TikTok 帖子缺少必填的隐私设置。

​

AIsa 提供什么

• 账户事件：account.connected、account.disconnected 和 account.needs_reconnect。
• 健康检查：社媒账户用 GET /apis/v1/social/accounts/health。Meta 广告账户用 GET /apis/v1/ads/accounts/health，它检查账户状态、付款方式、花费上限、主页、Instagram 账户、线索广告条款、最新的像素事件和关联的 WhatsApp 号码，每个问题都附修复链接。
• 按平台给出结果：发到多个平台的帖子可能以 partial 结束。post.platform.published 和 post.platform.failed 事件告诉你每个平台的结果。
• 重连不丢历史：带上 reconnectAccountId 再走一次连接流程，账户保留原 ID 和历史。

​

你的应用要做什么

• 订阅 account.* 事件，把账户状态展示给用户。
• 账户需要重连时，暂停它的任务。只在平台要求重新登录时才提示用户重连。
• 处理 partial 帖子：只重试或上报失败的平台。
• 投放 Meta 广告前，先检查广告账户健康状态。
• 账户重连后，补读断开期间可能漏掉的数据。

​

核心概念

​

接入流程

curl "https://api.aisa.one/apis/v1/social/connect/linkedin" \
  -H "Authorization: Bearer $AISA_API_KEY"

curl -X POST "https://api.aisa.one/apis/v1/social/posts" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Our spring collection is live.",
    "platforms": [
      {"platform": "linkedin", "accountId": "acc_7Hq2Lm9Xc4Rt8Vw1Nb6Ks3"},
      {"platform": "twitter", "accountId": "acc_2Bn8Wq5Td1Yh7Kc3Mz9Lp4"}
    ],
    "publishNow": true
  }'

curl "https://api.aisa.one/apis/v1/commerce/amazon/listings?country=US&q=standing%20desk" \
  -H "Authorization: Bearer $AISA_API_KEY"

​

Webhook 事件

​

AIsa commerce 的数据来源

• 默认（provenance=compact）每个值包含 value 和 source。采集时间、许可、出处和值类型统一放在 meta.sources。
• provenance=full 返回每个值的完整来源信息，包括精度和置信度。
• 请求了但没有来源提供的字段列在 missing 里，并附原因。
• fields 只裁剪输出，不减少上游调用，也不减少费用。

​

计费

​

下一步