跳转到主要内容
GET
Check account health

请求规范

  • 方法与路径: GET /apis/v1/social/accounts/{accountId}/health
  • 可用状态: enabled
  • 请求 URL 模板: https://api.aisa.one/apis/v1/social/accounts/{accountId}/health
  • accountId: path; 必填
  • Runtime 事实版本: 99acb5bddbedc8d3352e7c4fef86c3e6d8852c14772bcd18dbcf415237a642bd
完整 OpenAPI 定义 有效请求与价格声明(包括认证和引用的 schema):

费用与请求规则

当前未提供请求参考价格;请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。 公开参考值不是你的账户报价或最终扣费。对于支持 X-AISA-Cost-Mode: quote 的接口,执行前请针对完整请求获取免费报价;执行后通过响应费用元数据和 Usage Logs 核对结算费用。1 USD 等于 1,000,000 个整数 micro-USD。

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

路径参数

accountId
string
必填

One of your social accounts (acc_...).

Pattern: ^acc_[0-9A-Za-z]{22}$

响应

Account health details

accountId
string

One of your social accounts (acc_...).

Pattern: ^acc_[0-9A-Za-z]{22}$
analyticsSync
object

Absent on platforms without analytics sync. failing: several consecutive sync attempts failed. stalled: a sync was requested over 6 hours ago and never completed. never_synced: no sync has completed yet. Failing and stalled raise the account status to at least warning.

disconnectReason
string | null

Why the connection is broken or its token refresh is failing, from the most recent current cause. Null when the connection is healthy, including when the account is unhealthy for another reason (analytics, messaging restriction, missing analytics scopes, Meta phone status), or when no cause is stored.

disconnectionType
enum<string> | null

intentional: deliberately disconnected by the user or by AIsa (for example a plan downgrade), not a token failure. unintentional: token expired or revoked, or an auth failure. Null when disconnectReason is null.

可用选项:
intentional,
unintentional,
null
displayName
string
integrationLane
enum<string>

TikTok only. The TikTok integration the account is connected through: business (TikTok for Business, Accounts API) or developer (the original integration). Absent on other platforms.

可用选项:
business,
developer
issues
string[]

List of issues found

messagingRestriction
object | null

Observed from Meta's own errors on our sends, not a live probe. It lags reality by one message in each direction.

  • Facebook/Instagram: error subcodes 2534122, 1893063, 2534029. Set on the first refused send, cleared when a later send succeeds.
  • WhatsApp: Cloud API error codes 131042 (payment or eligibility issue), 131031 (Business Account locked) and 368 (policy block). Set when a send or delivery status fails with one, cleared when a later message is delivered.

After subcode 1893063 (Meta refusing the Page's messages), comment automation DMs are held and one is retried at pausedUntil: 30 minutes, doubling per refused retry up to 4 hours. Held DMs stay pending and are sent once Meta accepts again, within the 7-day private-reply window.

ownerUserId
string

User id of the profile owner, not necessarily the team member who connected the account.

permissions
object
platform
string
platformConnection
object

WhatsApp accounts only. Live probe of the Meta link behind the channel, performed at request time (the same read as GET /apis/v1/social/whatsapp/number-info).

push
enum<string>

Google and Microsoft only: state of the provider change-notification subscriptions behind message.received and calendar.event.*. pending means a granted area has no live subscription yet (retried every 6 hours), failed that renewals keep failing (reconnect the account).

可用选项:
active,
pending,
failed,
not_applicable
recommendations
string[]

Actionable recommendations to fix issues

sendCap
object

Google and Microsoft only: today's outbound mail allowance for the mailbox.

status
enum<string>

Overall health status

可用选项:
healthy,
warning,
error
tokenStatus
object
unhealthySince
string<date-time> | null

When the earliest current stored cause was recorded (the start of the outage); for an intentional disconnect, when it was disconnected. Null when the connection is healthy, including when the account is unhealthy for another reason (analytics, messaging restriction, missing analytics scopes, Meta phone status), or when unknown.

username
string