OpenMax
免费试用

Apps API · Conversation Sync

Conversation Sync: 3 个接口

← 全部分组

POST /api/v1/sync

Sync conversations

权限(scope): messages:sync:read · 调用方式: appToken · operationId: sync-conversations

Required app scope: messages:sync:read.

Returns sync events. next_cursor is decimal-encoded as a string inside DataResponse, not a CursorListResponse. next_cursor is a monotonically increasing positive integer: send it back unchanged as since_seq, use it only for ordering comparisons, and never compute it from event seq values; it can be greater than the seq of the last event on the page. Response wrapped in standard envelope.

请求体

application/json · SyncCommRequestBody

字段 类型 必填 说明
device_id string 是 Device ID
limit integer (int32) Maximum events to return
since_seq integer (int64) 是 Last seen sync sequence

回包

POST /api/v1/sync/ack

Acknowledge conversation sync

权限(scope): messages:read_state:write · 调用方式: appToken · operationId: ack-sync-conversations

Required app scope: messages:read_state:write.

Advances the per-device sync cursor after the client has processed a sync batch.

请求体

application/json · AckSyncCommRequestBody

字段 类型 必填 说明
app_version string Client app version
device_id string 是 Device ID
platform string Client platform
seq integer (int64) 是 Highest processed sync sequence

回包

GET /api/v1/sync/status

Get sync inbox status

权限(scope): messages:read_state:read · 调用方式: appToken · operationId: get-sync-inbox-status

Required app scope: messages:read_state:read.

Returns the caller's inbox watermark: the highest available sync sequence and the highest sequence already delivered. Org/user identity is derived from the propagated principal, not request fields.

回包