diff options
| author | Joas Schilling <213943+nickvergessen@users.noreply.github.com> | 2022-03-31 22:52:49 +0300 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2022-03-31 22:52:49 +0300 |
| commit | f4c8cb5d4a4b742a35b2fd8f432629872a932aa1 (patch) | |
| tree | 0cb13eac17f2b22e96712b6dff1f117e5ec9e232 /docs/chat.md | |
| parent | d7ac2a1f64fc934e53c930cd8051be2fdfa64a2b (diff) | |
| parent | 3099ca9fa23b971ebe51f069f20aa4b5e22e6f80 (diff) | |
Merge pull request #7077 from nextcloud/feature/noid/talk-attachments-table
Improve API for media tab to be able to filter results
Diffstat (limited to 'docs/chat.md')
| -rw-r--r-- | docs/chat.md | 29 |
1 files changed, 26 insertions, 3 deletions
diff --git a/docs/chat.md b/docs/chat.md index 4dfe86788..43ee4b4e3 100644 --- a/docs/chat.md +++ b/docs/chat.md @@ -154,7 +154,29 @@ See [OCP\RichObjectStrings\Definitions](https://github.com/nextcloud/server/blob * Response: [See official OCS Share API docs](https://docs.nextcloud.com/server/latest/developer_manual/client_apis/OCS/ocs-share-api.html?highlight=sharing#create-a-new-share) -## List media shared in a chat +## List overview of items shared into a chat + +* Required capability: `rich-object-list-media` +* Method: `GET` +* Endpoint: `/chat/{token}/share/overview` +* Data: + + field | type | Description + ---|---|--- + `limit` | int | Number of chat messages with shares you want to get + +* Response: + - Note: if a file was shared multiple times it will be returned multiple times + - Status code: + + `200 OK` + + `404 Not Found` When the conversation could not be found for the participant + + `412 Precondition Failed` When the lobby is active and the user is not a moderator + + - Data: + + An array per item type + - Array of messages as defined in [Receive chat messages of a conversation](#receive-chat-messages-of-a-conversation) + +## List items of type shared in a chat * Required capability: `rich-object-list-media` * Method: `GET` @@ -163,8 +185,9 @@ See [OCP\RichObjectStrings\Definitions](https://github.com/nextcloud/server/blob field | type | Description ---|---|--- - `lastKnownMessageId` | int | Serves as an offset for the query. The lastKnownMessageId for the next page is available in the `X-Chat-Last-Given` header. - `limit` | int | Number of chat messages with shares you want to get + `objectType` | string | One of the [Constants - Shared item types](constants.md#shared-item-types) + `lastKnownMessageId` | int | Serves as an offset for the query. The lastKnownMessageId for the next page is available in the `X-Chat-Last-Given` header. + `limit` | int | Number of chat messages with shares you want to get * Response: - Note: if a file was shared multiple times it will be returned multiple times |