UPSTREAM BASELINE: nextcloud/spreed v22.0.12 (без изменений)

Источник: https://github.com/nextcloud/spreed/archive/refs/tags/v22.0.12.tar.gz
С этого коммита ветка официального Nextcloud Talk отрезана (решение владельца 2026-07-06).
Все дальнейшие изменения — только наши; версии релизов: 22.0.12-f7.N.

docs/integration.md

@@ -0,0 +1,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         |