mirror of https://github.com/Chocobozzz/PeerTube
grouping tags by main category in the spec
Rigel Kent
parent
6441981bc6
commit
5776f78e3b
|
|
@ -10,29 +10,41 @@ info:
|
|||
url: 'https://github.com/Chocobozzz/PeerTube/blob/master/LICENSE'
|
||||
x-logo:
|
||||
url: 'https://joinpeertube.org/img/brand.png'
|
||||
altText: PeerTube Project Homepage
|
||||
description: |
|
||||
# Introduction
|
||||
The PeerTube API is built on HTTP(S). Our API is RESTful. It has predictable
|
||||
resource URLs. It returns HTTP response codes to indicate errors. It also
|
||||
accepts and returns JSON in the HTTP body. You can use your favorite
|
||||
HTTP/REST library for your programming language to use PeerTube. No official
|
||||
SDK is currently provided.
|
||||
SDK is currently provided, but the spec API is fully compatible with
|
||||
[openapi-generator](https://github.com/OpenAPITools/openapi-generator/wiki/API-client-generator-HOWTO)
|
||||
which generates a client SDK in the language of your choice.
|
||||
|
||||
# Authentication
|
||||
When you sign up for an account, you are given the possibility to generate
|
||||
sessions, and authenticate using this session token. One session token can
|
||||
currently be used at a time.
|
||||
|
||||
# Errors
|
||||
The API uses standard HTTP status codes to indicate the success or failure
|
||||
of the API call. The body of the response will be JSON in the following
|
||||
format.
|
||||
|
||||
```
|
||||
{
|
||||
"code": "unauthorized_request", // example inner error code
|
||||
"error": "Token is invalid." // example exposed error message
|
||||
}
|
||||
```
|
||||
externalDocs:
|
||||
url: https://docs.joinpeertube.org/api.html
|
||||
tags:
|
||||
- name: Accounts
|
||||
description: >
|
||||
Using some features of PeerTube require authentication, for which Accounts
|
||||
|
||||
provide different levels of permission as well as associated user
|
||||
information.
|
||||
|
||||
Accounts also encompass remote accounts discovered across the federation.
|
||||
information. Accounts also encompass remote accounts discovered across the federation.
|
||||
- name: Config
|
||||
description: >
|
||||
Each server exposes public information regarding supported videos and
|
||||
|
|
@ -44,21 +56,13 @@ tags:
|
|||
- name: Job
|
||||
description: >
|
||||
Jobs are long-running tasks enqueued and processed by the instance
|
||||
itself.
|
||||
|
||||
No additional worker registration is currently available.
|
||||
itself. No additional worker registration is currently available.
|
||||
- name: Server Following
|
||||
description: >
|
||||
Managing servers which the instance interacts with is crucial to the
|
||||
concept
|
||||
|
||||
of federation in PeerTube and external video indexation. The PeerTube
|
||||
server
|
||||
|
||||
then deals with inter-server ActivityPub operations and propagates
|
||||
|
||||
concept of federation in PeerTube and external video indexation. The PeerTube
|
||||
server then deals with inter-server ActivityPub operations and propagates
|
||||
information across its social graph by posting activities to actors' inbox
|
||||
|
||||
endpoints.
|
||||
- name: Video Abuse
|
||||
description: |
|
||||
|
|
@ -79,9 +83,43 @@ tags:
|
|||
- name: Video Channel
|
||||
description: >
|
||||
Operations dealing with creation, modification and video listing of a
|
||||
user's
|
||||
|
||||
channels.
|
||||
user's channels.
|
||||
- name: Video Blacklist
|
||||
description: >
|
||||
Operations dealing with blacklisting videos (removing them from view and
|
||||
preventing interactions).
|
||||
- name: Video Rate
|
||||
description: >
|
||||
Voting for a video.
|
||||
x-tagGroups:
|
||||
- name: Accounts
|
||||
tags:
|
||||
- Accounts
|
||||
- User
|
||||
- name: Videos
|
||||
tags:
|
||||
- Video
|
||||
- Video Channel
|
||||
- Video Comment
|
||||
- Video Abuse
|
||||
- Video Following
|
||||
- Video Rate
|
||||
- name: Moderation
|
||||
tags:
|
||||
- Video Blacklist
|
||||
- name: Public Instance Information
|
||||
tags:
|
||||
- Config
|
||||
- Server Following
|
||||
- name: Notifications
|
||||
tags:
|
||||
- Feeds
|
||||
- name: Jobs
|
||||
tags:
|
||||
- Job
|
||||
- name: Search
|
||||
tags:
|
||||
- Search
|
||||
paths:
|
||||
'/accounts/{name}':
|
||||
get:
|
||||
|
|
@ -128,6 +166,37 @@ paths:
|
|||
source: |
|
||||
# pip install httpie
|
||||
http -b GET https://peertube2.cpy.re/api/v1/accounts/{name}/videos
|
||||
- lang: Ruby
|
||||
source: |
|
||||
require 'uri'
|
||||
require 'net/http'
|
||||
|
||||
url = URI("https://peertube2.cpy.re/api/v1/accounts/{name}/videos")
|
||||
|
||||
http = Net::HTTP.new(url.host, url.port)
|
||||
http.use_ssl = true
|
||||
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
|
||||
|
||||
request = Net::HTTP::Post.new(url)
|
||||
request["content-type"] = 'application/json'
|
||||
response = http.request(request)
|
||||
puts response.read_body
|
||||
- lang: Python
|
||||
source: |
|
||||
import http.client
|
||||
|
||||
conn = http.client.HTTPSConnection("https://peertube2.cpy.re/api/v1")
|
||||
|
||||
headers = {
|
||||
'content-type': "application/json"
|
||||
}
|
||||
|
||||
conn.request("POST", "/accounts/{name}/videos", None, headers)
|
||||
|
||||
res = conn.getresponse()
|
||||
data = res.read()
|
||||
|
||||
print(data.decode("utf-8"))
|
||||
/accounts:
|
||||
get:
|
||||
tags:
|
||||
|
|
|
|||
Loading…
Reference in New Issue