173 lines
14 KiB
Python
173 lines
14 KiB
Python
# coding: utf-8
|
|
|
|
"""
|
|
PeerTube
|
|
|
|
The PeerTube API is built on HTTP(S) and is RESTful. You can use your favorite HTTP/REST library for your programming language to use PeerTube. 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 - we generate some client SDKs automatically: - [Python](https://framagit.org/framasoft/peertube/clients/python) - [Go](https://framagit.org/framasoft/peertube/clients/go) - [Kotlin](https://framagit.org/framasoft/peertube/clients/kotlin) See the [REST API quick start](https://docs.joinpeertube.org/api/rest-getting-started) for a few examples of using the PeerTube API. # Authentication When you sign up for an account on a PeerTube instance, you are given the possibility to generate sessions on it, and authenticate there using an access token. Only __one access token can currently be used at a time__. ## Roles Accounts are given permissions based on their role. There are three roles on PeerTube: Administrator, Moderator, and User. See the [roles guide](https://docs.joinpeertube.org/admin/managing-users#roles) for a detail of their permissions. # Errors The API uses standard HTTP status codes to indicate the success or failure of the API call, completed by a [RFC7807-compliant](https://tools.ietf.org/html/rfc7807) response body. ``` HTTP 1.1 404 Not Found Content-Type: application/problem+json; charset=utf-8 { \"detail\": \"Video not found\", \"docs\": \"https://docs.joinpeertube.org/api-rest-reference.html#operation/getVideo\", \"status\": 404, \"title\": \"Not Found\", \"type\": \"about:blank\" } ``` We provide error `type` values for [a growing number of cases](https://github.com/Chocobozzz/PeerTube/blob/develop/packages/models/src/server/core-error-code.enum.ts), but it is still optional. Types are used to disambiguate errors that bear the same status code and are non-obvious: ``` HTTP 1.1 403 Forbidden Content-Type: application/problem+json; charset=utf-8 { \"detail\": \"Cannot get this video regarding follow constraints\", \"docs\": \"https://docs.joinpeertube.org/api-rest-reference.html#operation/getVideo\", \"status\": 403, \"title\": \"Forbidden\", \"type\": \"https://docs.joinpeertube.org/api-rest-reference.html#section/Errors/does_not_respect_follow_constraints\" } ``` Here a 403 error could otherwise mean that the video is private or blocklisted. ### Validation errors Each parameter is evaluated on its own against a set of rules before the route validator proceeds with potential testing involving parameter combinations. Errors coming from validation errors appear earlier and benefit from a more detailed error description: ``` HTTP 1.1 400 Bad Request Content-Type: application/problem+json; charset=utf-8 { \"detail\": \"Incorrect request parameters: id\", \"docs\": \"https://docs.joinpeertube.org/api-rest-reference.html#operation/getVideo\", \"instance\": \"/api/v1/videos/9c9de5e8-0a1e-484a-b099-e80766180\", \"invalid-params\": { \"id\": { \"location\": \"params\", \"msg\": \"Invalid value\", \"param\": \"id\", \"value\": \"9c9de5e8-0a1e-484a-b099-e80766180\" } }, \"status\": 400, \"title\": \"Bad Request\", \"type\": \"about:blank\" } ``` Where `id` is the name of the field concerned by the error, within the route definition. `invalid-params.<field>.location` can be either 'params', 'body', 'header', 'query' or 'cookies', and `invalid-params.<field>.value` reports the value that didn't pass validation whose `invalid-params.<field>.msg` is about. ### Deprecated error fields Some fields could be included with previous versions. They are still included but their use is deprecated: - `error`: superseded by `detail` - `code`: superseded by `type` (which is now an URI) # Rate limits We are rate-limiting all endpoints of PeerTube's API. Custom values can be set by administrators: | Endpoint (prefix: `/api/v1`) | Calls | Time frame | |------------------------------|---------------|--------------| | `/*` | 50 | 10 seconds | | `POST /users/token` | 15 | 5 minutes | | `POST /users/register` | 2<sup>*</sup> | 5 minutes | | `POST /users/ask-send-verify-email` | 3 | 5 minutes | Depending on the endpoint, <sup>*</sup>failed requests are not taken into account. A service limit is announced by a `429 Too Many Requests` status code. You can get details about the current state of your rate limit by reading the following headers: | Header | Description | |-------------------------|------------------------------------------------------------| | `X-RateLimit-Limit` | Number of max requests allowed in the current time period | | `X-RateLimit-Remaining` | Number of remaining requests in the current time period | | `X-RateLimit-Reset` | Timestamp of end of current time period as UNIX timestamp | | `Retry-After` | Seconds to delay after the first `429` is received | # CORS This API features [Cross-Origin Resource Sharing (CORS)](https://fetch.spec.whatwg.org/), allowing cross-domain communication from the browser for some routes: | Endpoint | |------------------------- ---| | `/api/*` | | `/download/*` | | `/lazy-static/*` | | `/.well-known/webfinger` | In addition, all routes serving ActivityPub are CORS-enabled for all origins.
|
|
|
|
The version of the OpenAPI document: 5.2.0
|
|
Generated by OpenAPI Generator (https://openapi-generator.tech)
|
|
|
|
Do not edit the class manually.
|
|
""" # noqa: E501
|
|
|
|
|
|
from __future__ import annotations
|
|
import pprint
|
|
import re # noqa: F401
|
|
import json
|
|
|
|
from datetime import datetime
|
|
from pydantic import BaseModel, Field, StrictBool, StrictInt, StrictStr, field_validator
|
|
from typing import Any, ClassVar, Dict, List, Optional
|
|
from typing_extensions import Annotated
|
|
from peertube.models.account import Account
|
|
from peertube.models.nsfw_policy import NSFWPolicy
|
|
from peertube.models.user_role import UserRole
|
|
from peertube.models.video_channel import VideoChannel
|
|
from typing import Optional, Set
|
|
from typing_extensions import Self
|
|
|
|
class UserWithStats(BaseModel):
|
|
"""
|
|
UserWithStats
|
|
""" # noqa: E501
|
|
account: Optional[Account] = None
|
|
auto_play_next_video: Optional[StrictBool] = Field(default=None, description="Automatically start playing the upcoming video after the currently playing video", alias="autoPlayNextVideo")
|
|
auto_play_next_video_playlist: Optional[StrictBool] = Field(default=None, description="Automatically start playing the video on the playlist after the currently playing video", alias="autoPlayNextVideoPlaylist")
|
|
auto_play_video: Optional[StrictBool] = Field(default=None, description="Automatically start playing the video on the watch page", alias="autoPlayVideo")
|
|
blocked: Optional[StrictBool] = None
|
|
blocked_reason: Optional[StrictStr] = Field(default=None, alias="blockedReason")
|
|
created_at: Optional[StrictStr] = Field(default=None, alias="createdAt")
|
|
email: Optional[StrictStr] = Field(default=None, description="The user email")
|
|
email_verified: Optional[StrictBool] = Field(default=None, description="Has the user confirmed their email address?", alias="emailVerified")
|
|
id: Optional[Annotated[int, Field(strict=True, ge=1)]] = None
|
|
plugin_auth: Optional[StrictStr] = Field(default=None, description="Auth plugin to use to authenticate the user", alias="pluginAuth")
|
|
last_login_date: Optional[datetime] = Field(default=None, alias="lastLoginDate")
|
|
no_instance_config_warning_modal: Optional[StrictBool] = Field(default=None, alias="noInstanceConfigWarningModal")
|
|
no_account_setup_warning_modal: Optional[StrictBool] = Field(default=None, alias="noAccountSetupWarningModal")
|
|
no_welcome_modal: Optional[StrictBool] = Field(default=None, alias="noWelcomeModal")
|
|
nsfw_policy: Optional[NSFWPolicy] = Field(default=None, alias="nsfwPolicy")
|
|
role: Optional[UserRole] = None
|
|
theme: Optional[StrictStr] = Field(default=None, description="Theme enabled by this user")
|
|
username: Optional[Annotated[str, Field(min_length=1, strict=True, max_length=50)]] = Field(default=None, description="immutable name of the user, used to find or mention its actor")
|
|
video_channels: Optional[List[VideoChannel]] = Field(default=None, alias="videoChannels")
|
|
video_quota: Optional[StrictInt] = Field(default=None, description="The user video quota in bytes", alias="videoQuota")
|
|
video_quota_daily: Optional[StrictInt] = Field(default=None, description="The user daily video quota in bytes", alias="videoQuotaDaily")
|
|
p2p_enabled: Optional[StrictBool] = Field(default=None, description="Enable P2P in the player", alias="p2pEnabled")
|
|
videos_count: Optional[StrictInt] = Field(default=None, description="Count of videos published", alias="videosCount")
|
|
abuses_count: Optional[StrictInt] = Field(default=None, description="Count of reports/abuses of which the user is a target", alias="abusesCount")
|
|
abuses_accepted_count: Optional[StrictInt] = Field(default=None, description="Count of reports/abuses created by the user and accepted/acted upon by the moderation team", alias="abusesAcceptedCount")
|
|
abuses_created_count: Optional[StrictInt] = Field(default=None, description="Count of reports/abuses created by the user", alias="abusesCreatedCount")
|
|
video_comments_count: Optional[StrictInt] = Field(default=None, description="Count of comments published", alias="videoCommentsCount")
|
|
__properties: ClassVar[List[str]] = ["account", "autoPlayNextVideo", "autoPlayNextVideoPlaylist", "autoPlayVideo", "blocked", "blockedReason", "createdAt", "email", "emailVerified", "id", "pluginAuth", "lastLoginDate", "noInstanceConfigWarningModal", "noAccountSetupWarningModal", "noWelcomeModal", "nsfwPolicy", "role", "theme", "username", "videoChannels", "videoQuota", "videoQuotaDaily", "p2pEnabled", "videosCount", "abusesCount", "abusesAcceptedCount", "abusesCreatedCount", "videoCommentsCount"]
|
|
|
|
@field_validator('username')
|
|
def username_validate_regular_expression(cls, value):
|
|
"""Validates the regular expression"""
|
|
if value is None:
|
|
return value
|
|
|
|
if not re.match(r"^[a-z0-9._]+$", value):
|
|
raise ValueError(r"must validate the regular expression /^[a-z0-9._]+$/")
|
|
return value
|
|
|
|
model_config = {
|
|
"populate_by_name": True,
|
|
"validate_assignment": True,
|
|
"protected_namespaces": (),
|
|
}
|
|
|
|
|
|
def to_str(self) -> str:
|
|
"""Returns the string representation of the model using alias"""
|
|
return pprint.pformat(self.model_dump(by_alias=True))
|
|
|
|
def to_json(self) -> str:
|
|
"""Returns the JSON representation of the model using alias"""
|
|
# TODO: pydantic v2: use .model_dump_json(by_alias=True, exclude_unset=True) instead
|
|
return json.dumps(self.to_dict())
|
|
|
|
@classmethod
|
|
def from_json(cls, json_str: str) -> Optional[Self]:
|
|
"""Create an instance of UserWithStats from a JSON string"""
|
|
return cls.from_dict(json.loads(json_str))
|
|
|
|
def to_dict(self) -> Dict[str, Any]:
|
|
"""Return the dictionary representation of the model using alias.
|
|
|
|
This has the following differences from calling pydantic's
|
|
`self.model_dump(by_alias=True)`:
|
|
|
|
* `None` is only added to the output dict for nullable fields that
|
|
were set at model initialization. Other fields with value `None`
|
|
are ignored.
|
|
* OpenAPI `readOnly` fields are excluded.
|
|
"""
|
|
excluded_fields: Set[str] = set([
|
|
"id",
|
|
])
|
|
|
|
_dict = self.model_dump(
|
|
by_alias=True,
|
|
exclude=excluded_fields,
|
|
exclude_none=True,
|
|
)
|
|
# override the default output from pydantic by calling `to_dict()` of account
|
|
if self.account:
|
|
_dict['account'] = self.account.to_dict()
|
|
# override the default output from pydantic by calling `to_dict()` of role
|
|
if self.role:
|
|
_dict['role'] = self.role.to_dict()
|
|
# override the default output from pydantic by calling `to_dict()` of each item in video_channels (list)
|
|
_items = []
|
|
if self.video_channels:
|
|
for _item in self.video_channels:
|
|
if _item:
|
|
_items.append(_item.to_dict())
|
|
_dict['videoChannels'] = _items
|
|
return _dict
|
|
|
|
@classmethod
|
|
def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
|
|
"""Create an instance of UserWithStats from a dict"""
|
|
if obj is None:
|
|
return None
|
|
|
|
if not isinstance(obj, dict):
|
|
return cls.model_validate(obj)
|
|
|
|
_obj = cls.model_validate({
|
|
"account": Account.from_dict(obj["account"]) if obj.get("account") is not None else None,
|
|
"autoPlayNextVideo": obj.get("autoPlayNextVideo"),
|
|
"autoPlayNextVideoPlaylist": obj.get("autoPlayNextVideoPlaylist"),
|
|
"autoPlayVideo": obj.get("autoPlayVideo"),
|
|
"blocked": obj.get("blocked"),
|
|
"blockedReason": obj.get("blockedReason"),
|
|
"createdAt": obj.get("createdAt"),
|
|
"email": obj.get("email"),
|
|
"emailVerified": obj.get("emailVerified"),
|
|
"id": obj.get("id"),
|
|
"pluginAuth": obj.get("pluginAuth"),
|
|
"lastLoginDate": obj.get("lastLoginDate"),
|
|
"noInstanceConfigWarningModal": obj.get("noInstanceConfigWarningModal"),
|
|
"noAccountSetupWarningModal": obj.get("noAccountSetupWarningModal"),
|
|
"noWelcomeModal": obj.get("noWelcomeModal"),
|
|
"nsfwPolicy": obj.get("nsfwPolicy"),
|
|
"role": UserRole.from_dict(obj["role"]) if obj.get("role") is not None else None,
|
|
"theme": obj.get("theme"),
|
|
"username": obj.get("username"),
|
|
"videoChannels": [VideoChannel.from_dict(_item) for _item in obj["videoChannels"]] if obj.get("videoChannels") is not None else None,
|
|
"videoQuota": obj.get("videoQuota"),
|
|
"videoQuotaDaily": obj.get("videoQuotaDaily"),
|
|
"p2pEnabled": obj.get("p2pEnabled"),
|
|
"videosCount": obj.get("videosCount"),
|
|
"abusesCount": obj.get("abusesCount"),
|
|
"abusesAcceptedCount": obj.get("abusesAcceptedCount"),
|
|
"abusesCreatedCount": obj.get("abusesCreatedCount"),
|
|
"videoCommentsCount": obj.get("videoCommentsCount")
|
|
})
|
|
return _obj
|
|
|
|
|