glb_adm
01acfa3b40
Type checking / changes (push) Has been cancelled
Type checking / test (push) Has been cancelled
Type checking / typescript-summary (push) Has been cancelled
Node tests / changes (push) Has been cancelled
Node tests / test (push) Has been cancelled
Node tests / test-summary (push) Has been cancelled
Источник: https://github.com/nextcloud/spreed/archive/refs/tags/v22.0.12.tar.gz С этого коммита ветка официального Nextcloud Talk отрезана (решение владельца 2026-07-06). Все дальнейшие изменения — только наши; версии релизов: 22.0.12-f7.N.
75 lines
2.6 KiB
Markdown
75 lines
2.6 KiB
Markdown
# Integration
|
|
|
|
Base endpoint is: `/ocs/v2.php/apps/spreed/api/v1`: since Nextcloud 15
|
|
|
|
## Get conversation for an internal file
|
|
|
|
* Method: `GET`
|
|
* Endpoint: `/file/{fileId}`
|
|
* Data:
|
|
|
|
| field | type | Description |
|
|
|----------|------|----------------------------------------------------|
|
|
| `fileId` | int | File id for which the conversation should be given |
|
|
|
|
* Response:
|
|
- Status code:
|
|
+ `200 OK`
|
|
+ `404 Not Found` When the item was not found
|
|
+ `404 Not Found` When the found item is not a file
|
|
+ `404 Not Found` When the user can not access the file
|
|
+ `404 Not Found` When the file is not shared with anyone
|
|
|
|
- Data:
|
|
|
|
| field | type | Description |
|
|
|---------|--------|---------------------------------------------|
|
|
| `token` | string | The token of the conversation for this file |
|
|
|
|
## Get conversation for a public share
|
|
|
|
* Method: `GET`
|
|
* Endpoint: `/publicshare/{shareToken}`
|
|
* Data:
|
|
|
|
| field | type | Description |
|
|
|--------------|--------|--------------------------------------------------------|
|
|
| `shareToken` | string | Share token for which the conversation should be given |
|
|
|
|
* Response:
|
|
- Status code:
|
|
+ `200 OK`
|
|
+ `404 Not Found` When the share was not found
|
|
+ `404 Not Found` When the user can not access the share
|
|
+ `404 Not Found` When the shared item is not a file
|
|
|
|
- Data:
|
|
|
|
| field | type | Description |
|
|
|---------|--------|---------------------------------------------|
|
|
| `token` | string | The token of the conversation for this file |
|
|
|
|
## Create a conversation to request the password for a public share
|
|
|
|
* Method: `POST`
|
|
* Endpoint: `/publicshareauth`
|
|
* Data:
|
|
|
|
| field | type | Description |
|
|
|--------------|--------|--------------------------------------------------------|
|
|
| `shareToken` | string | Share token for which the conversation should be given |
|
|
|
|
* Response:
|
|
- Status code:
|
|
+ `200 OK`
|
|
+ `404 Not Found` When the share was not found
|
|
+ `404 Not Found` When "Request password via Talk" is not active for the share
|
|
|
|
- Data:
|
|
|
|
| field | type | Description |
|
|
|---------------|--------|---------------------------------------------|
|
|
| `token` | string | The token of the conversation for this file |
|
|
| `name` | string | A technical name for the conversation |
|
|
| `displayName` | string | The visual name of the conversation |
|