blob: a3416fd65989b39e798fde0228016b65aee53434 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
|
# 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 |
|
