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 found404 Not Found
When the found item is not a file404 Not Found
When the user can not access the file404 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 found404 Not Found
When the user can not access the share404 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 found404 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 |