v1
API 文档
生产地址是 https://open.xiaofen.ai/v1。所有业务接口使用 Bearer Token，写操作建议携带 Idempotency-Key。
鉴权
Authorization: Bearer xfo_live_xxx
Content-Type: application/json
Idempotency-Key: customer-message-0001接口分组
健康与身份
GET /health
GET /me
微信号
GET /accounts
POST /accounts
POST /accounts/:id/login_qrcode
POST /accounts/:id/sync_contacts
联系人与消息
GET /contacts
PATCH /contacts/:id
GET /messages
POST /messages
群与朋友圈
GET /groups
GET /groups/:id/members
GET /moments
POST /moments
异步与回调
GET /operations/:id
GET /webhooks
POST /webhooks
GET /requests
Raw API
GET /raw/endpoints
POST /raw/invoke
通用错误
invalid_token
Token 不存在、过期或已吊销。
insufficient_scope
应用没有接口所需权限。
rate_limited
触发应用级分钟限流。
wechat_account_offline
微信号不在线，需要恢复后重试。
idempotency_conflict
同一幂等键被用于不同请求体。
operation_failed
异步操作失败，查询 operation 详情。