在RingCentral Glip中是否有用于共享附件的API？

Question

我想构建一个可以监视一个Glip团队的帖子（包括屏幕截图），然后将该消息发布到另一个Glip团队的应用。 我可以阅读帖子，下载附件并重新发布/上传，但是有一种方法可以简单地共享现有附件而无需重新发布。 可以在应用程序用户界面中完成此操作，但在Glip API参考中没有看到共享API。

这是Glip API参考，其中包括用于创建，阅读，更新和删除帖子但不共享的端点：

• https://developers.ringcentral.com/api-reference/glip

共享的图标在下面的应用程序屏幕截图的左侧第6位。

是否可以在Glip中执行此操作而无需下载并重新上传文件？

Answer 1

要通过Glip API共享附件，请使用现有附件创建新帖子。

创建帖子API

Create Post API采用可选的attachments数组，该数组引用现有附件。 id和type属性都是必需的。 这两个属性都存在于API后响应中。

POST /restapi/v1.0/glip/chats/{chatId}/posts

{
    "text": "Please check out this file",
    "attachments": [
        {
            "id":"123456789",
            "type":"File"
        }
    ]
}

• 参考： https : //developers.ringcentral.com/api-reference/Posts/createGlipPost

示例获取帖子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": {}
}

• 参考： https : //developers.ringcentral.com/api-reference/Posts/readGlipPosts

共享权限

附件只能由原始发布者或在同一聊天中共享。 如果其他用户希望在其他团队中共享附件，则必须下载并重新发布文件，以生成新的附件ID。

如果其他用户尝试在其他聊天中共享附件，则会遇到403 Forbidden错误：

403 Forbidden

{
    "errors": [
        {
            "errorCode": "PST-011",
            "message": "The requester must be attachment creator or attachment must belong to the requested chat."
        }
    ]
}