Commit Graph

327 Commits

Author SHA1 Message Date
Chocobozzz 63748ad005
Add files section to streaming playlists openapi doc 2020-05-13 11:57:38 +02:00
Chocobozzz 6676056a31
Add max count information in api doc 2020-05-13 11:31:42 +02:00
Chocobozzz 1151f5210c
Add ability to update embed captions 2020-05-06 11:54:33 +02:00
Chocobozzz 2dd530129f
Fix openapi search endpoint 2020-04-22 08:40:24 +02:00
Chocobozzz b9e924a8d6
Fix playlist element param in api doc 2020-04-21 16:47:39 +02:00
Chocobozzz 0590bb4692
Add playlist exist api doc 2020-04-21 16:41:31 +02:00
Chocobozzz 59c794a5dc
Add videos list filters param in api doc 2020-04-21 16:03:51 +02:00
Chocobozzz 98639806c0
Fix comment body api doc 2020-04-21 15:28:17 +02:00
Chocobozzz 50e16ccf61
Improve abuse api doc 2020-04-21 15:24:19 +02:00
Chocobozzz c18431505f
Add API doc for playlists 2020-04-21 15:04:39 +02:00
Chocobozzz b029d58a27
Openapi consistency 2020-04-21 12:19:00 +02:00
Chocobozzz 624a022157
Add pt version in embed options 2020-04-14 09:02:44 +02:00
Chocobozzz 6ccdf9d53e
Add duration in embed api playbackStatusUpdate 2020-04-08 14:52:28 +02:00
Chocobozzz afd1a6ed49
Update embed api doc 2020-04-08 14:44:25 +02:00
Chocobozzz 96aae68cc4
Add "ended" embed API event 2020-04-08 14:39:31 +02:00
David Dobryakov b2b0ce8ac8 Fix embed api docs
player.stop() -> player.pause()
2020-03-25 13:52:35 +01:00
Chocobozzz 5ab994fe8e
Fix embed api documentation 2020-03-20 15:04:02 +01:00
Chocobozzz 9a207a71b2
Add missing api=1 info in embed quickstart 2020-02-28 14:01:17 +01:00
Chocobozzz 93468b0889
Bumped to version v2.1.1 2020-02-28 13:45:42 +01:00
Rigel Kent f30736c891
Minor update to the OpenAPI: instance config recent additions 2020-02-21 21:25:55 +01:00
John Livingston 45f1bd72a0
Creating a user with an empty password will send an email to let him set his password (#2479)
* Creating a user with an empty password will send an email to let him set his password

* Consideration of Chocobozzz's comments

* Tips for optional password

* API documentation

* Fix circular imports

* Tests
2020-02-17 10:16:52 +01:00
Rigel Kent c9925e2d13
Add libraries section to the REST Quickstart
Document the new OpenAPI clients in the REST Quickstart, listing supported languages and their repositories.
2020-02-17 09:33:45 +01:00
Average Dude 002df3813d OpenAPI clients generation 2020-02-14 14:14:14 +01:00
Chocobozzz 7024e9120b
Merge branch 'release/2.1.0' into develop 2020-02-11 09:44:59 +01:00
Chocobozzz 6b7e246ac7
Bumped to version v2.1.0 2020-02-11 08:35:39 +01:00
Rigel Kent 06bcfbd9f7 Downsample to the closest divisor standard framerate 2020-01-29 13:42:15 +01:00
Chocobozzz 5aafc6f373
Bumped to version v2.1.0-rc.1 2020-01-27 08:44:04 +01:00
Rigel Kent 205ed5b7dc
Add video caption upload documentation and improve error message
fixes #2038
2020-01-09 14:11:39 +01:00
Rigel Kent 5b0413ddaa
Add author indicator to the comment replies loader 2019-12-28 11:48:53 +01:00
Rigel Kent 71810d0bcb
Update OpenAPI documentation to include basic playlists and new comment sorting 2019-12-27 17:52:53 +01:00
Chocobozzz 03d641a0d7
Add embed api build 2019-12-18 10:14:25 +01:00
Chocobozzz 478924a044
Add package.json for embed api 2019-12-18 10:14:24 +01:00
Matthieu De Beule f6d51cfe2a Fix Ruby and Python REST API examples
The previous examples where wrong, since they used a POST request.
I used the requests library for Python, since that is what most people
would want to use.
I removed the http.verify_mode in the Ruby example since I don't think
it is good practice to tell people to not verify HTTPS requests
2019-11-12 14:46:43 +01:00
Chocobozzz e8e09e27ff
Bumped to version v2.0.0 2019-11-12 08:04:15 +01:00
Chocobozzz 16fd7c4b86
Bumped to version v2.0.0-rc.1 2019-10-29 08:26:43 +01:00
Chocobozzz 747b17c7c1
Fix openapi 2019-10-29 08:26:24 +01:00
Frank Sträter a1b572ea76 Remove feeds from API documentation 2019-09-18 15:24:33 +02:00
Chocobozzz 8c559fad1e
Merge branch 'release/1.4.0' into develop 2019-09-11 11:09:18 +02:00
Chocobozzz 22af8aac79
Bumped to version v1.4.1 2019-09-09 08:15:24 +02:00
Chocobozzz 076d3ace1e
Bumped to version v1.4.0 2019-08-26 11:56:10 +02:00
Chocobozzz f01dc977ae
Bumped to version v1.4.0 2019-08-26 08:49:46 +02:00
Frank Sträter 2a8ae7595c Update API documentation for accounts and config (#2072)
* Update Actor and Account schemas

* Fix mixed up paramaters for /accounts

* Update ServerConfig schema

* Add ServerConfigAbout and ServerConfigCustom schemas
2019-08-22 13:33:07 +02:00
Frank Sträter 0ad45af705 Improved description of all file uploads (#2053)
* Add format:binary for file uploads

* Fix wrongly named field for encoding

* Fix typo in field name

* Add contentType for torrentfile and captionfile

* Add contentType for videofile
2019-08-21 08:32:15 +02:00
Frank Sträter 37db4176f2 Add originallyPublishedAt to PUT videos + change HTTP response to 204 2019-08-14 11:10:17 +02:00
Chocobozzz 54beb819f0
Bumped to version v1.4.0-rc.1 2019-08-13 15:34:39 +02:00
Frank Sträter 07d02f6de8 Specify the restrictions on tags array and it's string items (#2016)
* Fixed 2 typos

* Specify tags array restrictions
2019-08-12 10:19:45 +02:00
Frank Sträter b3d1054e86 Fixed 2 typos 2019-08-07 10:36:22 +02:00
Frank Sträter f9f8909298 Add originallyPublishedAt in /videos/upload to the OpenAPI document 2019-08-05 14:18:03 +02:00
Chocobozzz bfbd912886 Fix broken playlist api 2019-08-01 09:11:04 +02:00
Chocobozzz 1f82e3e885
Add video import in open api 2019-07-29 14:33:16 +02:00
Chocobozzz 094ff8e692
Fix mocha commands 2019-07-29 14:16:03 +02:00
Dirk Kelly 512a575971 Updated openapi.html ExternalDocs url 2019-07-08 16:06:55 +02:00
Chocobozzz cb9d028a6b
Fix openapi schema 2019-07-03 17:28:09 +02:00
Chocobozzz b6a1dd4d1b
Merge branch 'release/v1.3.0' into develop 2019-06-17 09:48:41 +02:00
Chocobozzz 0109c4921c
Bumped to version v1.3.1 2019-06-17 08:38:32 +02:00
Chocobozzz 5dce26d202
Improve video REST documentation 2019-06-11 10:01:22 +02:00
Chocobozzz 1f20622f2b
Improve registration
* Add ability to set the user display name
 * Use display name to guess the username/channel name
 * Add explanations about what is the purpose of a username/channel name
 * Add a loader at the "done" step
2019-06-07 17:05:42 +02:00
Chocobozzz a41b9da1a9
Merge branch 'release/v1.3.0' into develop 2019-06-03 09:32:33 +02:00
Chocobozzz 88ebb43310
Bumped to version v1.3.0 2019-06-03 08:47:25 +02:00
Chocobozzz 7d14d4d2ca
Server: Bulk update videos support field 2019-05-31 16:44:46 +02:00
Raphael 089caedc6f refactor(docs): typo in Open API reference 2019-05-24 13:53:43 +02:00
Chocobozzz 048b694661
Fix videos list response in rest api doc 2019-05-24 10:17:54 +02:00
Chocobozzz ee89e8fd1a
Fix video privacy in rest api documentation 2019-05-24 10:09:27 +02:00
Chocobozzz 67ae04a5e7
Add video caption rest api doc 2019-05-24 10:01:08 +02:00
Chocobozzz 63d17405d0
Fix role documentation in rest api 2019-05-24 09:25:30 +02:00
Chocobozzz 46e9407c60
Update URLs to point to new documentation site 2019-05-23 14:58:34 +02:00
Chocobozzz faebb42355
Bumped to version v1.3.0-rc.2 2019-05-22 09:37:13 +02:00
Chocobozzz ea0877b405
Bumped to version v1.3.0-rc.2 2019-05-22 08:22:14 +02:00
Chocobozzz 3fbbadabea
Bumped to version v1.3.0-rc.1 2019-05-14 14:00:03 +02:00
Chocobozzz ff40a4ebab
dailyVideoQuota -> videoQuotaDaily in doc 2019-04-24 17:35:59 +02:00
Chocobozzz 9ce3d3027e
Fix video channel API route param in doc 2019-04-24 16:57:34 +02:00
Chocobozzz fbe1bc2afa
Add videoQuotaDaily in documentation 2019-04-24 16:54:17 +02:00
Yohan Boniface c100a6142e Add /accounts/:username/ratings endpoint (#1756)
* Add /users/me/videos/ratings endpoint

* Move ratings endpoint from users to accounts

* /accounts/:name/ratings: add support for rating= and sort=

* Restrict ratings list to owner

* Wording and better way to ensure current account
2019-04-09 11:02:02 +02:00
Mathieu Agopian 12fed49eba Add the video tags restrictions to the API docs
Fixes #1744
2019-03-29 16:58:05 +01:00
Chocobozzz 28c8e63e55
Add video import enpoint in openapi 2019-02-19 17:56:50 +01:00
Chocobozzz 301fc49c17
Bumped to version v1.2.1 2019-02-15 09:43:39 +01:00
Chocobozzz f5305c04aa
Bumped to version v1.2.0 2019-02-06 11:57:57 +01:00
Chocobozzz cfeae291c0
Bumped to version v1.2.0-rc.1 2019-01-17 16:15:20 +01:00
Chocobozzz 1fd12c7cfa
Fix video tags update/upload in openapi 2019-01-09 14:10:25 +01:00
Rigel Kent e76d578414
(doc) update API spec to include user subscription routes 2019-01-03 18:00:29 +01:00
Rigel Kent f50ab1c289
(doc) fix syntax in openapi spec for watching progress 2018-12-08 18:56:12 +01:00
Rigel Kent 2beb98952a
change type of languageOneOf query parameter 2018-12-04 13:51:10 +01:00
Chocobozzz b6ff69719d
Bumped to version v1.1.0 2018-12-04 08:29:12 +01:00
Rigel Kent fd5af7a269
add parameters to GET /videos route spec 2018-11-24 18:18:56 +01:00
Chocobozzz 6cc98dfff3
Add open api bump version in release script 2018-11-22 15:04:14 +01:00
Rigel Kent 0f49023061
make POST /users have integer role enum 2018-11-21 11:52:30 +01:00
Rigel Kent d216b5387f
add job state in path in openapi spec 2018-11-19 22:10:35 +01:00
Rigel Kent 65f0267930
fix rest api quickstart and specify values in openapi spec 2018-11-19 22:07:38 +01:00
Rigel Kent 9d0b856e93
(quickfix) typo in openapi spec groups 2018-11-17 15:17:33 +01:00
Rigel Kent 9ab81fc4a9
grouping moderation endpoints in the REST API spec 2018-11-17 15:16:01 +01:00
Rigel Kent 5776f78e3b
grouping tags by main category in the spec 2018-11-16 14:33:49 +01:00
Rigel Kent 6441981bc6
adding ownership and watching video APIs to the spec 2018-11-16 13:31:24 +01:00
Rigel Kent cfd140abd6
remove superfluous privacy field for upload 2018-11-16 13:31:23 +01:00
Rigel Kent 8f9e8be1fc
fix API spec on POST /videos/upload and provide Shell example 2018-11-15 17:09:25 +01:00
Rigel Kent 3e9e6f2f14
migrate Swagger 2.0 spec to OpenAPI 3.0.0 2018-11-15 14:10:16 +01:00
Rigel Kent 2963c3432f
updated REST API documentation 2018-11-13 23:32:55 +01:00
Rigel Kent 1d859b5afa
sync API version with PeerTube version and auto-update it via git hooks 2018-11-13 14:31:48 +01:00
David Libeau 655b549048 Correct API documentation for search (#881) 2018-07-29 22:26:05 +02:00
David Libeau fb72c19384 Correct API documentation for search (#878) 2018-07-28 20:38:49 +02:00
Chocobozzz 330eaf1296
Fix start/count/sort params in documentation 2018-07-17 16:37:54 +02:00
William Lahti 999417328b Ability to programmatically control embeds (#776)
* first stab at jschannel based player api

* semicolon purge

* more method-level docs; consolidate definitions

* missing definitions

* better match peertube's class conventions

* styling for embed tester

* basic docs

* add `getVolume`

* document the test-embed feature
2018-07-10 17:47:56 +02:00
PhieF 61b909b9bf Filter by category (#720)
* get videos with specific category (api)

* update api doc with category

* add url parameter to filter by category

* fix lint issues
2018-06-27 14:24:49 +02:00
Chocobozzz bbe0f0645c
Add ability to schedule video publication 2018-06-15 18:20:56 +02:00
Chocobozzz 2186386cca
Add concept of video state, and add ability to wait transcoding before
publishing a video
2018-06-12 20:37:51 +02:00
Chocobozzz f286060081
Add API example to list videos 2018-06-11 14:45:43 +02:00
Chocobozzz ad9e39fb81
Only use account name in routes 2018-05-25 10:41:07 +02:00
Chocobozzz cc918ac3f4
Update video-channel routes (again)
Use /video-channels now, it's more simple for clients
2018-04-25 16:16:21 +02:00
Chocobozzz 6b738c7a31
Video channel API routes refractor 2018-04-25 13:50:48 +02:00
Chocobozzz 48dce1c90d
Update video channel routes 2018-04-24 17:12:57 +02:00
Chocobozzz 9d3ef9fe05
Use ISO 639 for languages 2018-04-23 14:39:52 +02:00
Chocobozzz c0c7416a23
Add rest api quickstart 2018-04-17 11:12:37 +02:00
Rigel Kent 244e76a552
feature: initial syndication feeds support
Provides rss 2.0, atom 1.0 and json 1.0 feeds for videos (instance and account-wide) on listings and video-watch views.

* still lacks redis caching
* still lacks lastBuildDate support
* still lacks channel-wide support
* still lacks semantic annotation (for licenses, NSFW warnings, etc.)
* still lacks love ( ˘ ³˘)

* RSS: has MRSS support for torrent lists!
* RSS: includes the first torrent in an enclosure
* JSON: lists all torrents in the 'attachments' object
* ATOM: lacking torrent listing support

Advances #23
Partial implementation for the accountId generation in the client, which will need a hotfix to add a way to get the proper account id.
2018-04-17 01:09:06 +02:00
Chocobozzz 94ff4c2335
Add auth documentation 2018-04-16 17:27:00 +02:00
Chocobozzz 228e84aa7e
Upgrade spectacle module 2018-04-06 10:44:02 +02:00
Chocobozzz 97ea24045d
Fix api doc in video update endpoint 2018-04-06 10:20:11 +02:00
Chocobozzz 61b66b361f
Upgrade api doc 2018-04-06 10:17:06 +02:00
luz.paz f209b32afa Misc. typos
Found via `codespell -q 3`
2018-03-30 18:51:57 +02:00
Chocobozzz 164e6c8778
Prepare beta 2018-03-20 10:32:54 +01:00
Chocobozzz 5d00a3d7aa
Update the api documentation 2018-03-19 14:20:04 +01:00
Chocobozzz 19a3b914f1
Change video abuse API response 2018-03-12 11:44:28 +01:00
Chocobozzz b64c950a1c
Update videos api list for account 2018-03-12 11:44:28 +01:00
Chocobozzz ea65a47623
Add api base path in documentation 2018-03-07 13:13:40 +01:00
Chocobozzz ab0ee6a14f
Upgrade api doc html file 2018-03-07 08:11:38 +01:00
Dimitri Gilbert 44cb3b85f8 Apidoc (#302)
* Basic api documentation

* fix styling issue

* fix styling issue

* gitignore unecessary folders

* openApi 2.0 first draft

* solved conflicts

* solved errors in openapi file

* added missing doc on video + deleted apidoc comments

* fix last warnings and errors inopenapi definition

* openapi fix typo + improvement on video/comment endpoints

* removed misplaced openapi file

* api documentation improvement
2018-02-17 19:24:56 +01:00
Dimitri Gilbert c360c49456 Api doc improvement (#252)
* Basic api documentation

* fix styling issue

* fix styling issue

* gitignore unecessary folders

* openApi 2.0 first draft

* solved conflicts

* solved errors in openapi file

* added missing doc on video + deleted apidoc comments

* fix last warnings and errors inopenapi definition

* openapi fix typo + improvement on video/comment endpoints

* removed misplaced openapi file
2018-01-25 18:39:51 +01:00
Chocobozzz 5e1c08eb94
Add api doc in html 2018-01-24 11:54:32 +01:00
Chocobozzz 9ee83eb99e
Fix tests 2018-01-24 11:03:13 +01:00