要通过 Glip API 共享附件,请使用现有附件创建新帖子。
创建帖子 API
Create Post API 采用一个attachments
引用现有附件的可选数组。id
和type
属性都是必需的。这两个属性都存在于 post API 响应中。
POST /restapi/v1.0/glip/chats/{chatId}/posts
{
"text": "Please check out this file",
"attachments": [
{
"id":"123456789",
"type":"File"
}
]
}
示例获取帖子 API
以下是一个帖子示例,显示了带有id
和type
属性的附件数组。附件 URL 是一个 AWS Presigned Object URL,如下所示。
GET /restapi/v1.0/glip/chats/{chatId}/posts
{
"records": [
{
"id": "11111111",
"creatorId": "22222222",
"creationTime": "2019-08-26T21:41:56.648Z",
"lastModifiedTime": "2019-08-26T21:41:56.648Z",
"type": "TextMessage",
"chatId": "33333333",
"mentions": [],
"attachments": [
{
"id": "123456789",
"name": "sharedfile.png",
"contentUri": "https://glip-vault-1.s3.amazonaws.com/web/customer_files/44444444/testimage.png?Expires=55555555&AWSAccessKeyId=myAccessKeyId&Signature=myAWSPresignedObjectUrlSignature",
"type": "File"
}
],
"text": "Check this out!"
}
},
"navigation": {}
}
共享权限
附件只能由原始发布者共享或在同一聊天中共享。如果不同的用户想要在不同的团队中共享附件,则需要下载并重新发布文件,生成新的附件 ID。
如果不同的用户尝试在不同的聊天中共享附件,403 Forbidden
则会遇到错误:
403 Forbidden
{
"errors": [
{
"errorCode": "PST-011",
"message": "The requester must be attachment creator or attachment must belong to the requested chat."
}
]
}