diff options
Diffstat (limited to 'support/doc/api/openapi.yaml')
-rw-r--r-- | support/doc/api/openapi.yaml | 22 |
1 files changed, 11 insertions, 11 deletions
diff --git a/support/doc/api/openapi.yaml b/support/doc/api/openapi.yaml index 79417e34f..568a0ba0d 100644 --- a/support/doc/api/openapi.yaml +++ b/support/doc/api/openapi.yaml | |||
@@ -21,7 +21,7 @@ info: | |||
21 | - [Go](https://framagit.org/framasoft/peertube/clients/go) | 21 | - [Go](https://framagit.org/framasoft/peertube/clients/go) |
22 | - [Kotlin](https://framagit.org/framasoft/peertube/clients/kotlin) | 22 | - [Kotlin](https://framagit.org/framasoft/peertube/clients/kotlin) |
23 | 23 | ||
24 | See the [REST API quick start](https://docs.joinpeertube.org/api-rest-getting-started) for a few | 24 | See the [REST API quick start](https://docs.joinpeertube.org/api/rest-getting-started) for a few |
25 | examples of using the PeerTube API. | 25 | examples of using the PeerTube API. |
26 | 26 | ||
27 | # Authentication | 27 | # Authentication |
@@ -33,7 +33,7 @@ info: | |||
33 | ## Roles | 33 | ## Roles |
34 | 34 | ||
35 | Accounts are given permissions based on their role. There are three roles on | 35 | Accounts are given permissions based on their role. There are three roles on |
36 | PeerTube: Administrator, Moderator, and User. See the [roles guide](https://docs.joinpeertube.org/admin-managing-users?id=roles) for a detail of their permissions. | 36 | PeerTube: Administrator, Moderator, and User. See the [roles guide](https://docs.joinpeertube.org/admin/managing-users?id=roles) for a detail of their permissions. |
37 | 37 | ||
38 | # Errors | 38 | # Errors |
39 | 39 | ||
@@ -46,7 +46,7 @@ info: | |||
46 | 46 | ||
47 | { | 47 | { |
48 | "detail": "Video not found", | 48 | "detail": "Video not found", |
49 | "docs": "https://docs.joinpeertube.org/api-rest-reference.html#operation/getVideo", | 49 | "docs": "https://docs.joinpeertube.org/api/rest-reference.html#operation/getVideo", |
50 | "status": 404, | 50 | "status": 404, |
51 | "title": "Not Found", | 51 | "title": "Not Found", |
52 | "type": "about:blank" | 52 | "type": "about:blank" |
@@ -63,10 +63,10 @@ info: | |||
63 | 63 | ||
64 | { | 64 | { |
65 | "detail": "Cannot get this video regarding follow constraints", | 65 | "detail": "Cannot get this video regarding follow constraints", |
66 | "docs": "https://docs.joinpeertube.org/api-rest-reference.html#operation/getVideo", | 66 | "docs": "https://docs.joinpeertube.org/api/rest-reference.html#operation/getVideo", |
67 | "status": 403, | 67 | "status": 403, |
68 | "title": "Forbidden", | 68 | "title": "Forbidden", |
69 | "type": "https://docs.joinpeertube.org/api-rest-reference.html#section/Errors/does_not_respect_follow_constraints" | 69 | "type": "https://docs.joinpeertube.org/api/rest-reference.html#section/Errors/does_not_respect_follow_constraints" |
70 | } | 70 | } |
71 | ``` | 71 | ``` |
72 | 72 | ||
@@ -84,7 +84,7 @@ info: | |||
84 | 84 | ||
85 | { | 85 | { |
86 | "detail": "Incorrect request parameters: id", | 86 | "detail": "Incorrect request parameters: id", |
87 | "docs": "https://docs.joinpeertube.org/api-rest-reference.html#operation/getVideo", | 87 | "docs": "https://docs.joinpeertube.org/api/rest-reference.html#operation/getVideo", |
88 | "instance": "/api/v1/videos/9c9de5e8-0a1e-484a-b099-e80766180", | 88 | "instance": "/api/v1/videos/9c9de5e8-0a1e-484a-b099-e80766180", |
89 | "invalid-params": { | 89 | "invalid-params": { |
90 | "id": { | 90 | "id": { |
@@ -149,7 +149,7 @@ info: | |||
149 | 149 | ||
150 | In addition, all routes serving ActivityPub are CORS-enabled for all origins. | 150 | In addition, all routes serving ActivityPub are CORS-enabled for all origins. |
151 | externalDocs: | 151 | externalDocs: |
152 | url: https://docs.joinpeertube.org/api-rest-reference.html | 152 | url: https://docs.joinpeertube.org/api/rest-reference.html |
153 | tags: | 153 | tags: |
154 | - name: Register | 154 | - name: Register |
155 | description: | | 155 | description: | |
@@ -204,7 +204,7 @@ tags: | |||
204 | information across its social graph by posting activities to actors' inbox | 204 | information across its social graph by posting activities to actors' inbox |
205 | endpoints. | 205 | endpoints. |
206 | externalDocs: | 206 | externalDocs: |
207 | url: https://docs.joinpeertube.org/admin-following-instances?id=instances-follows | 207 | url: https://docs.joinpeertube.org/admin/following-instances?id=instances-follows |
208 | - name: Instance Redundancy | 208 | - name: Instance Redundancy |
209 | description: > | 209 | description: > |
210 | Redundancy is part of the inter-server solidarity that PeerTube fosters. | 210 | Redundancy is part of the inter-server solidarity that PeerTube fosters. |
@@ -212,12 +212,12 @@ tags: | |||
212 | to the policy of video selection of your choice. Note that you have a similar functionality | 212 | to the policy of video selection of your choice. Note that you have a similar functionality |
213 | to mirror individual videos, see [video mirroring](#tag/Video-Mirroring). | 213 | to mirror individual videos, see [video mirroring](#tag/Video-Mirroring). |
214 | externalDocs: | 214 | externalDocs: |
215 | url: https://docs.joinpeertube.org/admin-following-instances?id=instances-redundancy | 215 | url: https://docs.joinpeertube.org/admin/following-instances?id=instances-redundancy |
216 | - name: Plugins | 216 | - name: Plugins |
217 | description: > | 217 | description: > |
218 | Managing plugins installed from a local path or from NPM, or search for new ones. | 218 | Managing plugins installed from a local path or from NPM, or search for new ones. |
219 | externalDocs: | 219 | externalDocs: |
220 | url: https://docs.joinpeertube.org/api-plugins | 220 | url: https://docs.joinpeertube.org/api/plugins |
221 | - name: Abuses | 221 | - name: Abuses |
222 | description: | | 222 | description: | |
223 | Abuses deal with reports of local or remote videos/comments/accounts alike. | 223 | Abuses deal with reports of local or remote videos/comments/accounts alike. |
@@ -5933,7 +5933,7 @@ components: | |||
5933 | Note that the __access token is valid for 1 day__ and is given | 5933 | Note that the __access token is valid for 1 day__ and is given |
5934 | along with a __refresh token valid for 2 weeks__. | 5934 | along with a __refresh token valid for 2 weeks__. |
5935 | 5935 | ||
5936 | [Generate]: https://docs.joinpeertube.org/api-rest-getting-started | 5936 | [Generate]: https://docs.joinpeertube.org/api/rest-getting-started |
5937 | type: oauth2 | 5937 | type: oauth2 |
5938 | flows: | 5938 | flows: |
5939 | password: | 5939 | password: |