Apps API · Conversation Uploads
Conversation Uploads: 2 个接口
POST /api/v1/conversations/uploads/finalize
Finalize conversation upload
权限(scope): messages:message:send · 调用方式: appToken · operationId: finalize-conversation-upload
Required app scope: messages:message:send.
Finalizes a media upload. Response wrapped in standard envelope.
请求体
application/json · FinalizeCommUploadRequestBody
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
upload_token |
string | 是 | Upload token |
回包
200OK —application/json·DataResponseFinalizeUploadResultBodydefaultError —application/problem+json·D8Error
POST /api/v1/conversations/{conversation_id}/uploads/prepare
Prepare conversation upload
权限(scope): messages:message:send · 调用方式: appToken · operationId: prepare-conversation-upload
Required app scope: messages:message:send.
Prepares a media upload. expires_at is returned as a string. Response wrapped in standard envelope.
参数
| 名字 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
conversation_id |
path | string (uuid) | 是 | Conversation UUID |
请求体
application/json · PrepareCommUploadRequestBody
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
content_type |
string | 是 | Content type |
filename |
string | 是 | File name |
size_bytes |
integer (int64) | 是 | File size in bytes |
回包
200OK —application/json·DataResponsePrepareUploadResultBodydefaultError —application/problem+json·D8Error
