跳转到主要内容
GET
List messages

请求规范

  • 方法与路径: GET /apis/v1/social/inbox/conversations/{conversationId}/messages
  • 可用状态: enabled
  • 请求 URL 模板: https://api.aisa.one/apis/v1/social/inbox/conversations/{conversationId}/messages
  • conversationId: path; 必填
  • accountId: query; 必填
  • limit: query; 可选
  • cursor: query; 可选
  • sortOrder: query; 可选
  • 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.

路径参数

conversationId
string
必填

Opaque conversation identifier, accepted verbatim from the list endpoint or from the conversationId on inbox webhooks. Format not to be assumed.

查询参数

accountId
string
必填

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

Pattern: ^acc_[0-9A-Za-z]{22}$
limit
integer
默认值:100

Number of messages to return per page. Default 100, max 100.

必填范围: 1 <= x <= 100
cursor
string

Opaque pagination cursor. Pass pagination.nextCursor from a prior response verbatim: a cursor we cannot parse returns 400 rather than silently restarting from the first page.

sortOrder
enum<string>
默认值:asc

Order of returned messages. Default asc (oldest first, chat style). X, Instagram, Telegram, WhatsApp and Reddit honor this order across cursor pages. For Facebook and Bluesky, only intra-page ordering is affected. Pages always walk newest→oldest. See sortOrderApplied in the response.

可用选项:
asc,
desc

响应

Messages in conversation

lastUpdated
string<date-time>
messages
object[]
pagination
object
sortOrderApplied
enum<string>

Sort order actually applied to the returned page. May differ from the requested sortOrder for Facebook and Bluesky (always desc regardless of request).

可用选项:
asc,
desc
status
string