<span aria-hidden="true">×</span>
</button>
<nav id="nav" role="navigation">
- <h5>API Reference</h5>
+ <h5>Topics</h5>
<a href="#introduction">Introduction</a>
+ <a href="#authentication">Authentication</a>
<h5>Operations</h5>
<section>
<a href="#tag-Accounts">Accounts</a>
<ul>
<li>
- <a href="#operation--accounts--id--get"> GET /accounts/{id} </a>
+ <a href="#operation--accounts--name--get"> Get the account by name </a>
</li>
<li>
- <a href="#operation--accounts-get"> GET /accounts </a>
+ <a href="#operation--accounts--name--videos-get"> Get videos for an account, provided the name of that account </a>
+ </li>
+ <li>
+ <a href="#operation--accounts-get"> Get all accounts </a>
</li>
</ul>
</section>
<a href="#tag-Config">Config</a>
<ul>
<li>
- <a href="#operation--config-get"> GET /config </a>
+ <a href="#operation--config-get"> Get the configuration of the server </a>
+ </li>
+ </ul>
+ </section>
+ <section>
+ <a href="#tag-Feeds">Feeds</a>
+ <ul>
+ <li>
+ <a href="#operation--feeds-videos.-format--get"> Get the feed of videos for the server, with optional filter by account name or id </a>
</li>
</ul>
</section>
<a href="#tag-Job">Job</a>
<ul>
<li>
- <a href="#operation--jobs-get"> GET /jobs </a>
+ <a href="#operation--jobs-get"> Get list of jobs </a>
</li>
</ul>
</section>
<a href="#tag-ServerFollowing">ServerFollowing</a>
<ul>
<li>
- <a href="#operation--server-following--host--delete"> DELETE /server/following/{host} </a>
+ <a href="#operation--server-following--host--delete"> Unfollow a server by hostname </a>
</li>
<li>
- <a href="#operation--server-followers-get"> GET /server/followers </a>
+ <a href="#operation--server-followers-get"> Get followers of the server </a>
</li>
<li>
- <a href="#operation--server-following-get"> GET /server/following </a>
+ <a href="#operation--server-following-get"> Get servers followed by the server </a>
</li>
<li>
- <a href="#operation--server-following-post"> POST /server/following </a>
+ <a href="#operation--server-following-post"> Follow a server </a>
</li>
</ul>
</section>
<section>
- <a href="#tag-User">User</a>
+ <a href="#tag-VideoAbuse">VideoAbuse</a>
+ <ul>
+ <li>
+ <a href="#operation--videos-abuse-get"> Get list of reported video abuses </a>
+ </li>
+ <li>
+ <a href="#operation--videos--id--abuse-post"> Report an abuse, on a video by its id </a>
+ </li>
+ </ul>
+ </section>
+ <section>
+ <a href="#tag-Video">Video</a>
<ul>
<li>
- <a href="#operation--users-post"> POST /users </a>
+ <a href="#operation--accounts--name--videos-get"> Get videos for an account, provided the name of that account </a>
</li>
<li>
- <a href="#operation--users-get"> GET /users </a>
+ <a href="#operation--videos-get"> Get list of videos </a>
</li>
<li>
- <a href="#operation--users--id--delete"> DELETE /users/{id} </a>
+ <a href="#operation--videos-categories-get"> Get list of video licences known by the server </a>
</li>
<li>
- <a href="#operation--users--id--get"> GET /users/{id} </a>
+ <a href="#operation--videos-licences-get"> Get list of video licences known by the server </a>
</li>
<li>
- <a href="#operation--users--id--put"> PUT /users/{id} </a>
+ <a href="#operation--videos-languages-get"> Get list of languages known by the server </a>
</li>
<li>
- <a href="#operation--users-me-get"> GET /users/me </a>
+ <a href="#operation--videos-privacies-get"> Get list of privacy policies supported by the server </a>
</li>
<li>
- <a href="#operation--users-me-put"> PUT /users/me </a>
+ <a href="#operation--videos--id--put"> Update metadata for a video by its id </a>
</li>
<li>
- <a href="#operation--users-me-video-quota-used-get"> GET /users/me/video-quota-used </a>
+ <a href="#operation--videos--id--get"> Get a video by its id </a>
</li>
<li>
- <a href="#operation--users-me-videos--videoId--rating-get"> GET /users/me/videos/{videoId}/rating </a>
+ <a href="#operation--videos--id--delete"> Delete a video by its id </a>
</li>
<li>
- <a href="#operation--users-me-videos-get"> GET /users/me/videos </a>
+ <a href="#operation--videos--id--description-get"> Get a video description by its id </a>
</li>
<li>
- <a href="#operation--users-register-post"> POST /users/register </a>
+ <a href="#operation--videos--id--views-post"> Add a view to the video by its id </a>
</li>
<li>
- <a href="#operation--users-me-avatar-pick-post"> POST /users/me/avatar/pick </a>
+ <a href="#operation--videos-upload-post"> Upload a video file with its metadata </a>
</li>
</ul>
</section>
<section>
- <a href="#tag-Video">Video</a>
+ <a href="#tag-Search">Search</a>
+ <ul>
+ <li>
+ <a href="#operation--search-videos-get"> Get the videos corresponding to a given query </a>
+ </li>
+ </ul>
+ </section>
+ <section>
+ <a href="#tag-VideoComment">VideoComment</a>
<ul>
<li>
- <a href="#operation--videos-get"> GET /videos </a>
+ <a href="#operation--videos--id--comment-threads-get"> Get the comment threads of a video by its id </a>
</li>
<li>
- <a href="#operation--videos-categories-get"> GET /videos/categories </a>
+ <a href="#operation--videos--id--comment-threads-post"> Creates a comment thread, on a video by its id </a>
</li>
<li>
- <a href="#operation--videos-licences-get"> GET /videos/licences </a>
+ <a href="#operation--videos--id--comment-threads--threadId--get"> Get the comment thread by its id, of a video by its id </a>
</li>
<li>
- <a href="#operation--videos-languages-get"> GET /videos/languages </a>
+ <a href="#operation--videos--id--comments--commentId--post"> Creates a comment in a comment thread by its id, of a video by its id </a>
</li>
<li>
- <a href="#operation--videos-privacies-get"> GET /videos/privacies </a>
+ <a href="#operation--videos--id--comments--commentId--delete"> Delete a comment in a comment therad by its id, of a video by its id </a>
</li>
+ </ul>
+ </section>
+ <section>
+ <a href="#tag-VideoChannel">VideoChannel</a>
+ <ul>
<li>
- <a href="#operation--videos-search-get"> GET /videos/search </a>
+ <a href="#operation--video-channels-get"> Get list of video channels </a>
</li>
<li>
- <a href="#operation--videos--id--put"> PUT /videos/{id} </a>
+ <a href="#operation--video-channels-post"> Creates a video channel for the current user </a>
</li>
<li>
- <a href="#operation--videos--id--get"> GET /videos/{id} </a>
+ <a href="#operation--video-channels--id--get"> Get a video channel by its id </a>
</li>
<li>
- <a href="#operation--videos--id--delete"> DELETE /videos/{id} </a>
+ <a href="#operation--video-channels--id--put"> Update a video channel by its id </a>
</li>
<li>
- <a href="#operation--videos--id--description-get"> GET /videos/{id}/description </a>
+ <a href="#operation--video-channels--id--delete"> Delete a video channel by its id </a>
</li>
<li>
- <a href="#operation--videos--id--views-post"> POST /videos/{id}/views </a>
+ <a href="#operation--video-channels--id--videos-get"> Get videos of a video channel by its id </a>
</li>
<li>
- <a href="#operation--videos-upload-post"> POST /videos/upload </a>
+ <a href="#operation--accounts--name--video-channels-get"> Get video channels of an account by its name </a>
</li>
</ul>
</section>
<section>
- <a href="#tag-VideoAbuse">VideoAbuse</a>
+ <a href="#tag-User">User</a>
<ul>
<li>
- <a href="#operation--videos-abuse-get"> GET /videos/abuse </a>
+ <a href="#operation--users-post"> Creates user </a>
</li>
<li>
- <a href="#operation--videos--id--abuse-post"> POST /videos/{id}/abuse </a>
+ <a href="#operation--users-get"> Get a list of users </a>
</li>
- </ul>
- </section>
- <section>
- <a href="#tag-VideoBlacklist">VideoBlacklist</a>
- <ul>
<li>
- <a href="#operation--videos--videoId--blacklist-post"> POST /videos/{videoId}/blacklist </a>
+ <a href="#operation--users--id--delete"> Delete a user by its id </a>
</li>
<li>
- <a href="#operation--videos--videoId--blacklist-delete"> DELETE /videos/{videoId}/blacklist </a>
+ <a href="#operation--users--id--get"> Get user by its id </a>
</li>
<li>
- <a href="#operation--videos-blacklist-get"> GET /videos/blacklist </a>
+ <a href="#operation--users--id--put"> Update user profile by its id </a>
</li>
- </ul>
- </section>
- <section>
- <a href="#tag-VideoChannel">VideoChannel</a>
- <ul>
<li>
- <a href="#operation--videos-channels-get"> GET /videos/channels </a>
+ <a href="#operation--users-me-get"> Get current user information </a>
</li>
<li>
- <a href="#operation--videos-channels-post"> POST /videos/channels </a>
+ <a href="#operation--users-me-put"> Update current user information </a>
</li>
<li>
- <a href="#operation--videos-channels--id--get"> GET /videos/channels/{id} </a>
+ <a href="#operation--users-me-video-quota-used-get"> Get current user used quota </a>
</li>
<li>
- <a href="#operation--videos-channels--id--put"> PUT /videos/channels/{id} </a>
+ <a href="#operation--users-me-videos--videoId--rating-get"> Get rating of video by its id, among those of the current user </a>
</li>
<li>
- <a href="#operation--videos-channels--id--delete"> DELETE /videos/channels/{id} </a>
+ <a href="#operation--users-me-videos-get"> Get videos of the current user </a>
</li>
<li>
- <a href="#operation--videos-accounts--accountId--channels-get"> GET /videos/accounts/{accountId}/channels </a>
+ <a href="#operation--users-register-post"> Register a user </a>
+ </li>
+ <li>
+ <a href="#operation--users-me-avatar-pick-post"> Update current user avatar </a>
</li>
</ul>
</section>
<section>
- <a href="#tag-VideoComment">VideoComment</a>
+ <a href="#tag-VideoBlacklist">VideoBlacklist</a>
<ul>
<li>
- <a href="#operation--videos--videoId--comment-threads-get"> GET /videos/{videoId}/comment-threads </a>
+ <a href="#operation--videos--id--blacklist-post"> Put on blacklist a video by its id </a>
</li>
<li>
- <a href="#operation--videos--videoId--comment-threads-post"> POST /videos/{videoId}/comment-threads </a>
+ <a href="#operation--videos--id--blacklist-delete"> Delete an entry of the blacklist of a video by its id </a>
</li>
<li>
- <a href="#operation--videos--videoId--comment-threads--threadId--get"> GET /videos/{videoId}/comment-threads/{threadId} </a>
- </li>
- <li>
- <a href="#operation--videos--videoId--comments--commentId--post"> POST /videos/{videoId}/comments/{commentId} </a>
- </li>
- <li>
- <a href="#operation--videos--videoId--comments--commentId--delete"> DELETE /videos/{videoId}/comments/{commentId} </a>
+ <a href="#operation--videos-blacklist-get"> Get list of videos on blacklist </a>
</li>
</ul>
</section>
<a href="#tag-VideoRate">VideoRate</a>
<ul>
<li>
- <a href="#operation--videos--id--rate-put"> PUT /videos/{id}/rate </a>
+ <a href="#operation--videos--id--rate-put"> Vote for a video by its id </a>
</li>
</ul>
</section>
<h5>Schema Definitions</h5>
- <a href="#definition-VideoConstant"> VideoConstant </a>
+ <a href="#definition-VideoConstantNumber"> VideoConstantNumber </a>
+ <a href="#definition-VideoConstantString"> VideoConstantString </a>
+ <a href="#definition-VideoPrivacy"> VideoPrivacy </a>
<a href="#definition-Video"> Video </a>
<a href="#definition-VideoAbuse"> VideoAbuse </a>
<a href="#definition-VideoBlacklist"> VideoBlacklist </a>
</button>
<div class="example-box doc-content"></div>
<article>
+ <h1 class="doc-title">PeerTube
+ <span>API Reference</span>
+ </h1>
<div id="introduction" data-traverse-target="introduction">
- <h1 class="doc-title">PeerTube
- <span>API Reference</span>
- </h1>
<div class="doc-row">
<div class="doc-copy">
- <p>Federated (ActivityPub) video streaming platform using P2P (BitTorrent) directly in the web browser with WebTorrent and Angular.</p>
+ <h1 id="introduction">Introduction</h1>
+ <p>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.</p>
+ <h1 id="authentication">Authentication</h1>
+ <p>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.</p>
</div>
<div class="doc-examples">
<section>
<h5>API Endpoint</h5>
<!-- <div class="hljs"> --><pre><code>https://peertube.example.com/api/v1</code></pre>
<!-- </div> -->
+ <h5>Request Content-Types:
+ <span>application/json</span>
+ </h5>
+ <h5>Response Content-Types:
+ <span>application/json; charset=utf-8</span>
+ </h5>
<h5>Schemes:
<span>https</span>
</h5>
<h5>Version:
- <span>1.0.0-beta</span>
+ <span>1.1.0-alpha.2</span>
</h5>
</section>
</div>
</div>
</div>
+ <!-- <h1 id="security" data-traverse-target="security">Security</h1> -->
+ <h1 id="authentication" data-traverse-target="authentication">Authentication</h1>
+ <div id="security-definition-OAuth2" class="panel">
+ <div class="doc-row">
+ <div class="doc-copy">
+ <h3 class="security-definition-title">
+ <span class="security-name">OAuth2</span>
+ <span class="swagger-security-definition-oauth2"></span>
+ </h3>
+ <section class="security-definition-description">
+ <p>In the header:
+ <em>Authorization: Bearer <token></em>
+ </p>
+ <p>Authenticating via OAuth requires the following steps:</p>
+ <ul>
+ <li>Have an account with sufficient authorization levels</li>
+ <li>
+ <a href="https://docs.joinpeertube.org/lang/en/devdocs/rest.html">Generate</a> a Bearer Token</li>
+ <li>Make Authenticated Requests</li>
+ </ul>
+ </section>
+ <section class="swagger-security-definition-properties">
+ <div class="prop-row security-definition-property">
+ <div class="prop-name">
+ <div class="prop-title security-definition-property-name">type</div>
+ </div>
+ <div class="prop-value security-definition-property-type"> oauth2 </div>
+ </div>
+ <div class="prop-row security-definition-property">
+ <div class="prop-name">
+ <div class="prop-title security-definition-property-name">flow</div>
+ </div>
+ <div class="prop-value security-definition-property-type"> password </div>
+ </div>
+ <div class="prop-row security-definition-property">
+ <div class="prop-name">
+ <div class="prop-title security-definition-property-name">tokenUrl</div>
+ </div>
+ <div class="prop-value security-definition-property-type"> https://peertube.example.com/api/v1/users/token </div>
+ </div>
+ <div class="prop-row security-definition-property">
+ <div class="prop-name">
+ <div class="prop-title security-definition-property-name">scopes</div>
+ </div>
+ <div class="prop-value security-definition-property-type">
+ <span id="security-definition-scope-admin">admin</span>
+ <p class="security-definition-scope-description">Admin scope</p>
+ <span id="security-definition-scope-moderator">moderator</span>
+ <p class="security-definition-scope-description">Moderator scope</p>
+ <span id="security-definition-scope-user">user</span>
+ <p class="security-definition-scope-description">User scope</p>
+ </div>
+ </div>
+ </section>
+ </div>
+ </div>
+ </div>
<h1 id="tag-Accounts" class="swagger-summary-tag" data-traverse-target="tag-Accounts">Accounts</h1>
- <div id="operation--accounts--id--get" class="operation panel" data-traverse-target="operation--accounts--id--get">
+ <div class="tag-description doc-row">
+ <div class="doc-copy">
+ <p>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.</p>
+ </div>
+ </div>
+ <div id="operation--accounts--name--get" class="operation panel" data-traverse-target="operation--accounts--name--get">
<!-- <section class="operation-tags row"> -->
<!-- <div class="doc-copy"> -->
<div class="operation-tags">
<!-- </div> -->
<!-- </section> -->
<h2 class="operation-title">
- <span class="operation-name">
- <span class="operation-name">GET</span>
- <span class="operation-path">/accounts/{id}</span>
- </span>
+ <span class="operation-summary">Get the account by name</span>
</h2>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-operation-path">
+ <span class="operation-method">GET</span>
+ <span class="operation-path">/accounts/{name}</span>
+ </section>
+ </div>
+ </div>
<div class="doc-row">
<div class="doc-copy">
<section class="swagger-request-params">
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">id</div>
+ <div class="prop-title">name:
+ <span class="prop-type">
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
<span class="json-property-required"></span>
+ <div class="prop-subtitle"> in path </div>
</div>
<div class="prop-value">
- <p>The id of the account</p>
- </div>
- </div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
- <div class="prop-value">
- <span class="json-property-type">string</span>
- <span class="json-property-range" title="Value limits"></span>
+ <p>The name of the account (chocobozzz or
+ <a href="mailto:chocobozzz@peertube.cpy.re">chocobozzz@peertube.cpy.re</a> for example)</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">path</div>
- </div>
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">start</div>
- </div>
- <div class="prop-value">
- <p>starting page</p>
+ <div class="prop-title">start:
+ <span class="prop-type">
+ <span class="json-property-type">number</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in query </div>
</div>
- </div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
<div class="prop-value">
- <span class="json-property-type">number</span>
- <span class="json-property-range" title="Value limits"></span>
+ <p>Offset</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">query</div>
- </div>
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">stop</div>
- </div>
- <div class="prop-value">
- <p>stopping page</p>
+ <div class="prop-title">count:
+ <span class="prop-type">
+ <span class="json-property-type">number</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in query </div>
</div>
- </div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
<div class="prop-value">
- <span class="json-property-type">number</span>
- <span class="json-property-range" title="Value limits"></span>
+ <p>Number of items</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">query</div>
- </div>
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">sort</div>
- </div>
- <div class="prop-value">
- <p>sorting</p>
+ <div class="prop-title">sort:
+ <span class="prop-type">
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in query </div>
</div>
- </div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
<div class="prop-value">
- <span class="json-property-type">number</span>
- <span class="json-property-range" title="Value limits"></span>
+ <p>Sort column (-createdAt for example)</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">query</div>
- </div>
</section>
</div>
<div class="doc-examples"></div>
<span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>
}
}
+</code></pre>
+ <!-- </div> -->
+ </section>
+ </div>
+ </div>
+ </div>
+ <div id="operation--accounts--name--videos-get" class="operation panel" data-traverse-target="operation--accounts--name--videos-get">
+ <!-- <section class="operation-tags row"> -->
+ <!-- <div class="doc-copy"> -->
+ <div class="operation-tags">
+ <a class="label" href="#tag-Accounts">Accounts</a>
+ <!--, -->
+ <a class="label" href="#tag-Video">Video</a>
+ <!---->
+ </div>
+ <!-- </div> -->
+ <!-- </section> -->
+ <h2 class="operation-title">
+ <span class="operation-summary">Get videos for an account, provided the name of that account</span>
+ </h2>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-operation-path">
+ <span class="operation-method">GET</span>
+ <span class="operation-path">/accounts/{name}/videos</span>
+ </section>
+ </div>
+ </div>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-request-params">
+ <div class="prop-row prop-group">
+ <div class="prop-name">
+ <div class="prop-title">name:
+ <span class="prop-type">
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <span class="json-property-required"></span>
+ <div class="prop-subtitle"> in path </div>
+ </div>
+ <div class="prop-value">
+ <p>The name of the account (chocobozzz or
+ <a href="mailto:chocobozzz@peertube.cpy.re">chocobozzz@peertube.cpy.re</a> for example)</p>
+ </div>
+ </div>
+ </section>
+ </div>
+ <div class="doc-examples"></div>
+ </div>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-responses">
+ <div class="prop-row prop-group">
+ <div class="prop-name">
+ <div class="prop-title">200 OK</div>
+ <div class="prop-ref">
+ <span class="">
+ <a class="json-schema-ref" href="#/definitions/Video">Video</a>
+ </span>
+ </div>
+ <!-- <span class="swagger-global"></span> <span class="json-schema-reference"><a href=""></a></span> -->
+ </div>
+ <div class="prop-value">
+ <p>successful operation</p>
+ </div>
+ </div>
+ </section>
+ </div>
+ <div class="doc-examples">
+ <h5>Response Content-Types:
+ <span>application/json</span>
+ </h5>
+ <section>
+ <h5>Response Example
+ <span>(200 OK)</span>
+ </h5>
+ <!-- <div class="hljs"> --><pre><code class="hljs lang-json">{
+ <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"publishedAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"category"</span>: {
+ <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
+ },
+ <span class="hljs-attr">"licence"</span>: {
+ <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
+ },
+ <span class="hljs-attr">"language"</span>: {
+ <span class="hljs-attr">"id"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
+ },
+ <span class="hljs-attr">"privacy"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"description"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"duration"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"isLocal"</span>: <span class="hljs-string">"boolean"</span>,
+ <span class="hljs-attr">"name"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"thumbnailPath"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"previewPath"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"embedPath"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"views"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"likes"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"dislikes"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"nsfw"</span>: <span class="hljs-string">"boolean"</span>,
+ <span class="hljs-attr">"account"</span>: {
+ <span class="hljs-attr">"name"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"displayName"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"url"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"host"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"avatar"</span>: {
+ <span class="hljs-attr">"path"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>
+ }
+ }
+}
</code></pre>
<!-- </div> -->
</section>
<!-- </div> -->
<!-- </section> -->
<h2 class="operation-title">
- <span class="operation-name">
- <span class="operation-name">GET</span>
- <span class="operation-path">/accounts</span>
- </span>
+ <span class="operation-summary">Get all accounts</span>
</h2>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-operation-path">
+ <span class="operation-method">GET</span>
+ <span class="operation-path">/accounts</span>
+ </section>
+ </div>
+ </div>
<div class="doc-row">
<div class="doc-copy"> </div>
<div class="doc-examples"></div>
<p>successful operation</p>
</div>
</div>
+ <div class="prop-row prop-inner">
+ <div class="prop-name">type</div>
+ <div class="prop-value">
+ <span class="json-property-type">
+ <span class="json-schema-ref-array">
+ <a class="json-schema-ref" href="#/definitions/Account">Account</a>
+ </span>
+ </span>
+ <span class="json-property-range" title="Value limits"></span>
+ </div>
+ </div>
</section>
</div>
<div class="doc-examples">
<h5>Response Content-Types:
- <span>application/json</span>
+ <span>application/jsonhttps://peertube.cpy.re/api/v1</span>
</h5>
<section>
<h5>Response Example
</div>
</div>
<h1 id="tag-Config" class="swagger-summary-tag" data-traverse-target="tag-Config">Config</h1>
+ <div class="tag-description doc-row">
+ <div class="doc-copy">
+ <p>Each server exposes public information regarding supported videos and options.</p>
+ </div>
+ </div>
<div id="operation--config-get" class="operation panel" data-traverse-target="operation--config-get">
<!-- <section class="operation-tags row"> -->
<!-- <div class="doc-copy"> -->
<!-- </div> -->
<!-- </section> -->
<h2 class="operation-title">
- <span class="operation-name">
- <span class="operation-name">GET</span>
- <span class="operation-path">/config</span>
- </span>
+ <span class="operation-summary">Get the configuration of the server</span>
</h2>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-operation-path">
+ <span class="operation-method">GET</span>
+ <span class="operation-path">/config</span>
+ </section>
+ </div>
+ </div>
<div class="doc-row">
<div class="doc-copy"> </div>
<div class="doc-examples"></div>
</div>
</div>
</div>
- <h1 id="tag-Job" class="swagger-summary-tag" data-traverse-target="tag-Job">Job</h1>
- <div id="operation--jobs-get" class="operation panel" data-traverse-target="operation--jobs-get">
+ <h1 id="tag-Feeds" class="swagger-summary-tag" data-traverse-target="tag-Feeds">Feeds</h1>
+ <div class="tag-description doc-row">
+ <div class="doc-copy">
+ <p>Feeds of videos and feeds of comments allow to see updates and get them in an aggregator or script of your choice.</p>
+ </div>
+ </div>
+ <div id="operation--feeds-videos.-format--get" class="operation panel" data-traverse-target="operation--feeds-videos.-format--get">
<!-- <section class="operation-tags row"> -->
<!-- <div class="doc-copy"> -->
<div class="operation-tags">
- <a class="label" href="#tag-Job">Job</a>
+ <a class="label" href="#tag-Feeds">Feeds</a>
<!---->
</div>
<!-- </div> -->
<!-- </section> -->
<h2 class="operation-title">
- <span class="operation-name">
- <span class="operation-name">GET</span>
- <span class="operation-path">/jobs</span>
- </span>
+ <span class="operation-summary">Get the feed of videos for the server, with optional filter by account name or id</span>
</h2>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-operation-path">
+ <span class="operation-method">GET</span>
+ <span class="operation-path">/feeds/videos.{format}</span>
+ </section>
+ </div>
+ </div>
<div class="doc-row">
<div class="doc-copy">
<section class="swagger-request-params">
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">state</div>
+ <div class="prop-title">format:
+ <span class="prop-type">
+ <span class="json-property-type">string</span>
+ <span class="json-property-enum" title="Possible values">
+ <span class="json-property-enum-item json-property-enum-default-value">xml</span>,
+ <span class="json-property-enum-item">atom</span>,
+ <span class="json-property-enum-item">json</span>
+ </span>
+ <span class="json-property-range" title="Value limits"></span>
+ <span class="json-property-default-value" title="Default value">xml</span>
+ </span>
+ </div>
<span class="json-property-required"></span>
+ <div class="prop-subtitle"> in path </div>
</div>
<div class="prop-value">
- <p>The id of the account</p>
+ <p>The format expected (xml defaults to RSS 2.0, atom to ATOM 1.0 and json to JSON FEED 1.0</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
+ <div class="prop-row prop-group">
+ <div class="prop-name">
+ <div class="prop-title">accountId:
+ <span class="prop-type">
+ <span class="json-property-type">number</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in query </div>
+ </div>
<div class="prop-value">
- <span class="json-property-type">string</span>
- <span class="json-property-range" title="Value limits"></span>
+ <p>The id of the local account to filter to (beware, users IDs and not actors IDs which will return empty feeds</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">path</div>
- </div>
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">start</div>
+ <div class="prop-title">accountName:
+ <span class="prop-type">
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in query </div>
</div>
<div class="prop-value">
- <p>starting page</p>
+ <p>The name of the local account to filter to</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
+ </section>
+ </div>
+ <div class="doc-examples"></div>
+ </div>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-responses">
+ <div class="prop-row prop-group">
+ <div class="prop-name">
+ <div class="prop-title">200 OK</div>
+ </div>
<div class="prop-value">
- <span class="json-property-type">number</span>
- <span class="json-property-range" title="Value limits"></span>
+ <p>successful operation</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">query</div>
- </div>
+ </section>
+ </div>
+ <div class="doc-examples">
+ <h5>Response Content-Types:
+ <span>application/atom+xml, application/rss+xml, application/json</span>
+ </h5>
+ </div>
+ </div>
+ </div>
+ <h1 id="tag-Job" class="swagger-summary-tag" data-traverse-target="tag-Job">Job</h1>
+ <div class="tag-description doc-row">
+ <div class="doc-copy">
+ <p>Jobs are long-running tasks enqueued and processed by the instance itself. No additional worker registration is currently available.</p>
+ </div>
+ </div>
+ <div id="operation--jobs-get" class="operation panel" data-traverse-target="operation--jobs-get">
+ <!-- <section class="operation-tags row"> -->
+ <!-- <div class="doc-copy"> -->
+ <div class="operation-tags">
+ <a class="label" href="#tag-Job">Job</a>
+ <!---->
+ </div>
+ <!-- </div> -->
+ <!-- </section> -->
+ <h2 class="operation-title">
+ <span class="operation-summary">Get list of jobs</span>
+ </h2>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-operation-path">
+ <span class="operation-method">GET</span>
+ <span class="operation-path">/jobs</span>
+ </section>
+ </div>
+ </div>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-request-params">
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">count</div>
+ <div class="prop-title">state:
+ <span class="prop-type">
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <span class="json-property-required"></span>
+ <div class="prop-subtitle"> in path </div>
</div>
<div class="prop-value">
- <p class="no-description">(no description)</p>
+ <p>The state of the job</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
+ <div class="prop-row prop-group">
+ <div class="prop-name">
+ <div class="prop-title">start:
+ <span class="prop-type">
+ <span class="json-property-type">number</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in query </div>
+ </div>
<div class="prop-value">
- <span class="json-property-type">number</span>
- <span class="json-property-range" title="Value limits"></span>
+ <p>Offset</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">query</div>
- </div>
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">sort</div>
+ <div class="prop-title">count:
+ <span class="prop-type">
+ <span class="json-property-type">number</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in query </div>
</div>
<div class="prop-value">
- <p>sorting</p>
+ <p>Number of items</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
+ <div class="prop-row prop-group">
+ <div class="prop-name">
+ <div class="prop-title">sort:
+ <span class="prop-type">
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in query </div>
+ </div>
<div class="prop-value">
- <span class="json-property-type">number</span>
- <span class="json-property-range" title="Value limits"></span>
+ <p>Sort column (-createdAt for example)</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">query</div>
- </div>
</section>
</div>
<div class="doc-examples"></div>
<p>successful operation</p>
</div>
</div>
+ <div class="prop-row prop-inner">
+ <div class="prop-name">type</div>
+ <div class="prop-value">
+ <span class="json-property-type">
+ <span class="json-schema-ref-array">
+ <a class="json-schema-ref" href="#/definitions/Job">Job</a>
+ </span>
+ </span>
+ <span class="json-property-range" title="Value limits"></span>
+ </div>
+ </div>
</section>
</div>
<div class="doc-examples">
</section>
</div>
</div>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-request-security">
+ <table class="table">
+ <thead>
+ <tr>
+ <th class="swagger-request-security-schema"></th>
+ <th class="swagger-request-security-scopes"></th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>
+ <a href="#security-definition-OAuth2">OAuth2</a>
+ </td>
+ <td>
+ <a href="#security-definition-scope-admin">admin</a>
+ </td>
+ </tr>
+ </tbody>
+ </table>
+ </section>
+ </div>
+ </div>
</div>
<h1 id="tag-ServerFollowing" class="swagger-summary-tag" data-traverse-target="tag-ServerFollowing">ServerFollowing</h1>
+ <div class="tag-description doc-row">
+ <div class="doc-copy">
+ <p>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 information across its social graph by posting activities to actors' inbox endpoints.</p>
+ </div>
+ </div>
<div id="operation--server-following--host--delete" class="operation panel" data-traverse-target="operation--server-following--host--delete">
<!-- <section class="operation-tags row"> -->
<!-- <div class="doc-copy"> -->
<!-- </div> -->
<!-- </section> -->
<h2 class="operation-title">
- <span class="operation-name">
- <span class="operation-name">DELETE</span>
- <span class="operation-path">/server/following/{host}</span>
- </span>
+ <span class="operation-summary">Unfollow a server by hostname</span>
</h2>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-operation-path">
+ <span class="operation-method">DELETE</span>
+ <span class="operation-path">/server/following/{host}</span>
+ </section>
+ </div>
+ </div>
<div class="doc-row">
<div class="doc-copy">
<section class="swagger-request-params">
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">host</div>
+ <div class="prop-title">host:
+ <span class="prop-type">
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
<span class="json-property-required"></span>
+ <div class="prop-subtitle"> in path </div>
</div>
<div class="prop-value">
<p>The host to unfollow </p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
- <div class="prop-value">
- <span class="json-property-type">string</span>
- <span class="json-property-range" title="Value limits"></span>
- </div>
- </div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">path</div>
- </div>
</section>
</div>
<div class="doc-examples"></div>
</h5>
</div>
</div>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-request-security">
+ <table class="table">
+ <thead>
+ <tr>
+ <th class="swagger-request-security-schema"></th>
+ <th class="swagger-request-security-scopes"></th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>
+ <a href="#security-definition-OAuth2">OAuth2</a>
+ </td>
+ <td>
+ <a href="#security-definition-scope-admin">admin</a>
+ </td>
+ </tr>
+ </tbody>
+ </table>
+ </section>
+ </div>
+ </div>
</div>
<div id="operation--server-followers-get" class="operation panel" data-traverse-target="operation--server-followers-get">
<!-- <section class="operation-tags row"> -->
<!-- </div> -->
<!-- </section> -->
<h2 class="operation-title">
- <span class="operation-name">
- <span class="operation-name">GET</span>
- <span class="operation-path">/server/followers</span>
- </span>
+ <span class="operation-summary">Get followers of the server</span>
</h2>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-operation-path">
+ <span class="operation-method">GET</span>
+ <span class="operation-path">/server/followers</span>
+ </section>
+ </div>
+ </div>
<div class="doc-row">
<div class="doc-copy">
<section class="swagger-request-params">
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">start</div>
- </div>
- <div class="prop-value">
- <p>starting page</p>
+ <div class="prop-title">start:
+ <span class="prop-type">
+ <span class="json-property-type">number</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in query </div>
</div>
- </div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
<div class="prop-value">
- <span class="json-property-type">number</span>
- <span class="json-property-range" title="Value limits"></span>
+ <p>Offset</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">query</div>
- </div>
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">stop</div>
- </div>
- <div class="prop-value">
- <p>stopping page</p>
+ <div class="prop-title">count:
+ <span class="prop-type">
+ <span class="json-property-type">number</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in query </div>
</div>
- </div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
<div class="prop-value">
- <span class="json-property-type">number</span>
- <span class="json-property-range" title="Value limits"></span>
+ <p>Number of items</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">query</div>
- </div>
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">sort</div>
- </div>
- <div class="prop-value">
- <p>sorting</p>
+ <div class="prop-title">sort:
+ <span class="prop-type">
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in query </div>
</div>
- </div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
<div class="prop-value">
- <span class="json-property-type">number</span>
- <span class="json-property-range" title="Value limits"></span>
+ <p>Sort column (-createdAt for example)</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">query</div>
- </div>
</section>
</div>
<div class="doc-examples"></div>
<p>successful operation</p>
</div>
</div>
+ <div class="prop-row prop-inner">
+ <div class="prop-name">type</div>
+ <div class="prop-value">
+ <span class="json-property-type">
+ <span class="json-schema-ref-array">
+ <a class="json-schema-ref" href="#/definitions/Follow">Follow</a>
+ </span>
+ </span>
+ <span class="json-property-range" title="Value limits"></span>
+ </div>
+ </div>
</section>
</div>
<div class="doc-examples">
<!-- </div> -->
<!-- </section> -->
<h2 class="operation-title">
- <span class="operation-name">
- <span class="operation-name">GET</span>
- <span class="operation-path">/server/following</span>
- </span>
+ <span class="operation-summary">Get servers followed by the server</span>
</h2>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-operation-path">
+ <span class="operation-method">GET</span>
+ <span class="operation-path">/server/following</span>
+ </section>
+ </div>
+ </div>
<div class="doc-row">
<div class="doc-copy">
<section class="swagger-request-params">
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">start</div>
- </div>
- <div class="prop-value">
- <p>starting page</p>
+ <div class="prop-title">start:
+ <span class="prop-type">
+ <span class="json-property-type">number</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in query </div>
</div>
- </div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
<div class="prop-value">
- <span class="json-property-type">number</span>
- <span class="json-property-range" title="Value limits"></span>
+ <p>Offset</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">query</div>
- </div>
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">stop</div>
- </div>
- <div class="prop-value">
- <p>stopping page</p>
+ <div class="prop-title">count:
+ <span class="prop-type">
+ <span class="json-property-type">number</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in query </div>
</div>
- </div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
<div class="prop-value">
- <span class="json-property-type">number</span>
- <span class="json-property-range" title="Value limits"></span>
+ <p>Number of items</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">query</div>
- </div>
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">sort</div>
- </div>
- <div class="prop-value">
- <p>sorting</p>
+ <div class="prop-title">sort:
+ <span class="prop-type">
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in query </div>
</div>
- </div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
<div class="prop-value">
- <span class="json-property-type">number</span>
- <span class="json-property-range" title="Value limits"></span>
+ <p>Sort column (-createdAt for example)</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">query</div>
- </div>
</section>
</div>
<div class="doc-examples"></div>
<p>successful operation</p>
</div>
</div>
+ <div class="prop-row prop-inner">
+ <div class="prop-name">type</div>
+ <div class="prop-value">
+ <span class="json-property-type">
+ <span class="json-schema-ref-array">
+ <a class="json-schema-ref" href="#/definitions/Follow">Follow</a>
+ </span>
+ </span>
+ <span class="json-property-range" title="Value limits"></span>
+ </div>
+ </div>
</section>
</div>
<div class="doc-examples">
<!-- </div> -->
<!-- </section> -->
<h2 class="operation-title">
- <span class="operation-name">
- <span class="operation-name">POST</span>
- <span class="operation-path">/server/following</span>
- </span>
+ <span class="operation-summary">Follow a server</span>
</h2>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-operation-path">
+ <span class="operation-method">POST</span>
+ <span class="operation-path">/server/following</span>
+ </section>
+ </div>
+ </div>
<div class="doc-row">
<div class="doc-copy">
<section class="swagger-request-body">
</div>
</div>
<div class="prop-value columns small-6">
- <!-- <div class="swagger-request-description"> -->undefined
+ <!-- <div class="swagger-request-description"> -->
+ <p>undefined</p>
<!-- </div> -->
</div>
</div>
<div class="prop-title">204 No Content</div>
</div>
<div class="prop-value">
- <p>successful operation</p>
+ <p>Successful operation</p>
</div>
</div>
</section>
</h5>
</div>
</div>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-request-security">
+ <table class="table">
+ <thead>
+ <tr>
+ <th class="swagger-request-security-schema"></th>
+ <th class="swagger-request-security-scopes"></th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>
+ <a href="#security-definition-OAuth2">OAuth2</a>
+ </td>
+ <td>
+ <a href="#security-definition-scope-admin">admin</a>
+ </td>
+ </tr>
+ </tbody>
+ </table>
+ </section>
+ </div>
+ </div>
</div>
- <h1 id="tag-User" class="swagger-summary-tag" data-traverse-target="tag-User">User</h1>
- <div id="operation--users-post" class="operation panel" data-traverse-target="operation--users-post">
+ <h1 id="tag-VideoAbuse" class="swagger-summary-tag" data-traverse-target="tag-VideoAbuse">VideoAbuse</h1>
+ <div class="tag-description doc-row">
+ <div class="doc-copy">
+ <p>Video abuses deal with reports of local or remote videos alike.</p>
+ </div>
+ </div>
+ <div id="operation--videos-abuse-get" class="operation panel" data-traverse-target="operation--videos-abuse-get">
<!-- <section class="operation-tags row"> -->
<!-- <div class="doc-copy"> -->
<div class="operation-tags">
- <a class="label" href="#tag-User">User</a>
+ <a class="label" href="#tag-VideoAbuse">VideoAbuse</a>
<!---->
</div>
<!-- </div> -->
<!-- </section> -->
<h2 class="operation-title">
- <span class="operation-name">
- <span class="operation-name">POST</span>
- <span class="operation-path">/users</span>
- </span>
+ <span class="operation-summary">Get list of reported video abuses</span>
</h2>
<div class="doc-row">
<div class="doc-copy">
- <section class="swagger-request-body">
- <div class="prop-row">
- <div class="prop-name">
- <div class="swagger-request-model">
- <span class="">
- <a class="json-schema-ref" href="#/definitions/AddUser">AddUser</a>
- </span>
- </div>
- </div>
- <div class="prop-value columns small-6">
- <!-- <div class="swagger-request-description"> -->undefined
- <!-- </div> -->
- </div>
- </div>
- </section>
- </div>
- <div class="doc-examples">
- <section>
- <h5>Request Content-Types:
- <span>application/json</span>
- </h5>
- <h5>Request Example</h5>
- <!-- <div class="hljs"> --><pre><code class="hljs lang-json">{
- <span class="hljs-attr">"username"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"password"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"email"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"videoQuota"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"role"</span>: <span class="hljs-string">"string"</span>
-}
-</code></pre>
- <!-- </div> -->
+ <section class="swagger-operation-path">
+ <span class="operation-method">GET</span>
+ <span class="operation-path">/videos/abuse</span>
</section>
</div>
</div>
<div class="doc-row">
<div class="doc-copy">
- <section class="swagger-responses">
+ <section class="swagger-request-params">
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">200 OK</div>
- <div class="prop-ref">
- <span class="">
- <a class="json-schema-ref" href="#/definitions/AddUserResponse">AddUserResponse</a>
+ <div class="prop-title">start:
+ <span class="prop-type">
+ <span class="json-property-type">number</span>
+ <span class="json-property-range" title="Value limits"></span>
</span>
</div>
- <!-- <span class="swagger-global"></span> <span class="json-schema-reference"><a href=""></a></span> -->
- </div>
- <div class="prop-value">
- <p>successful operation</p>
- </div>
- </div>
- </section>
- </div>
- <div class="doc-examples">
- <h5>Response Content-Types:
- <span>application/json</span>
- </h5>
- <section>
- <h5>Response Example
- <span>(200 OK)</span>
- </h5>
- <!-- <div class="hljs"> --><pre><code class="hljs lang-json">{
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>
-}
-</code></pre>
- <!-- </div> -->
- </section>
- </div>
- </div>
- </div>
- <div id="operation--users-get" class="operation panel" data-traverse-target="operation--users-get">
- <!-- <section class="operation-tags row"> -->
- <!-- <div class="doc-copy"> -->
- <div class="operation-tags">
- <a class="label" href="#tag-User">User</a>
- <!---->
- </div>
- <!-- </div> -->
- <!-- </section> -->
- <h2 class="operation-title">
- <span class="operation-name">
- <span class="operation-name">GET</span>
- <span class="operation-path">/users</span>
- </span>
- </h2>
- <div class="doc-row">
- <div class="doc-copy">
- <section class="swagger-request-params">
- <div class="prop-row prop-group">
- <div class="prop-name">
- <div class="prop-title">start</div>
- </div>
- <div class="prop-value">
- <p>starting page</p>
+ <div class="prop-subtitle"> in query </div>
</div>
- </div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
<div class="prop-value">
- <span class="json-property-type">number</span>
- <span class="json-property-range" title="Value limits"></span>
+ <p>Offset</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">query</div>
- </div>
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">stop</div>
- </div>
- <div class="prop-value">
- <p>stopping page</p>
+ <div class="prop-title">count:
+ <span class="prop-type">
+ <span class="json-property-type">number</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in query </div>
</div>
- </div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
<div class="prop-value">
- <span class="json-property-type">number</span>
- <span class="json-property-range" title="Value limits"></span>
+ <p>Number of items</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">query</div>
- </div>
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">sort</div>
- </div>
- <div class="prop-value">
- <p>sorting</p>
+ <div class="prop-title">sort:
+ <span class="prop-type">
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in query </div>
</div>
- </div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
<div class="prop-value">
- <span class="json-property-type">number</span>
- <span class="json-property-range" title="Value limits"></span>
+ <p>Sort column (-createdAt for example)</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">query</div>
- </div>
</section>
</div>
<div class="doc-examples"></div>
<div class="prop-title">200 OK</div>
<div class="prop-ref">
<span class="json-schema-ref-array">
- <a class="json-schema-ref" href="#/definitions/User">User</a>
+ <a class="json-schema-ref" href="#/definitions/VideoAbuse">VideoAbuse</a>
</span>
</div>
<!-- <span class="swagger-global"></span> <span class="json-schema-reference"><a href=""></a></span> -->
<p>successful operation</p>
</div>
</div>
+ <div class="prop-row prop-inner">
+ <div class="prop-name">type</div>
+ <div class="prop-value">
+ <span class="json-property-type">
+ <span class="json-schema-ref-array">
+ <a class="json-schema-ref" href="#/definitions/VideoAbuse">VideoAbuse</a>
+ </span>
+ </span>
+ <span class="json-property-range" title="Value limits"></span>
+ </div>
+ </div>
</section>
</div>
<div class="doc-examples">
<!-- <div class="hljs"> --><pre><code class="hljs lang-json">[
{
<span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"username"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"email"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"displayNSFW"</span>: <span class="hljs-string">"boolean"</span>,
- <span class="hljs-attr">"autoPlayVideo"</span>: <span class="hljs-string">"boolean"</span>,
- <span class="hljs-attr">"role"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"videoQuota"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"account"</span>: {
+ <span class="hljs-attr">"reason"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"reporterAccount"</span>: {
<span class="hljs-attr">"displayName"</span>: <span class="hljs-string">"string"</span>,
<span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
<span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>,
<span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>
}
},
- <span class="hljs-attr">"videoChannels"</span>: [
- {
- <span class="hljs-attr">"displayName"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"description"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"isLocal"</span>: <span class="hljs-string">"boolean"</span>,
- <span class="hljs-attr">"owner"</span>: {
- <span class="hljs-attr">"name"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>
- },
- <span class="hljs-attr">"videos"</span>: [
- {
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"category"</span>: {
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
- },
- <span class="hljs-attr">"licence"</span>: {
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
- },
- <span class="hljs-attr">"language"</span>: {
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
- },
- <span class="hljs-attr">"description"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"duration"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"isLocal"</span>: <span class="hljs-string">"boolean"</span>,
- <span class="hljs-attr">"name"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"thumbnailPath"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"previewPath"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"embedPath"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"views"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"likes"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"dislikes"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"nsfw"</span>: <span class="hljs-string">"boolean"</span>
- }
- ]
- }
- ]
+ <span class="hljs-attr">"video"</span>: {
+ <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"name"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"url"</span>: <span class="hljs-string">"string"</span>
+ },
+ <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>
}
]
</code></pre>
</section>
</div>
</div>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-request-security">
+ <table class="table">
+ <thead>
+ <tr>
+ <th class="swagger-request-security-schema"></th>
+ <th class="swagger-request-security-scopes"></th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>
+ <a href="#security-definition-OAuth2">OAuth2</a>
+ </td>
+ <td> </td>
+ </tr>
+ </tbody>
+ </table>
+ </section>
+ </div>
+ </div>
</div>
- <div id="operation--users--id--delete" class="operation panel" data-traverse-target="operation--users--id--delete">
+ <div id="operation--videos--id--abuse-post" class="operation panel" data-traverse-target="operation--videos--id--abuse-post">
<!-- <section class="operation-tags row"> -->
<!-- <div class="doc-copy"> -->
<div class="operation-tags">
- <a class="label" href="#tag-User">User</a>
+ <a class="label" href="#tag-VideoAbuse">VideoAbuse</a>
<!---->
</div>
<!-- </div> -->
<!-- </section> -->
<h2 class="operation-title">
- <span class="operation-name">
- <span class="operation-name">DELETE</span>
- <span class="operation-path">/users/{id}</span>
- </span>
+ <span class="operation-summary">Report an abuse, on a video by its id</span>
</h2>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-operation-path">
+ <span class="operation-method">POST</span>
+ <span class="operation-path">/videos/{id}/abuse</span>
+ </section>
+ </div>
+ </div>
<div class="doc-row">
<div class="doc-copy">
<section class="swagger-request-params">
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">id</div>
+ <div class="prop-title">id:
+ <span class="prop-type">
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
<span class="json-property-required"></span>
+ <div class="prop-subtitle"> in path </div>
</div>
<div class="prop-value">
- <p>The user id </p>
- </div>
- </div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
- <div class="prop-value">
- <span class="json-property-type">string</span>
- <span class="json-property-range" title="Value limits"></span>
+ <p>The video id or uuid</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">path</div>
- </div>
</section>
</div>
<div class="doc-examples"></div>
<div class="prop-title">204 No Content</div>
</div>
<div class="prop-value">
- <p>successful operation</p>
+ <p>Successful operation</p>
</div>
</div>
</section>
</h5>
</div>
</div>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-request-security">
+ <table class="table">
+ <thead>
+ <tr>
+ <th class="swagger-request-security-schema"></th>
+ <th class="swagger-request-security-scopes"></th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>
+ <a href="#security-definition-OAuth2">OAuth2</a>
+ </td>
+ <td> </td>
+ </tr>
+ </tbody>
+ </table>
+ </section>
+ </div>
+ </div>
</div>
- <div id="operation--users--id--get" class="operation panel" data-traverse-target="operation--users--id--get">
+ <h1 id="tag-Video" class="swagger-summary-tag" data-traverse-target="tag-Video">Video</h1>
+ <div class="tag-description doc-row">
+ <div class="doc-copy">
+ <p>Operations dealing with listing, uploading, fetching or modifying videos.</p>
+ </div>
+ </div>
+ <div id="operation--accounts--name--videos-get" class="operation panel" data-traverse-target="operation--accounts--name--videos-get">
<!-- <section class="operation-tags row"> -->
<!-- <div class="doc-copy"> -->
<div class="operation-tags">
- <a class="label" href="#tag-User">User</a>
+ <a class="label" href="#tag-Accounts">Accounts</a>
+ <!--, -->
+ <a class="label" href="#tag-Video">Video</a>
<!---->
</div>
<!-- </div> -->
<!-- </section> -->
<h2 class="operation-title">
- <span class="operation-name">
- <span class="operation-name">GET</span>
- <span class="operation-path">/users/{id}</span>
- </span>
+ <span class="operation-summary">Get videos for an account, provided the name of that account</span>
</h2>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-operation-path">
+ <span class="operation-method">GET</span>
+ <span class="operation-path">/accounts/{name}/videos</span>
+ </section>
+ </div>
+ </div>
<div class="doc-row">
<div class="doc-copy">
<section class="swagger-request-params">
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">id</div>
+ <div class="prop-title">name:
+ <span class="prop-type">
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
<span class="json-property-required"></span>
+ <div class="prop-subtitle"> in path </div>
</div>
<div class="prop-value">
- <p>The user id </p>
- </div>
- </div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
- <div class="prop-value">
- <span class="json-property-type">string</span>
- <span class="json-property-range" title="Value limits"></span>
+ <p>The name of the account (chocobozzz or
+ <a href="mailto:chocobozzz@peertube.cpy.re">chocobozzz@peertube.cpy.re</a> for example)</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">path</div>
- </div>
</section>
</div>
<div class="doc-examples"></div>
<div class="prop-title">200 OK</div>
<div class="prop-ref">
<span class="">
- <a class="json-schema-ref" href="#/definitions/User">User</a>
+ <a class="json-schema-ref" href="#/definitions/Video">Video</a>
</span>
</div>
<!-- <span class="swagger-global"></span> <span class="json-schema-reference"><a href=""></a></span> -->
</h5>
<!-- <div class="hljs"> --><pre><code class="hljs lang-json">{
<span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"username"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"email"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"displayNSFW"</span>: <span class="hljs-string">"boolean"</span>,
- <span class="hljs-attr">"autoPlayVideo"</span>: <span class="hljs-string">"boolean"</span>,
- <span class="hljs-attr">"role"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"videoQuota"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>,
<span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"publishedAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"category"</span>: {
+ <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
+ },
+ <span class="hljs-attr">"licence"</span>: {
+ <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
+ },
+ <span class="hljs-attr">"language"</span>: {
+ <span class="hljs-attr">"id"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
+ },
+ <span class="hljs-attr">"privacy"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"description"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"duration"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"isLocal"</span>: <span class="hljs-string">"boolean"</span>,
+ <span class="hljs-attr">"name"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"thumbnailPath"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"previewPath"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"embedPath"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"views"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"likes"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"dislikes"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"nsfw"</span>: <span class="hljs-string">"boolean"</span>,
<span class="hljs-attr">"account"</span>: {
+ <span class="hljs-attr">"name"</span>: <span class="hljs-string">"string"</span>,
<span class="hljs-attr">"displayName"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>,
<span class="hljs-attr">"url"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"name"</span>: <span class="hljs-string">"string"</span>,
<span class="hljs-attr">"host"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"followingCount"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"followersCount"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>,
<span class="hljs-attr">"avatar"</span>: {
<span class="hljs-attr">"path"</span>: <span class="hljs-string">"string"</span>,
<span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
<span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>
}
- },
- <span class="hljs-attr">"videoChannels"</span>: [
- {
- <span class="hljs-attr">"displayName"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"description"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"isLocal"</span>: <span class="hljs-string">"boolean"</span>,
- <span class="hljs-attr">"owner"</span>: {
- <span class="hljs-attr">"name"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>
- },
- <span class="hljs-attr">"videos"</span>: [
- {
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"category"</span>: {
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
- },
- <span class="hljs-attr">"licence"</span>: {
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
- },
- <span class="hljs-attr">"language"</span>: {
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
- },
- <span class="hljs-attr">"description"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"duration"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"isLocal"</span>: <span class="hljs-string">"boolean"</span>,
- <span class="hljs-attr">"name"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"thumbnailPath"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"previewPath"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"embedPath"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"views"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"likes"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"dislikes"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"nsfw"</span>: <span class="hljs-string">"boolean"</span>
- }
- ]
- }
- ]
+ }
}
</code></pre>
<!-- </div> -->
</div>
</div>
</div>
- <div id="operation--users--id--put" class="operation panel" data-traverse-target="operation--users--id--put">
+ <div id="operation--videos-get" class="operation panel" data-traverse-target="operation--videos-get">
<!-- <section class="operation-tags row"> -->
<!-- <div class="doc-copy"> -->
<div class="operation-tags">
- <a class="label" href="#tag-User">User</a>
+ <a class="label" href="#tag-Video">Video</a>
<!---->
</div>
<!-- </div> -->
<!-- </section> -->
<h2 class="operation-title">
- <span class="operation-name">
- <span class="operation-name">PUT</span>
- <span class="operation-path">/users/{id}</span>
- </span>
+ <span class="operation-summary">Get list of videos</span>
</h2>
<div class="doc-row">
<div class="doc-copy">
- <section class="swagger-request-body">
- <div class="prop-row">
+ <section class="swagger-operation-path">
+ <span class="operation-method">GET</span>
+ <span class="operation-path">/videos</span>
+ </section>
+ </div>
+ </div>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-request-params">
+ <div class="prop-row prop-group">
<div class="prop-name">
- <div class="swagger-request-model">
- <span class="">
- <a class="json-schema-ref" href="#/definitions/UpdateUser">UpdateUser</a>
+ <div class="prop-title">category:
+ <span class="prop-type">
+ <span class="json-property-type">number</span>
+ <span class="json-property-range" title="Value limits"></span>
</span>
</div>
+ <div class="prop-subtitle"> in query </div>
</div>
- <div class="prop-value columns small-6">
- <!-- <div class="swagger-request-description"> -->undefined
- <!-- </div> -->
+ <div class="prop-value">
+ <p>category id of the video</p>
</div>
</div>
- </section>
- <section class="swagger-request-params">
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">id</div>
- <span class="json-property-required"></span>
+ <div class="prop-title">start:
+ <span class="prop-type">
+ <span class="json-property-type">number</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in query </div>
</div>
<div class="prop-value">
- <p>The user id </p>
+ <p>Offset</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
+ <div class="prop-row prop-group">
+ <div class="prop-name">
+ <div class="prop-title">count:
+ <span class="prop-type">
+ <span class="json-property-type">number</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in query </div>
+ </div>
<div class="prop-value">
- <span class="json-property-type">string</span>
- <span class="json-property-range" title="Value limits"></span>
+ <p>Number of items</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">path</div>
- </div>
- </section>
- </div>
- <div class="doc-examples">
- <section>
- <h5>Request Content-Types:
- <span>application/json</span>
- </h5>
- <h5>Request Example</h5>
- <!-- <div class="hljs"> --><pre><code class="hljs lang-json">{
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"email"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"videoQuota"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"role"</span>: <span class="hljs-string">"string"</span>
-}
-</code></pre>
- <!-- </div> -->
- </section>
- </div>
- </div>
- <div class="doc-row">
- <div class="doc-copy">
- <section class="swagger-responses">
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">204 No Content</div>
+ <div class="prop-title">sort:
+ <span class="prop-type">
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in query </div>
</div>
<div class="prop-value">
- <p>successful operation</p>
+ <p>Sort column (-createdAt for example)</p>
</div>
</div>
</section>
</div>
- <div class="doc-examples">
- <h5>Response Content-Types:
- <span>application/json</span>
- </h5>
- </div>
- </div>
- </div>
- <div id="operation--users-me-get" class="operation panel" data-traverse-target="operation--users-me-get">
- <!-- <section class="operation-tags row"> -->
- <!-- <div class="doc-copy"> -->
- <div class="operation-tags">
- <a class="label" href="#tag-User">User</a>
- <!---->
- </div>
- <!-- </div> -->
- <!-- </section> -->
- <h2 class="operation-title">
- <span class="operation-name">
- <span class="operation-name">GET</span>
- <span class="operation-path">/users/me</span>
- </span>
- </h2>
- <div class="doc-row">
- <div class="doc-copy"> </div>
<div class="doc-examples"></div>
</div>
<div class="doc-row">
<div class="prop-title">200 OK</div>
<div class="prop-ref">
<span class="json-schema-ref-array">
- <a class="json-schema-ref" href="#/definitions/User">User</a>
+ <a class="json-schema-ref" href="#/definitions/Video">Video</a>
</span>
</div>
<!-- <span class="swagger-global"></span> <span class="json-schema-reference"><a href=""></a></span> -->
<p>successful operation</p>
</div>
</div>
+ <div class="prop-row prop-inner">
+ <div class="prop-name">type</div>
+ <div class="prop-value">
+ <span class="json-property-type">
+ <span class="json-schema-ref-array">
+ <a class="json-schema-ref" href="#/definitions/Video">Video</a>
+ </span>
+ </span>
+ <span class="json-property-range" title="Value limits"></span>
+ </div>
+ </div>
</section>
</div>
<div class="doc-examples">
<!-- <div class="hljs"> --><pre><code class="hljs lang-json">[
{
<span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"username"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"email"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"displayNSFW"</span>: <span class="hljs-string">"boolean"</span>,
- <span class="hljs-attr">"autoPlayVideo"</span>: <span class="hljs-string">"boolean"</span>,
- <span class="hljs-attr">"role"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"videoQuota"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>,
<span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"publishedAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"category"</span>: {
+ <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
+ },
+ <span class="hljs-attr">"licence"</span>: {
+ <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
+ },
+ <span class="hljs-attr">"language"</span>: {
+ <span class="hljs-attr">"id"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
+ },
+ <span class="hljs-attr">"privacy"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"description"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"duration"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"isLocal"</span>: <span class="hljs-string">"boolean"</span>,
+ <span class="hljs-attr">"name"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"thumbnailPath"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"previewPath"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"embedPath"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"views"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"likes"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"dislikes"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"nsfw"</span>: <span class="hljs-string">"boolean"</span>,
<span class="hljs-attr">"account"</span>: {
+ <span class="hljs-attr">"name"</span>: <span class="hljs-string">"string"</span>,
<span class="hljs-attr">"displayName"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>,
<span class="hljs-attr">"url"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"name"</span>: <span class="hljs-string">"string"</span>,
<span class="hljs-attr">"host"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"followingCount"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"followersCount"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>,
<span class="hljs-attr">"avatar"</span>: {
<span class="hljs-attr">"path"</span>: <span class="hljs-string">"string"</span>,
<span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
<span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>
}
- },
- <span class="hljs-attr">"videoChannels"</span>: [
- {
- <span class="hljs-attr">"displayName"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"description"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"isLocal"</span>: <span class="hljs-string">"boolean"</span>,
- <span class="hljs-attr">"owner"</span>: {
- <span class="hljs-attr">"name"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>
- },
- <span class="hljs-attr">"videos"</span>: [
- {
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"category"</span>: {
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
- },
- <span class="hljs-attr">"licence"</span>: {
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
- },
- <span class="hljs-attr">"language"</span>: {
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
- },
- <span class="hljs-attr">"description"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"duration"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"isLocal"</span>: <span class="hljs-string">"boolean"</span>,
- <span class="hljs-attr">"name"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"thumbnailPath"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"previewPath"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"embedPath"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"views"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"likes"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"dislikes"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"nsfw"</span>: <span class="hljs-string">"boolean"</span>
- }
- ]
- }
- ]
+ }
}
]
</code></pre>
</div>
</div>
</div>
- <div id="operation--users-me-put" class="operation panel" data-traverse-target="operation--users-me-put">
+ <div id="operation--videos-categories-get" class="operation panel" data-traverse-target="operation--videos-categories-get">
<!-- <section class="operation-tags row"> -->
<!-- <div class="doc-copy"> -->
<div class="operation-tags">
- <a class="label" href="#tag-User">User</a>
+ <a class="label" href="#tag-Video">Video</a>
<!---->
</div>
<!-- </div> -->
<!-- </section> -->
<h2 class="operation-title">
- <span class="operation-name">
- <span class="operation-name">PUT</span>
- <span class="operation-path">/users/me</span>
- </span>
+ <span class="operation-summary">Get list of video licences known by the server</span>
</h2>
<div class="doc-row">
<div class="doc-copy">
- <section class="swagger-request-body">
- <div class="prop-row">
- <div class="prop-name">
- <div class="swagger-request-model">
- <span class="">
- <a class="json-schema-ref" href="#/definitions/UpdateMe">UpdateMe</a>
- </span>
- </div>
- </div>
- <div class="prop-value columns small-6">
- <!-- <div class="swagger-request-description"> -->undefined
- <!-- </div> -->
- </div>
- </div>
- </section>
- </div>
- <div class="doc-examples">
- <section>
- <h5>Request Content-Types:
- <span>application/json</span>
- </h5>
- <h5>Request Example</h5>
- <!-- <div class="hljs"> --><pre><code class="hljs lang-json">{
- <span class="hljs-attr">"password"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"email"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"displayNSFW"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"autoPlayVideo"</span>: <span class="hljs-string">"string"</span>
-}
-</code></pre>
- <!-- </div> -->
+ <section class="swagger-operation-path">
+ <span class="operation-method">GET</span>
+ <span class="operation-path">/videos/categories</span>
</section>
</div>
</div>
+ <div class="doc-row">
+ <div class="doc-copy"> </div>
+ <div class="doc-examples"></div>
+ </div>
<div class="doc-row">
<div class="doc-copy">
<section class="swagger-responses">
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">204 No Content</div>
+ <div class="prop-title">200 OK</div>
+ <div class="prop-ref"></div>
+ <!-- <span class="swagger-global"></span> <span class="json-schema-reference"><a href=""></a></span> -->
</div>
<div class="prop-value">
<p>successful operation</p>
</div>
</div>
+ <div class="prop-row prop-inner">
+ <div class="prop-name">type</div>
+ <div class="prop-value">
+ <span class="json-property-type">string[]</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </div>
+ </div>
</section>
</div>
<div class="doc-examples">
<h5>Response Content-Types:
<span>application/json</span>
</h5>
+ <section>
+ <h5>Response Example
+ <span>(200 OK)</span>
+ </h5>
+ <!-- <div class="hljs"> --><pre><code class="hljs lang-json">[
+ <span class="hljs-string">"string"</span>
+]
+</code></pre>
+ <!-- </div> -->
+ </section>
</div>
</div>
</div>
- <div id="operation--users-me-video-quota-used-get" class="operation panel" data-traverse-target="operation--users-me-video-quota-used-get">
+ <div id="operation--videos-licences-get" class="operation panel" data-traverse-target="operation--videos-licences-get">
<!-- <section class="operation-tags row"> -->
<!-- <div class="doc-copy"> -->
<div class="operation-tags">
- <a class="label" href="#tag-User">User</a>
+ <a class="label" href="#tag-Video">Video</a>
<!---->
</div>
<!-- </div> -->
<!-- </section> -->
<h2 class="operation-title">
- <span class="operation-name">
- <span class="operation-name">GET</span>
- <span class="operation-path">/users/me/video-quota-used</span>
- </span>
+ <span class="operation-summary">Get list of video licences known by the server</span>
</h2>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-operation-path">
+ <span class="operation-method">GET</span>
+ <span class="operation-path">/videos/licences</span>
+ </section>
+ </div>
+ </div>
<div class="doc-row">
<div class="doc-copy"> </div>
<div class="doc-examples"></div>
<p>successful operation</p>
</div>
</div>
+ <div class="prop-row prop-inner">
+ <div class="prop-name">type</div>
+ <div class="prop-value">
+ <span class="json-property-type">string[]</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </div>
+ </div>
</section>
</div>
<div class="doc-examples">
<h5>Response Example
<span>(200 OK)</span>
</h5>
- <!-- <div class="hljs"> --><pre><code class="hljs lang-json"><span class="hljs-string">"number"</span>
+ <!-- <div class="hljs"> --><pre><code class="hljs lang-json">[
+ <span class="hljs-string">"string"</span>
+]
</code></pre>
<!-- </div> -->
</section>
</div>
</div>
</div>
- <div id="operation--users-me-videos--videoId--rating-get" class="operation panel" data-traverse-target="operation--users-me-videos--videoId--rating-get">
+ <div id="operation--videos-languages-get" class="operation panel" data-traverse-target="operation--videos-languages-get">
<!-- <section class="operation-tags row"> -->
<!-- <div class="doc-copy"> -->
<div class="operation-tags">
- <a class="label" href="#tag-User">User</a>
+ <a class="label" href="#tag-Video">Video</a>
<!---->
</div>
<!-- </div> -->
<!-- </section> -->
<h2 class="operation-title">
- <span class="operation-name">
- <span class="operation-name">GET</span>
- <span class="operation-path">/users/me/videos/{videoId}/rating</span>
- </span>
+ <span class="operation-summary">Get list of languages known by the server</span>
</h2>
<div class="doc-row">
<div class="doc-copy">
- <section class="swagger-request-params">
- <div class="prop-row prop-group">
- <div class="prop-name">
- <div class="prop-title">videoId</div>
- <span class="json-property-required"></span>
- </div>
- <div class="prop-value">
- <p>The video id </p>
- </div>
- </div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
- <div class="prop-value">
- <span class="json-property-type">string</span>
- <span class="json-property-range" title="Value limits"></span>
- </div>
- </div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">path</div>
- </div>
+ <section class="swagger-operation-path">
+ <span class="operation-method">GET</span>
+ <span class="operation-path">/videos/languages</span>
</section>
</div>
+ </div>
+ <div class="doc-row">
+ <div class="doc-copy"> </div>
<div class="doc-examples"></div>
</div>
<div class="doc-row">
<div class="prop-row prop-group">
<div class="prop-name">
<div class="prop-title">200 OK</div>
- <div class="prop-ref">
- <span class="">
- <a class="json-schema-ref" href="#/definitions/GetMeVideoRating">GetMeVideoRating</a>
- </span>
- </div>
+ <div class="prop-ref"></div>
<!-- <span class="swagger-global"></span> <span class="json-schema-reference"><a href=""></a></span> -->
</div>
<div class="prop-value">
<p>successful operation</p>
</div>
</div>
+ <div class="prop-row prop-inner">
+ <div class="prop-name">type</div>
+ <div class="prop-value">
+ <span class="json-property-type">string[]</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </div>
+ </div>
</section>
</div>
<div class="doc-examples">
<h5>Response Example
<span>(200 OK)</span>
</h5>
- <!-- <div class="hljs"> --><pre><code class="hljs lang-json">{
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"rating"</span>: <span class="hljs-string">"number"</span>
-}
+ <!-- <div class="hljs"> --><pre><code class="hljs lang-json">[
+ <span class="hljs-string">"string"</span>
+]
</code></pre>
<!-- </div> -->
</section>
</div>
</div>
</div>
- <div id="operation--users-me-videos-get" class="operation panel" data-traverse-target="operation--users-me-videos-get">
+ <div id="operation--videos-privacies-get" class="operation panel" data-traverse-target="operation--videos-privacies-get">
<!-- <section class="operation-tags row"> -->
<!-- <div class="doc-copy"> -->
<div class="operation-tags">
- <a class="label" href="#tag-User">User</a>
+ <a class="label" href="#tag-Video">Video</a>
<!---->
</div>
<!-- </div> -->
<!-- </section> -->
<h2 class="operation-title">
- <span class="operation-name">
- <span class="operation-name">GET</span>
- <span class="operation-path">/users/me/videos</span>
- </span>
+ <span class="operation-summary">Get list of privacy policies supported by the server</span>
</h2>
<div class="doc-row">
<div class="doc-copy">
- <section class="swagger-request-params">
- <div class="prop-row prop-group">
- <div class="prop-name">
- <div class="prop-title">start</div>
- </div>
- <div class="prop-value">
- <p>starting page</p>
- </div>
- </div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
- <div class="prop-value">
- <span class="json-property-type">number</span>
- <span class="json-property-range" title="Value limits"></span>
- </div>
- </div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">query</div>
- </div>
- <div class="prop-row prop-group">
- <div class="prop-name">
- <div class="prop-title">stop</div>
- </div>
- <div class="prop-value">
- <p>stopping page</p>
- </div>
- </div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
- <div class="prop-value">
- <span class="json-property-type">number</span>
- <span class="json-property-range" title="Value limits"></span>
- </div>
- </div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">query</div>
- </div>
- <div class="prop-row prop-group">
- <div class="prop-name">
- <div class="prop-title">sort</div>
- </div>
- <div class="prop-value">
- <p>sorting</p>
- </div>
- </div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
- <div class="prop-value">
- <span class="json-property-type">number</span>
- <span class="json-property-range" title="Value limits"></span>
- </div>
- </div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">query</div>
- </div>
+ <section class="swagger-operation-path">
+ <span class="operation-method">GET</span>
+ <span class="operation-path">/videos/privacies</span>
</section>
</div>
+ </div>
+ <div class="doc-row">
+ <div class="doc-copy"> </div>
<div class="doc-examples"></div>
</div>
<div class="doc-row">
<div class="prop-row prop-group">
<div class="prop-name">
<div class="prop-title">200 OK</div>
- <div class="prop-ref">
- <span class="json-schema-ref-array">
- <a class="json-schema-ref" href="#/definitions/Video">Video</a>
- </span>
- </div>
+ <div class="prop-ref"></div>
<!-- <span class="swagger-global"></span> <span class="json-schema-reference"><a href=""></a></span> -->
</div>
<div class="prop-value">
<p>successful operation</p>
</div>
</div>
+ <div class="prop-row prop-inner">
+ <div class="prop-name">type</div>
+ <div class="prop-value">
+ <span class="json-property-type">string[]</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </div>
+ </div>
</section>
</div>
<div class="doc-examples">
<span>(200 OK)</span>
</h5>
<!-- <div class="hljs"> --><pre><code class="hljs lang-json">[
- {
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"category"</span>: {
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
- },
- <span class="hljs-attr">"licence"</span>: {
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
- },
- <span class="hljs-attr">"language"</span>: {
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
- },
- <span class="hljs-attr">"description"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"duration"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"isLocal"</span>: <span class="hljs-string">"boolean"</span>,
- <span class="hljs-attr">"name"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"thumbnailPath"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"previewPath"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"embedPath"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"views"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"likes"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"dislikes"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"nsfw"</span>: <span class="hljs-string">"boolean"</span>
- }
+ <span class="hljs-string">"string"</span>
]
</code></pre>
<!-- </div> -->
</div>
</div>
</div>
- <div id="operation--users-register-post" class="operation panel" data-traverse-target="operation--users-register-post">
+ <div id="operation--videos--id--put" class="operation panel" data-traverse-target="operation--videos--id--put">
<!-- <section class="operation-tags row"> -->
<!-- <div class="doc-copy"> -->
<div class="operation-tags">
- <a class="label" href="#tag-User">User</a>
+ <a class="label" href="#tag-Video">Video</a>
<!---->
</div>
<!-- </div> -->
<!-- </section> -->
<h2 class="operation-title">
- <span class="operation-name">
- <span class="operation-name">POST</span>
- <span class="operation-path">/users/register</span>
- </span>
+ <span class="operation-summary">Update metadata for a video by its id</span>
</h2>
<div class="doc-row">
<div class="doc-copy">
- <section class="swagger-request-body">
- <div class="prop-row">
- <div class="prop-name">
- <div class="swagger-request-model">
- <span class="">
- <a class="json-schema-ref" href="#/definitions/RegisterUser">RegisterUser</a>
- </span>
- </div>
- </div>
- <div class="prop-value columns small-6">
- <!-- <div class="swagger-request-description"> -->undefined
- <!-- </div> -->
- </div>
- </div>
- </section>
- </div>
- <div class="doc-examples">
- <section>
- <h5>Request Content-Types:
- <span>application/json</span>
- </h5>
- <h5>Request Example</h5>
- <!-- <div class="hljs"> --><pre><code class="hljs lang-json">{
- <span class="hljs-attr">"username"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"password"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"email"</span>: <span class="hljs-string">"string"</span>
-}
-</code></pre>
- <!-- </div> -->
+ <section class="swagger-operation-path">
+ <span class="operation-method">PUT</span>
+ <span class="operation-path">/videos/{id}</span>
</section>
</div>
</div>
<div class="doc-row">
<div class="doc-copy">
- <section class="swagger-responses">
+ <section class="swagger-request-params">
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">204 No Content</div>
+ <div class="prop-title">id:
+ <span class="prop-type">
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <span class="json-property-required"></span>
+ <div class="prop-subtitle"> in path </div>
</div>
<div class="prop-value">
- <p>successful operation</p>
+ <p>The video id or uuid</p>
</div>
</div>
- </section>
- </div>
- <div class="doc-examples">
- <h5>Response Content-Types:
- <span>application/json</span>
- </h5>
- </div>
- </div>
- </div>
- <div id="operation--users-me-avatar-pick-post" class="operation panel" data-traverse-target="operation--users-me-avatar-pick-post">
- <!-- <section class="operation-tags row"> -->
- <!-- <div class="doc-copy"> -->
- <div class="operation-tags">
- <a class="label" href="#tag-User">User</a>
- <!---->
- </div>
- <!-- </div> -->
- <!-- </section> -->
- <h2 class="operation-title">
- <span class="operation-name">
- <span class="operation-name">POST</span>
- <span class="operation-path">/users/me/avatar/pick</span>
- </span>
- </h2>
- <div class="doc-row">
- <div class="doc-copy">
- <section class="swagger-request-params">
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">avatarfile</div>
- </div>
- <div class="prop-value">
- <p>The file to upload.</p>
+ <div class="prop-title">thumbnailfile:
+ <span class="prop-type">
+ <span class="json-property-type">file</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in formData </div>
</div>
- </div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
<div class="prop-value">
- <span class="json-property-type">file</span>
- <span class="json-property-range" title="Value limits"></span>
+ <p>Video thumbnail file</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">formData</div>
- </div>
- </section>
- </div>
- <div class="doc-examples"></div>
- </div>
- <div class="doc-row">
- <div class="doc-copy">
- <section class="swagger-responses">
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">200 OK</div>
- <div class="prop-ref">
- <span class="">
- <a class="json-schema-ref" href="#/definitions/Avatar">Avatar</a>
+ <div class="prop-title">previewfile:
+ <span class="prop-type">
+ <span class="json-property-type">file</span>
+ <span class="json-property-range" title="Value limits"></span>
</span>
</div>
- <!-- <span class="swagger-global"></span> <span class="json-schema-reference"><a href=""></a></span> -->
+ <div class="prop-subtitle"> in formData </div>
</div>
<div class="prop-value">
- <p>successful operation</p>
+ <p>Video preview file</p>
</div>
</div>
- </section>
- </div>
- <div class="doc-examples">
- <h5>Response Content-Types:
- <span>application/json</span>
- </h5>
- <section>
- <h5>Response Example
- <span>(200 OK)</span>
- </h5>
- <!-- <div class="hljs"> --><pre><code class="hljs lang-json">{
- <span class="hljs-attr">"path"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>
-}
-</code></pre>
- <!-- </div> -->
- </section>
- </div>
- </div>
- </div>
- <h1 id="tag-Video" class="swagger-summary-tag" data-traverse-target="tag-Video">Video</h1>
- <div id="operation--videos-get" class="operation panel" data-traverse-target="operation--videos-get">
- <!-- <section class="operation-tags row"> -->
- <!-- <div class="doc-copy"> -->
- <div class="operation-tags">
- <a class="label" href="#tag-Video">Video</a>
- <!---->
- </div>
- <!-- </div> -->
- <!-- </section> -->
- <h2 class="operation-title">
- <span class="operation-name">
- <span class="operation-name">GET</span>
- <span class="operation-path">/videos</span>
- </span>
- </h2>
- <div class="doc-row">
- <div class="doc-copy">
- <section class="swagger-request-params">
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">start</div>
+ <div class="prop-title">category:
+ <span class="prop-type">
+ <span class="json-property-type">number</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in formData </div>
</div>
<div class="prop-value">
- <p>starting page</p>
+ <p>Video category</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
+ <div class="prop-row prop-group">
+ <div class="prop-name">
+ <div class="prop-title">licence:
+ <span class="prop-type">
+ <span class="json-property-type">number</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in formData </div>
+ </div>
<div class="prop-value">
- <span class="json-property-type">number</span>
- <span class="json-property-range" title="Value limits"></span>
+ <p>Video licence</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">query</div>
+ <div class="prop-row prop-group">
+ <div class="prop-name">
+ <div class="prop-title">language:
+ <span class="prop-type">
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in formData </div>
+ </div>
+ <div class="prop-value">
+ <p>Video language</p>
+ </div>
</div>
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">stop</div>
+ <div class="prop-title">description:
+ <span class="prop-type">
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in formData </div>
</div>
<div class="prop-value">
- <p>stopping page</p>
+ <p>Video description</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
+ <div class="prop-row prop-group">
+ <div class="prop-name">
+ <div class="prop-title">waitTranscoding:
+ <span class="prop-type">
+ <span class="json-property-type">boolean</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in formData </div>
+ </div>
<div class="prop-value">
- <span class="json-property-type">number</span>
- <span class="json-property-range" title="Value limits"></span>
+ <p>Whether or not we wait transcoding before publish the video</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">query</div>
+ <div class="prop-row prop-group">
+ <div class="prop-name">
+ <div class="prop-title">support:
+ <span class="prop-type">
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in formData </div>
+ </div>
+ <div class="prop-value">
+ <p>Text describing how to support the video uploader</p>
+ </div>
</div>
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">sort</div>
+ <div class="prop-title">nsfw:
+ <span class="prop-type">
+ <span class="json-property-type">boolean</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in formData </div>
</div>
<div class="prop-value">
- <p>sorting</p>
+ <p>Whether or not this video contains sensitive content</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
+ <div class="prop-row prop-group">
+ <div class="prop-name">
+ <div class="prop-title">name:
+ <span class="prop-type">
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in formData </div>
+ </div>
<div class="prop-value">
- <span class="json-property-type">number</span>
- <span class="json-property-range" title="Value limits"></span>
+ <p>Video name</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">query</div>
+ <div class="prop-row prop-group">
+ <div class="prop-name">
+ <div class="prop-title">tags:
+ <span class="prop-type">
+ <span class="json-property-type">string[]</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in formData </div>
+ </div>
+ <div class="prop-value">
+ <p>Video tags</p>
+ </div>
+ </div>
+ <div class="prop-row prop-group">
+ <div class="prop-name">
+ <div class="prop-title">commentsEnabled:
+ <span class="prop-type">
+ <span class="json-property-type">boolean</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in formData </div>
+ </div>
+ <div class="prop-value">
+ <p>Enable or disable comments for this video</p>
+ </div>
+ </div>
+ <div class="prop-row prop-group">
+ <div class="prop-name">
+ <div class="prop-title">privacy:
+ <span class="prop-type">
+ <span class="json-property-type">string</span>
+ <span class="json-property-enum" title="Possible values">
+ <span class="json-property-enum-item">Public</span>,
+ <span class="json-property-enum-item">Unlisted</span>
+ </span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in formData </div>
+ </div>
+ <div class="prop-value">
+ <p>Video privacy</p>
+ </div>
+ </div>
+ <div class="prop-row prop-group">
+ <div class="prop-name">
+ <div class="prop-title">scheduleUpdate:
+ <span class="prop-type">
+ <span class="json-property-type">object</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in formData </div>
+ </div>
+ <div class="prop-value">
+ <p>Schedule an update at a specific datetime</p>
+ </div>
</div>
</section>
</div>
<div class="prop-name">
<div class="prop-title">200 OK</div>
<div class="prop-ref">
- <span class="json-schema-ref-array">
+ <span class="">
<a class="json-schema-ref" href="#/definitions/Video">Video</a>
</span>
</div>
<h5>Response Example
<span>(200 OK)</span>
</h5>
- <!-- <div class="hljs"> --><pre><code class="hljs lang-json">[
- {
+ <!-- <div class="hljs"> --><pre><code class="hljs lang-json">{
+ <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"publishedAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"category"</span>: {
<span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"category"</span>: {
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
- },
- <span class="hljs-attr">"licence"</span>: {
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
- },
- <span class="hljs-attr">"language"</span>: {
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
- },
- <span class="hljs-attr">"description"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"duration"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"isLocal"</span>: <span class="hljs-string">"boolean"</span>,
+ <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
+ },
+ <span class="hljs-attr">"licence"</span>: {
+ <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
+ },
+ <span class="hljs-attr">"language"</span>: {
+ <span class="hljs-attr">"id"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
+ },
+ <span class="hljs-attr">"privacy"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"description"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"duration"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"isLocal"</span>: <span class="hljs-string">"boolean"</span>,
+ <span class="hljs-attr">"name"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"thumbnailPath"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"previewPath"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"embedPath"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"views"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"likes"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"dislikes"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"nsfw"</span>: <span class="hljs-string">"boolean"</span>,
+ <span class="hljs-attr">"account"</span>: {
<span class="hljs-attr">"name"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"thumbnailPath"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"previewPath"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"embedPath"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"views"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"likes"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"dislikes"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"nsfw"</span>: <span class="hljs-string">"boolean"</span>
+ <span class="hljs-attr">"displayName"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"url"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"host"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"avatar"</span>: {
+ <span class="hljs-attr">"path"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>
+ }
}
-]
+}
</code></pre>
<!-- </div> -->
</section>
</div>
</div>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-request-security">
+ <table class="table">
+ <thead>
+ <tr>
+ <th class="swagger-request-security-schema"></th>
+ <th class="swagger-request-security-scopes"></th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>
+ <a href="#security-definition-OAuth2">OAuth2</a>
+ </td>
+ <td> </td>
+ </tr>
+ </tbody>
+ </table>
+ </section>
+ </div>
+ </div>
</div>
- <div id="operation--videos-categories-get" class="operation panel" data-traverse-target="operation--videos-categories-get">
+ <div id="operation--videos--id--get" class="operation panel" data-traverse-target="operation--videos--id--get">
<!-- <section class="operation-tags row"> -->
<!-- <div class="doc-copy"> -->
<div class="operation-tags">
<!-- </div> -->
<!-- </section> -->
<h2 class="operation-title">
- <span class="operation-name">
- <span class="operation-name">GET</span>
- <span class="operation-path">/videos/categories</span>
- </span>
+ <span class="operation-summary">Get a video by its id</span>
</h2>
<div class="doc-row">
- <div class="doc-copy"> </div>
+ <div class="doc-copy">
+ <section class="swagger-operation-path">
+ <span class="operation-method">GET</span>
+ <span class="operation-path">/videos/{id}</span>
+ </section>
+ </div>
+ </div>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-request-params">
+ <div class="prop-row prop-group">
+ <div class="prop-name">
+ <div class="prop-title">id:
+ <span class="prop-type">
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <span class="json-property-required"></span>
+ <div class="prop-subtitle"> in path </div>
+ </div>
+ <div class="prop-value">
+ <p>The video id or uuid</p>
+ </div>
+ </div>
+ </section>
+ </div>
<div class="doc-examples"></div>
</div>
<div class="doc-row">
<div class="prop-row prop-group">
<div class="prop-name">
<div class="prop-title">200 OK</div>
- <div class="prop-ref"></div>
+ <div class="prop-ref">
+ <span class="">
+ <a class="json-schema-ref" href="#/definitions/Video">Video</a>
+ </span>
+ </div>
<!-- <span class="swagger-global"></span> <span class="json-schema-reference"><a href=""></a></span> -->
</div>
<div class="prop-value">
<h5>Response Example
<span>(200 OK)</span>
</h5>
- <!-- <div class="hljs"> --><pre><code class="hljs lang-json">[
- <span class="hljs-string">"string"</span>
-]
+ <!-- <div class="hljs"> --><pre><code class="hljs lang-json">{
+ <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"publishedAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"category"</span>: {
+ <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
+ },
+ <span class="hljs-attr">"licence"</span>: {
+ <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
+ },
+ <span class="hljs-attr">"language"</span>: {
+ <span class="hljs-attr">"id"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
+ },
+ <span class="hljs-attr">"privacy"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"description"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"duration"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"isLocal"</span>: <span class="hljs-string">"boolean"</span>,
+ <span class="hljs-attr">"name"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"thumbnailPath"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"previewPath"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"embedPath"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"views"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"likes"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"dislikes"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"nsfw"</span>: <span class="hljs-string">"boolean"</span>,
+ <span class="hljs-attr">"account"</span>: {
+ <span class="hljs-attr">"name"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"displayName"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"url"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"host"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"avatar"</span>: {
+ <span class="hljs-attr">"path"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>
+ }
+ }
+}
</code></pre>
<!-- </div> -->
</section>
</div>
</div>
</div>
- <div id="operation--videos-licences-get" class="operation panel" data-traverse-target="operation--videos-licences-get">
+ <div id="operation--videos--id--delete" class="operation panel" data-traverse-target="operation--videos--id--delete">
<!-- <section class="operation-tags row"> -->
<!-- <div class="doc-copy"> -->
<div class="operation-tags">
<!-- </div> -->
<!-- </section> -->
<h2 class="operation-title">
- <span class="operation-name">
- <span class="operation-name">GET</span>
- <span class="operation-path">/videos/licences</span>
- </span>
+ <span class="operation-summary">Delete a video by its id</span>
</h2>
<div class="doc-row">
- <div class="doc-copy"> </div>
- <div class="doc-examples"></div>
+ <div class="doc-copy">
+ <section class="swagger-operation-path">
+ <span class="operation-method">DELETE</span>
+ <span class="operation-path">/videos/{id}</span>
+ </section>
+ </div>
</div>
<div class="doc-row">
<div class="doc-copy">
- <section class="swagger-responses">
+ <section class="swagger-request-params">
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">200 OK</div>
- <div class="prop-ref"></div>
- <!-- <span class="swagger-global"></span> <span class="json-schema-reference"><a href=""></a></span> -->
+ <div class="prop-title">id:
+ <span class="prop-type">
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <span class="json-property-required"></span>
+ <div class="prop-subtitle"> in path </div>
</div>
<div class="prop-value">
- <p>successful operation</p>
+ <p>The video id or uuid</p>
</div>
</div>
</section>
</div>
- <div class="doc-examples">
- <h5>Response Content-Types:
- <span>application/json</span>
- </h5>
- <section>
- <h5>Response Example
- <span>(200 OK)</span>
- </h5>
- <!-- <div class="hljs"> --><pre><code class="hljs lang-json">[
- <span class="hljs-string">"string"</span>
-]
-</code></pre>
- <!-- </div> -->
+ <div class="doc-examples"></div>
+ </div>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-responses">
+ <div class="prop-row prop-group">
+ <div class="prop-name">
+ <div class="prop-title">204 No Content</div>
+ </div>
+ <div class="prop-value">
+ <p>Successful operation</p>
+ </div>
+ </div>
+ </section>
+ </div>
+ <div class="doc-examples">
+ <h5>Response Content-Types:
+ <span>application/json</span>
+ </h5>
+ </div>
+ </div>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-request-security">
+ <table class="table">
+ <thead>
+ <tr>
+ <th class="swagger-request-security-schema"></th>
+ <th class="swagger-request-security-scopes"></th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>
+ <a href="#security-definition-OAuth2">OAuth2</a>
+ </td>
+ <td> </td>
+ </tr>
+ </tbody>
+ </table>
</section>
</div>
</div>
</div>
- <div id="operation--videos-languages-get" class="operation panel" data-traverse-target="operation--videos-languages-get">
+ <div id="operation--videos--id--description-get" class="operation panel" data-traverse-target="operation--videos--id--description-get">
<!-- <section class="operation-tags row"> -->
<!-- <div class="doc-copy"> -->
<div class="operation-tags">
<!-- </div> -->
<!-- </section> -->
<h2 class="operation-title">
- <span class="operation-name">
- <span class="operation-name">GET</span>
- <span class="operation-path">/videos/languages</span>
- </span>
+ <span class="operation-summary">Get a video description by its id</span>
</h2>
<div class="doc-row">
- <div class="doc-copy"> </div>
+ <div class="doc-copy">
+ <section class="swagger-operation-path">
+ <span class="operation-method">GET</span>
+ <span class="operation-path">/videos/{id}/description</span>
+ </section>
+ </div>
+ </div>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-request-params">
+ <div class="prop-row prop-group">
+ <div class="prop-name">
+ <div class="prop-title">id:
+ <span class="prop-type">
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <span class="json-property-required"></span>
+ <div class="prop-subtitle"> in path </div>
+ </div>
+ <div class="prop-value">
+ <p>The video id or uuid</p>
+ </div>
+ </div>
+ </section>
+ </div>
<div class="doc-examples"></div>
</div>
<div class="doc-row">
<p>successful operation</p>
</div>
</div>
+ <div class="prop-row prop-inner">
+ <div class="prop-name">type</div>
+ <div class="prop-value">
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </div>
+ </div>
</section>
</div>
<div class="doc-examples">
<h5>Response Example
<span>(200 OK)</span>
</h5>
- <!-- <div class="hljs"> --><pre><code class="hljs lang-json">[
- <span class="hljs-string">"string"</span>
-]
+ <!-- <div class="hljs"> --><pre><code class="hljs lang-json"><span class="hljs-string">"string"</span>
</code></pre>
<!-- </div> -->
</section>
</div>
</div>
</div>
- <div id="operation--videos-privacies-get" class="operation panel" data-traverse-target="operation--videos-privacies-get">
+ <div id="operation--videos--id--views-post" class="operation panel" data-traverse-target="operation--videos--id--views-post">
<!-- <section class="operation-tags row"> -->
<!-- <div class="doc-copy"> -->
<div class="operation-tags">
<!-- </div> -->
<!-- </section> -->
<h2 class="operation-title">
- <span class="operation-name">
- <span class="operation-name">GET</span>
- <span class="operation-path">/videos/privacies</span>
- </span>
+ <span class="operation-summary">Add a view to the video by its id</span>
</h2>
<div class="doc-row">
- <div class="doc-copy"> </div>
+ <div class="doc-copy">
+ <section class="swagger-operation-path">
+ <span class="operation-method">POST</span>
+ <span class="operation-path">/videos/{id}/views</span>
+ </section>
+ </div>
+ </div>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-request-params">
+ <div class="prop-row prop-group">
+ <div class="prop-name">
+ <div class="prop-title">id:
+ <span class="prop-type">
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <span class="json-property-required"></span>
+ <div class="prop-subtitle"> in path </div>
+ </div>
+ <div class="prop-value">
+ <p>The video id or uuid</p>
+ </div>
+ </div>
+ </section>
+ </div>
<div class="doc-examples"></div>
</div>
<div class="doc-row">
<section class="swagger-responses">
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">200 OK</div>
- <div class="prop-ref"></div>
- <!-- <span class="swagger-global"></span> <span class="json-schema-reference"><a href=""></a></span> -->
+ <div class="prop-title">204 No Content</div>
</div>
<div class="prop-value">
- <p>successful operation</p>
+ <p>Successful operation</p>
</div>
</div>
</section>
<h5>Response Content-Types:
<span>application/json</span>
</h5>
- <section>
- <h5>Response Example
- <span>(200 OK)</span>
- </h5>
- <!-- <div class="hljs"> --><pre><code class="hljs lang-json">[
- <span class="hljs-string">"string"</span>
-]
-</code></pre>
- <!-- </div> -->
- </section>
</div>
</div>
</div>
- <div id="operation--videos-search-get" class="operation panel" data-traverse-target="operation--videos-search-get">
+ <div id="operation--videos-upload-post" class="operation panel" data-traverse-target="operation--videos-upload-post">
<!-- <section class="operation-tags row"> -->
<!-- <div class="doc-copy"> -->
<div class="operation-tags">
<!-- </div> -->
<!-- </section> -->
<h2 class="operation-title">
- <span class="operation-name">
- <span class="operation-name">GET</span>
- <span class="operation-path">/videos/search</span>
- </span>
+ <span class="operation-summary">Upload a video file with its metadata</span>
</h2>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-operation-path">
+ <span class="operation-method">POST</span>
+ <span class="operation-path">/videos/upload</span>
+ </section>
+ </div>
+ </div>
<div class="doc-row">
<div class="doc-copy">
<section class="swagger-request-params">
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">start</div>
+ <div class="prop-title">videofile:
+ <span class="prop-type">
+ <span class="json-property-type">file</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <span class="json-property-required"></span>
+ <div class="prop-subtitle"> in formData </div>
</div>
<div class="prop-value">
- <p>starting page</p>
+ <p>Video file</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
+ <div class="prop-row prop-group">
+ <div class="prop-name">
+ <div class="prop-title">channelId:
+ <span class="prop-type">
+ <span class="json-property-type">number</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <span class="json-property-required"></span>
+ <div class="prop-subtitle"> in formData </div>
+ </div>
<div class="prop-value">
- <span class="json-property-type">number</span>
- <span class="json-property-range" title="Value limits"></span>
+ <p>Channel id that will contain this video</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">query</div>
+ <div class="prop-row prop-group">
+ <div class="prop-name">
+ <div class="prop-title">thumbnailfile:
+ <span class="prop-type">
+ <span class="json-property-type">file</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in formData </div>
+ </div>
+ <div class="prop-value">
+ <p>Video thumbnail file</p>
+ </div>
</div>
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">stop</div>
+ <div class="prop-title">previewfile:
+ <span class="prop-type">
+ <span class="json-property-type">file</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in formData </div>
</div>
<div class="prop-value">
- <p>stopping page</p>
+ <p>Video preview file</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
+ <div class="prop-row prop-group">
+ <div class="prop-name">
+ <div class="prop-title">category:
+ <span class="prop-type">
+ <span class="json-property-type">number</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in formData </div>
+ </div>
<div class="prop-value">
- <span class="json-property-type">number</span>
- <span class="json-property-range" title="Value limits"></span>
+ <p>Video category</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">query</div>
+ <div class="prop-row prop-group">
+ <div class="prop-name">
+ <div class="prop-title">licence:
+ <span class="prop-type">
+ <span class="json-property-type">number</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in formData </div>
+ </div>
+ <div class="prop-value">
+ <p>Video licence</p>
+ </div>
</div>
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">sort</div>
+ <div class="prop-title">language:
+ <span class="prop-type">
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in formData </div>
</div>
<div class="prop-value">
- <p>sorting</p>
+ <p>Video language</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
+ <div class="prop-row prop-group">
+ <div class="prop-name">
+ <div class="prop-title">description:
+ <span class="prop-type">
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in formData </div>
+ </div>
<div class="prop-value">
- <span class="json-property-type">number</span>
- <span class="json-property-range" title="Value limits"></span>
+ <p>Video description</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">query</div>
+ <div class="prop-row prop-group">
+ <div class="prop-name">
+ <div class="prop-title">waitTranscoding:
+ <span class="prop-type">
+ <span class="json-property-type">boolean</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in formData </div>
+ </div>
+ <div class="prop-value">
+ <p>Whether or not we wait transcoding before publish the video</p>
+ </div>
+ </div>
+ <div class="prop-row prop-group">
+ <div class="prop-name">
+ <div class="prop-title">support:
+ <span class="prop-type">
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in formData </div>
+ </div>
+ <div class="prop-value">
+ <p>Text describing how to support the video uploader</p>
+ </div>
+ </div>
+ <div class="prop-row prop-group">
+ <div class="prop-name">
+ <div class="prop-title">nsfw:
+ <span class="prop-type">
+ <span class="json-property-type">boolean</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in formData </div>
+ </div>
+ <div class="prop-value">
+ <p>Whether or not this video contains sensitive content</p>
+ </div>
+ </div>
+ <div class="prop-row prop-group">
+ <div class="prop-name">
+ <div class="prop-title">name:
+ <span class="prop-type">
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in formData </div>
+ </div>
+ <div class="prop-value">
+ <p>Video name</p>
+ </div>
+ </div>
+ <div class="prop-row prop-group">
+ <div class="prop-name">
+ <div class="prop-title">tags:
+ <span class="prop-type">
+ <span class="json-property-type">string[]</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in formData </div>
+ </div>
+ <div class="prop-value">
+ <p>Video tags</p>
+ </div>
+ </div>
+ <div class="prop-row prop-group">
+ <div class="prop-name">
+ <div class="prop-title">commentsEnabled:
+ <span class="prop-type">
+ <span class="json-property-type">boolean</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in formData </div>
+ </div>
+ <div class="prop-value">
+ <p>Enable or disable comments for this video</p>
+ </div>
+ </div>
+ <div class="prop-row prop-group">
+ <div class="prop-name">
+ <div class="prop-title">privacy:
+ <span class="prop-type">
+ <span class="json-property-type">string</span>
+ <span class="json-property-enum" title="Possible values">
+ <span class="json-property-enum-item">Public</span>,
+ <span class="json-property-enum-item">Unlisted</span>
+ </span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in formData </div>
+ </div>
+ <div class="prop-value">
+ <p>Video privacy</p>
+ </div>
+ </div>
+ <div class="prop-row prop-group">
+ <div class="prop-name">
+ <div class="prop-title">scheduleUpdate:
+ <span class="prop-type">
+ <span class="json-property-type">object</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in formData </div>
+ </div>
+ <div class="prop-value">
+ <p>Schedule an update at a specific datetime</p>
+ </div>
</div>
</section>
</div>
<div class="prop-name">
<div class="prop-title">200 OK</div>
<div class="prop-ref">
- <span class="json-schema-ref-array">
- <a class="json-schema-ref" href="#/definitions/Video">Video</a>
+ <span class="">
+ <a class="json-schema-ref" href="#/definitions/VideoUploadResponse">VideoUploadResponse</a>
</span>
</div>
<!-- <span class="swagger-global"></span> <span class="json-schema-reference"><a href=""></a></span> -->
<h5>Response Example
<span>(200 OK)</span>
</h5>
- <!-- <div class="hljs"> --><pre><code class="hljs lang-json">[
- {
+ <!-- <div class="hljs"> --><pre><code class="hljs lang-json">{
+ <span class="hljs-attr">"video"</span>: {
<span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"category"</span>: {
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
- },
- <span class="hljs-attr">"licence"</span>: {
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
- },
- <span class="hljs-attr">"language"</span>: {
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
- },
- <span class="hljs-attr">"description"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"duration"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"isLocal"</span>: <span class="hljs-string">"boolean"</span>,
- <span class="hljs-attr">"name"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"thumbnailPath"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"previewPath"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"embedPath"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"views"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"likes"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"dislikes"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"nsfw"</span>: <span class="hljs-string">"boolean"</span>
+ <span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>
}
-]
+}
</code></pre>
<!-- </div> -->
</section>
</div>
</div>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-request-security">
+ <table class="table">
+ <thead>
+ <tr>
+ <th class="swagger-request-security-schema"></th>
+ <th class="swagger-request-security-scopes"></th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>
+ <a href="#security-definition-OAuth2">OAuth2</a>
+ </td>
+ <td> </td>
+ </tr>
+ </tbody>
+ </table>
+ </section>
+ </div>
+ </div>
</div>
- <div id="operation--videos--id--put" class="operation panel" data-traverse-target="operation--videos--id--put">
+ <h1 id="tag-Search" class="swagger-summary-tag" data-traverse-target="tag-Search">Search</h1>
+ <div class="tag-description doc-row">
+ <div class="doc-copy">
+ <p>The search helps to find
+ <em>videos</em> from within the instance and beyond. Videos from other instances federated by the instance (that is, instances followed by the instance) can be found via keywords and other criteria of the advanced search.</p>
+ </div>
+ </div>
+ <div id="operation--search-videos-get" class="operation panel" data-traverse-target="operation--search-videos-get">
<!-- <section class="operation-tags row"> -->
<!-- <div class="doc-copy"> -->
<div class="operation-tags">
- <a class="label" href="#tag-Video">Video</a>
+ <a class="label" href="#tag-Search">Search</a>
<!---->
</div>
<!-- </div> -->
<!-- </section> -->
<h2 class="operation-title">
- <span class="operation-name">
- <span class="operation-name">PUT</span>
- <span class="operation-path">/videos/{id}</span>
- </span>
+ <span class="operation-summary">Get the videos corresponding to a given query</span>
</h2>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-operation-path">
+ <span class="operation-method">GET</span>
+ <span class="operation-path">/search/videos</span>
+ </section>
+ </div>
+ </div>
<div class="doc-row">
<div class="doc-copy">
<section class="swagger-request-params">
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">id</div>
- <span class="json-property-required"></span>
+ <div class="prop-title">start:
+ <span class="prop-type">
+ <span class="json-property-type">number</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in query </div>
</div>
<div class="prop-value">
- <p>The video id </p>
+ <p>Offset</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
+ <div class="prop-row prop-group">
+ <div class="prop-name">
+ <div class="prop-title">count:
+ <span class="prop-type">
+ <span class="json-property-type">number</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in query </div>
+ </div>
<div class="prop-value">
- <span class="json-property-type">string</span>
- <span class="json-property-range" title="Value limits"></span>
+ <p>Number of items</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">path</div>
+ <div class="prop-row prop-group">
+ <div class="prop-name">
+ <div class="prop-title">sort:
+ <span class="prop-type">
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in query </div>
+ </div>
+ <div class="prop-value">
+ <p>Sort column (-createdAt for example)</p>
+ </div>
+ </div>
+ <div class="prop-row prop-group">
+ <div class="prop-name">
+ <div class="prop-title">search:
+ <span class="prop-type">
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <span class="json-property-required"></span>
+ <div class="prop-subtitle"> in query </div>
+ </div>
+ <div class="prop-value">
+ <p>String to search</p>
+ </div>
</div>
</section>
</div>
<div class="prop-name">
<div class="prop-title">200 OK</div>
<div class="prop-ref">
- <span class="">
+ <span class="json-schema-ref-array">
<a class="json-schema-ref" href="#/definitions/Video">Video</a>
</span>
</div>
<p>successful operation</p>
</div>
</div>
+ <div class="prop-row prop-inner">
+ <div class="prop-name">type</div>
+ <div class="prop-value">
+ <span class="json-property-type">
+ <span class="json-schema-ref-array">
+ <a class="json-schema-ref" href="#/definitions/Video">Video</a>
+ </span>
+ </span>
+ <span class="json-property-range" title="Value limits"></span>
+ </div>
+ </div>
</section>
</div>
<div class="doc-examples">
<h5>Response Example
<span>(200 OK)</span>
</h5>
- <!-- <div class="hljs"> --><pre><code class="hljs lang-json">{
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"category"</span>: {
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
- },
- <span class="hljs-attr">"licence"</span>: {
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
- },
- <span class="hljs-attr">"language"</span>: {
+ <!-- <div class="hljs"> --><pre><code class="hljs lang-json">[
+ {
<span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
- },
- <span class="hljs-attr">"description"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"duration"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"isLocal"</span>: <span class="hljs-string">"boolean"</span>,
- <span class="hljs-attr">"name"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"thumbnailPath"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"previewPath"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"embedPath"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"views"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"likes"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"dislikes"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"nsfw"</span>: <span class="hljs-string">"boolean"</span>
-}
+ <span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"publishedAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"category"</span>: {
+ <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
+ },
+ <span class="hljs-attr">"licence"</span>: {
+ <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
+ },
+ <span class="hljs-attr">"language"</span>: {
+ <span class="hljs-attr">"id"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
+ },
+ <span class="hljs-attr">"privacy"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"description"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"duration"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"isLocal"</span>: <span class="hljs-string">"boolean"</span>,
+ <span class="hljs-attr">"name"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"thumbnailPath"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"previewPath"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"embedPath"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"views"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"likes"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"dislikes"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"nsfw"</span>: <span class="hljs-string">"boolean"</span>,
+ <span class="hljs-attr">"account"</span>: {
+ <span class="hljs-attr">"name"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"displayName"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"url"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"host"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"avatar"</span>: {
+ <span class="hljs-attr">"path"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>
+ }
+ }
+ }
+]
</code></pre>
<!-- </div> -->
</section>
</div>
</div>
</div>
- <div id="operation--videos--id--get" class="operation panel" data-traverse-target="operation--videos--id--get">
+ <h1 id="tag-VideoComment" class="swagger-summary-tag" data-traverse-target="tag-VideoComment">VideoComment</h1>
+ <div class="tag-description doc-row">
+ <div class="doc-copy">
+ <p>Operations dealing with comments to a video. Comments are organized in threads.</p>
+ </div>
+ </div>
+ <div id="operation--videos--id--comment-threads-get" class="operation panel" data-traverse-target="operation--videos--id--comment-threads-get">
<!-- <section class="operation-tags row"> -->
<!-- <div class="doc-copy"> -->
<div class="operation-tags">
- <a class="label" href="#tag-Video">Video</a>
+ <a class="label" href="#tag-VideoComment">VideoComment</a>
<!---->
</div>
<!-- </div> -->
<!-- </section> -->
<h2 class="operation-title">
- <span class="operation-name">
- <span class="operation-name">GET</span>
- <span class="operation-path">/videos/{id}</span>
- </span>
+ <span class="operation-summary">Get the comment threads of a video by its id</span>
</h2>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-operation-path">
+ <span class="operation-method">GET</span>
+ <span class="operation-path">/videos/{id}/comment-threads</span>
+ </section>
+ </div>
+ </div>
<div class="doc-row">
<div class="doc-copy">
<section class="swagger-request-params">
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">id</div>
+ <div class="prop-title">id:
+ <span class="prop-type">
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
<span class="json-property-required"></span>
+ <div class="prop-subtitle"> in path </div>
</div>
<div class="prop-value">
- <p>The video id </p>
+ <p>The video id or uuid</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
+ <div class="prop-row prop-group">
+ <div class="prop-name">
+ <div class="prop-title">start:
+ <span class="prop-type">
+ <span class="json-property-type">number</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in query </div>
+ </div>
<div class="prop-value">
- <span class="json-property-type">string</span>
- <span class="json-property-range" title="Value limits"></span>
+ <p>Offset</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">path</div>
+ <div class="prop-row prop-group">
+ <div class="prop-name">
+ <div class="prop-title">count:
+ <span class="prop-type">
+ <span class="json-property-type">number</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in query </div>
+ </div>
+ <div class="prop-value">
+ <p>Number of items</p>
+ </div>
+ </div>
+ <div class="prop-row prop-group">
+ <div class="prop-name">
+ <div class="prop-title">sort:
+ <span class="prop-type">
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in query </div>
+ </div>
+ <div class="prop-value">
+ <p>Sort column (-createdAt for example)</p>
+ </div>
</div>
</section>
</div>
<div class="prop-title">200 OK</div>
<div class="prop-ref">
<span class="">
- <a class="json-schema-ref" href="#/definitions/Video">Video</a>
+ <a class="json-schema-ref" href="#/definitions/CommentThreadResponse">CommentThreadResponse</a>
</span>
</div>
<!-- <span class="swagger-global"></span> <span class="json-schema-reference"><a href=""></a></span> -->
<span>(200 OK)</span>
</h5>
<!-- <div class="hljs"> --><pre><code class="hljs lang-json">{
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"category"</span>: {
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
- },
- <span class="hljs-attr">"licence"</span>: {
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
- },
- <span class="hljs-attr">"language"</span>: {
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
- },
- <span class="hljs-attr">"description"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"duration"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"isLocal"</span>: <span class="hljs-string">"boolean"</span>,
- <span class="hljs-attr">"name"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"thumbnailPath"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"previewPath"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"embedPath"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"views"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"likes"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"dislikes"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"nsfw"</span>: <span class="hljs-string">"boolean"</span>
+ <span class="hljs-attr">"total"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"data"</span>: [
+ {
+ <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"url"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"text"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"threadId"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"inReplyToCommentId"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"videoId"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"totalReplies"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"account"</span>: {
+ <span class="hljs-attr">"displayName"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"url"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"name"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"host"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"followingCount"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"followersCount"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"avatar"</span>: {
+ <span class="hljs-attr">"path"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>
+ }
+ }
+ }
+ ]
}
</code></pre>
<!-- </div> -->
</div>
</div>
</div>
- <div id="operation--videos--id--delete" class="operation panel" data-traverse-target="operation--videos--id--delete">
+ <div id="operation--videos--id--comment-threads-post" class="operation panel" data-traverse-target="operation--videos--id--comment-threads-post">
<!-- <section class="operation-tags row"> -->
<!-- <div class="doc-copy"> -->
<div class="operation-tags">
- <a class="label" href="#tag-Video">Video</a>
+ <a class="label" href="#tag-VideoComment">VideoComment</a>
<!---->
</div>
<!-- </div> -->
<!-- </section> -->
<h2 class="operation-title">
- <span class="operation-name">
- <span class="operation-name">DELETE</span>
- <span class="operation-path">/videos/{id}</span>
- </span>
+ <span class="operation-summary">Creates a comment thread, on a video by its id</span>
</h2>
<div class="doc-row">
<div class="doc-copy">
- <section class="swagger-request-params">
+ <section class="swagger-operation-path">
+ <span class="operation-method">POST</span>
+ <span class="operation-path">/videos/{id}/comment-threads</span>
+ </section>
+ </div>
+ </div>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-request-params">
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">id</div>
+ <div class="prop-title">id:
+ <span class="prop-type">
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
<span class="json-property-required"></span>
+ <div class="prop-subtitle"> in path </div>
</div>
<div class="prop-value">
- <p>The video id </p>
- </div>
- </div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
- <div class="prop-value">
- <span class="json-property-type">string</span>
- <span class="json-property-range" title="Value limits"></span>
+ <p>The video id or uuid</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">path</div>
- </div>
</section>
</div>
<div class="doc-examples"></div>
<section class="swagger-responses">
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">204 No Content</div>
+ <div class="prop-title">200 OK</div>
+ <div class="prop-ref">
+ <span class="">
+ <a class="json-schema-ref" href="#/definitions/CommentThreadPostResponse">CommentThreadPostResponse</a>
+ </span>
+ </div>
+ <!-- <span class="swagger-global"></span> <span class="json-schema-reference"><a href=""></a></span> -->
</div>
<div class="prop-value">
<p>successful operation</p>
<h5>Response Content-Types:
<span>application/json</span>
</h5>
+ <section>
+ <h5>Response Example
+ <span>(200 OK)</span>
+ </h5>
+ <!-- <div class="hljs"> --><pre><code class="hljs lang-json">{
+ <span class="hljs-attr">"comment"</span>: {
+ <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"url"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"text"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"threadId"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"inReplyToCommentId"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"videoId"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"totalReplies"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"account"</span>: {
+ <span class="hljs-attr">"displayName"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"url"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"name"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"host"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"followingCount"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"followersCount"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"avatar"</span>: {
+ <span class="hljs-attr">"path"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>
+ }
+ }
+ }
+}
+</code></pre>
+ <!-- </div> -->
+ </section>
+ </div>
+ </div>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-request-security">
+ <table class="table">
+ <thead>
+ <tr>
+ <th class="swagger-request-security-schema"></th>
+ <th class="swagger-request-security-scopes"></th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>
+ <a href="#security-definition-OAuth2">OAuth2</a>
+ </td>
+ <td> </td>
+ </tr>
+ </tbody>
+ </table>
+ </section>
</div>
</div>
</div>
- <div id="operation--videos--id--description-get" class="operation panel" data-traverse-target="operation--videos--id--description-get">
+ <div id="operation--videos--id--comment-threads--threadId--get" class="operation panel" data-traverse-target="operation--videos--id--comment-threads--threadId--get">
<!-- <section class="operation-tags row"> -->
<!-- <div class="doc-copy"> -->
<div class="operation-tags">
- <a class="label" href="#tag-Video">Video</a>
+ <a class="label" href="#tag-VideoComment">VideoComment</a>
<!---->
</div>
<!-- </div> -->
<!-- </section> -->
<h2 class="operation-title">
- <span class="operation-name">
- <span class="operation-name">GET</span>
- <span class="operation-path">/videos/{id}/description</span>
- </span>
+ <span class="operation-summary">Get the comment thread by its id, of a video by its id</span>
</h2>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-operation-path">
+ <span class="operation-method">GET</span>
+ <span class="operation-path">/videos/{id}/comment-threads/{threadId}</span>
+ </section>
+ </div>
+ </div>
<div class="doc-row">
<div class="doc-copy">
<section class="swagger-request-params">
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">id</div>
+ <div class="prop-title">id:
+ <span class="prop-type">
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
<span class="json-property-required"></span>
+ <div class="prop-subtitle"> in path </div>
</div>
<div class="prop-value">
- <p>The video id </p>
+ <p>The video id or uuid</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
+ <div class="prop-row prop-group">
+ <div class="prop-name">
+ <div class="prop-title">threadId:
+ <span class="prop-type">
+ <span class="json-property-type">number</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <span class="json-property-required"></span>
+ <div class="prop-subtitle"> in path </div>
+ </div>
<div class="prop-value">
- <span class="json-property-type">string</span>
- <span class="json-property-range" title="Value limits"></span>
+ <p>The thread id (root comment id)</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">path</div>
- </div>
</section>
</div>
<div class="doc-examples"></div>
<div class="prop-row prop-group">
<div class="prop-name">
<div class="prop-title">200 OK</div>
- <div class="prop-ref"></div>
+ <div class="prop-ref">
+ <span class="">
+ <a class="json-schema-ref" href="#/definitions/VideoCommentThreadTree">VideoCommentThreadTree</a>
+ </span>
+ </div>
<!-- <span class="swagger-global"></span> <span class="json-schema-reference"><a href=""></a></span> -->
</div>
<div class="prop-value">
<h5>Response Example
<span>(200 OK)</span>
</h5>
- <!-- <div class="hljs"> --><pre><code class="hljs lang-json"><span class="hljs-string">"string"</span>
+ <!-- <div class="hljs"> --><pre><code class="hljs lang-json">{
+ <span class="hljs-attr">"comment"</span>: {
+ <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"url"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"text"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"threadId"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"inReplyToCommentId"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"videoId"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"totalReplies"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"account"</span>: {
+ <span class="hljs-attr">"displayName"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"url"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"name"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"host"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"followingCount"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"followersCount"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"avatar"</span>: {
+ <span class="hljs-attr">"path"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>
+ }
+ }
+ },
+ <span class="hljs-attr">"children"</span>: [
+ {
+ <span class="hljs-attr">"comment"</span>: {
+ <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"url"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"text"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"threadId"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"inReplyToCommentId"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"videoId"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"totalReplies"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"account"</span>: {
+ <span class="hljs-attr">"displayName"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"url"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"name"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"host"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"followingCount"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"followersCount"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"avatar"</span>: {
+ <span class="hljs-attr">"path"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>
+ }
+ }
+ },
+ <span class="hljs-attr">"children"</span>: [
+ {
+ <span class="hljs-attr">"comment"</span>: {
+ <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"url"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"text"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"threadId"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"inReplyToCommentId"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"videoId"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"totalReplies"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"account"</span>: {
+ <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"url"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"name"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"host"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"followingCount"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"followersCount"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"avatar"</span>: {
+ <span class="hljs-attr">"path"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>
+ }
+ }
+ }
+ }
+ ]
+ }
+ ]
+}
</code></pre>
<!-- </div> -->
</section>
</div>
</div>
</div>
- <div id="operation--videos--id--views-post" class="operation panel" data-traverse-target="operation--videos--id--views-post">
+ <div id="operation--videos--id--comments--commentId--post" class="operation panel" data-traverse-target="operation--videos--id--comments--commentId--post">
<!-- <section class="operation-tags row"> -->
<!-- <div class="doc-copy"> -->
<div class="operation-tags">
- <a class="label" href="#tag-Video">Video</a>
+ <a class="label" href="#tag-VideoComment">VideoComment</a>
<!---->
</div>
<!-- </div> -->
<!-- </section> -->
<h2 class="operation-title">
- <span class="operation-name">
- <span class="operation-name">POST</span>
- <span class="operation-path">/videos/{id}/views</span>
- </span>
+ <span class="operation-summary">Creates a comment in a comment thread by its id, of a video by its id</span>
</h2>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-operation-path">
+ <span class="operation-method">POST</span>
+ <span class="operation-path">/videos/{id}/comments/{commentId}</span>
+ </section>
+ </div>
+ </div>
<div class="doc-row">
<div class="doc-copy">
<section class="swagger-request-params">
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">id</div>
+ <div class="prop-title">id:
+ <span class="prop-type">
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
<span class="json-property-required"></span>
+ <div class="prop-subtitle"> in path </div>
</div>
<div class="prop-value">
- <p>The video id </p>
+ <p>The video id or uuid</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
+ <div class="prop-row prop-group">
+ <div class="prop-name">
+ <div class="prop-title">threadId:
+ <span class="prop-type">
+ <span class="json-property-type">number</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <span class="json-property-required"></span>
+ <div class="prop-subtitle"> in path </div>
+ </div>
<div class="prop-value">
- <span class="json-property-type">string</span>
- <span class="json-property-range" title="Value limits"></span>
+ <p>The comment id</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">path</div>
- </div>
</section>
</div>
<div class="doc-examples"></div>
<section class="swagger-responses">
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">204 No Content</div>
+ <div class="prop-title">200 OK</div>
+ <div class="prop-ref">
+ <span class="">
+ <a class="json-schema-ref" href="#/definitions/CommentThreadPostResponse">CommentThreadPostResponse</a>
+ </span>
+ </div>
+ <!-- <span class="swagger-global"></span> <span class="json-schema-reference"><a href=""></a></span> -->
</div>
<div class="prop-value">
<p>successful operation</p>
<h5>Response Content-Types:
<span>application/json</span>
</h5>
- </div>
- </div>
- </div>
- <div id="operation--videos-upload-post" class="operation panel" data-traverse-target="operation--videos-upload-post">
- <!-- <section class="operation-tags row"> -->
- <!-- <div class="doc-copy"> -->
- <div class="operation-tags">
- <a class="label" href="#tag-Video">Video</a>
- <!---->
- </div>
- <!-- </div> -->
- <!-- </section> -->
- <h2 class="operation-title">
- <span class="operation-name">
- <span class="operation-name">POST</span>
- <span class="operation-path">/videos/upload</span>
- </span>
- </h2>
- <div class="doc-row">
- <div class="doc-copy">
- <section class="swagger-request-params">
- <div class="prop-row prop-group">
- <div class="prop-name">
- <div class="prop-title">videofile</div>
- </div>
- <div class="prop-value">
- <p>The file to upload.</p>
- </div>
- </div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
- <div class="prop-value">
- <span class="json-property-type">file</span>
- <span class="json-property-range" title="Value limits"></span>
- </div>
- </div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">formData</div>
+ <section>
+ <h5>Response Example
+ <span>(200 OK)</span>
+ </h5>
+ <!-- <div class="hljs"> --><pre><code class="hljs lang-json">{
+ <span class="hljs-attr">"comment"</span>: {
+ <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"url"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"text"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"threadId"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"inReplyToCommentId"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"videoId"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"totalReplies"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"account"</span>: {
+ <span class="hljs-attr">"displayName"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"url"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"name"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"host"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"followingCount"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"followersCount"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"avatar"</span>: {
+ <span class="hljs-attr">"path"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>
+ }
+ }
+ }
+}
+</code></pre>
+ <!-- </div> -->
+ </section>
+ </div>
+ </div>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-request-security">
+ <table class="table">
+ <thead>
+ <tr>
+ <th class="swagger-request-security-schema"></th>
+ <th class="swagger-request-security-scopes"></th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>
+ <a href="#security-definition-OAuth2">OAuth2</a>
+ </td>
+ <td> </td>
+ </tr>
+ </tbody>
+ </table>
+ </section>
+ </div>
+ </div>
+ </div>
+ <div id="operation--videos--id--comments--commentId--delete" class="operation panel" data-traverse-target="operation--videos--id--comments--commentId--delete">
+ <!-- <section class="operation-tags row"> -->
+ <!-- <div class="doc-copy"> -->
+ <div class="operation-tags">
+ <a class="label" href="#tag-VideoComment">VideoComment</a>
+ <!---->
+ </div>
+ <!-- </div> -->
+ <!-- </section> -->
+ <h2 class="operation-title">
+ <span class="operation-summary">Delete a comment in a comment therad by its id, of a video by its id</span>
+ </h2>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-operation-path">
+ <span class="operation-method">DELETE</span>
+ <span class="operation-path">/videos/{id}/comments/{commentId}</span>
+ </section>
+ </div>
+ </div>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-request-params">
+ <div class="prop-row prop-group">
+ <div class="prop-name">
+ <div class="prop-title">id:
+ <span class="prop-type">
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <span class="json-property-required"></span>
+ <div class="prop-subtitle"> in path </div>
+ </div>
+ <div class="prop-value">
+ <p>The video id or uuid</p>
+ </div>
+ </div>
+ <div class="prop-row prop-group">
+ <div class="prop-name">
+ <div class="prop-title">threadId:
+ <span class="prop-type">
+ <span class="json-property-type">number</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <span class="json-property-required"></span>
+ <div class="prop-subtitle"> in path </div>
+ </div>
+ <div class="prop-value">
+ <p>The comment id</p>
+ </div>
</div>
</section>
</div>
<section class="swagger-responses">
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">200 OK</div>
- <div class="prop-ref">
- <span class="">
- <a class="json-schema-ref" href="#/definitions/VideoUploadResponse">VideoUploadResponse</a>
- </span>
- </div>
- <!-- <span class="swagger-global"></span> <span class="json-schema-reference"><a href=""></a></span> -->
+ <div class="prop-title">204 No Content</div>
</div>
<div class="prop-value">
- <p>successful operation</p>
+ <p>Successful operation</p>
</div>
</div>
</section>
<h5>Response Content-Types:
<span>application/json</span>
</h5>
- <section>
- <h5>Response Example
- <span>(200 OK)</span>
- </h5>
- <!-- <div class="hljs"> --><pre><code class="hljs lang-json">{
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>
-}
-</code></pre>
- <!-- </div> -->
+ </div>
+ </div>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-request-security">
+ <table class="table">
+ <thead>
+ <tr>
+ <th class="swagger-request-security-schema"></th>
+ <th class="swagger-request-security-scopes"></th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>
+ <a href="#security-definition-OAuth2">OAuth2</a>
+ </td>
+ <td> </td>
+ </tr>
+ </tbody>
+ </table>
</section>
</div>
</div>
</div>
- <h1 id="tag-VideoAbuse" class="swagger-summary-tag" data-traverse-target="tag-VideoAbuse">VideoAbuse</h1>
- <div id="operation--videos-abuse-get" class="operation panel" data-traverse-target="operation--videos-abuse-get">
+ <h1 id="tag-VideoChannel" class="swagger-summary-tag" data-traverse-target="tag-VideoChannel">VideoChannel</h1>
+ <div class="tag-description doc-row">
+ <div class="doc-copy">
+ <p>Operations dealing with creation, modification and video listing of a user's channels.</p>
+ </div>
+ </div>
+ <div id="operation--video-channels-get" class="operation panel" data-traverse-target="operation--video-channels-get">
<!-- <section class="operation-tags row"> -->
<!-- <div class="doc-copy"> -->
<div class="operation-tags">
- <a class="label" href="#tag-VideoAbuse">VideoAbuse</a>
+ <a class="label" href="#tag-VideoChannel">VideoChannel</a>
<!---->
</div>
<!-- </div> -->
<!-- </section> -->
<h2 class="operation-title">
- <span class="operation-name">
- <span class="operation-name">GET</span>
- <span class="operation-path">/videos/abuse</span>
- </span>
+ <span class="operation-summary">Get list of video channels</span>
</h2>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-operation-path">
+ <span class="operation-method">GET</span>
+ <span class="operation-path">/video-channels</span>
+ </section>
+ </div>
+ </div>
<div class="doc-row">
<div class="doc-copy">
<section class="swagger-request-params">
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">start</div>
- </div>
- <div class="prop-value">
- <p>starting page</p>
+ <div class="prop-title">start:
+ <span class="prop-type">
+ <span class="json-property-type">number</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in query </div>
</div>
- </div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
<div class="prop-value">
- <span class="json-property-type">number</span>
- <span class="json-property-range" title="Value limits"></span>
+ <p>Offset</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">query</div>
- </div>
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">stop</div>
- </div>
- <div class="prop-value">
- <p>stopping page</p>
+ <div class="prop-title">count:
+ <span class="prop-type">
+ <span class="json-property-type">number</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in query </div>
</div>
- </div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
<div class="prop-value">
- <span class="json-property-type">number</span>
- <span class="json-property-range" title="Value limits"></span>
+ <p>Number of items</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">query</div>
- </div>
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">sort</div>
- </div>
- <div class="prop-value">
- <p>sorting</p>
+ <div class="prop-title">sort:
+ <span class="prop-type">
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in query </div>
</div>
- </div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
<div class="prop-value">
- <span class="json-property-type">number</span>
- <span class="json-property-range" title="Value limits"></span>
+ <p>Sort column (-createdAt for example)</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">query</div>
- </div>
</section>
</div>
<div class="doc-examples"></div>
<div class="prop-title">200 OK</div>
<div class="prop-ref">
<span class="json-schema-ref-array">
- <a class="json-schema-ref" href="#/definitions/VideoAbuse">VideoAbuse</a>
+ <a class="json-schema-ref" href="#/definitions/VideoChannel">VideoChannel</a>
</span>
</div>
<!-- <span class="swagger-global"></span> <span class="json-schema-reference"><a href=""></a></span> -->
<p>successful operation</p>
</div>
</div>
+ <div class="prop-row prop-inner">
+ <div class="prop-name">type</div>
+ <div class="prop-value">
+ <span class="json-property-type">
+ <span class="json-schema-ref-array">
+ <a class="json-schema-ref" href="#/definitions/VideoChannel">VideoChannel</a>
+ </span>
+ </span>
+ <span class="json-property-range" title="Value limits"></span>
+ </div>
+ </div>
</section>
</div>
<div class="doc-examples">
</h5>
<!-- <div class="hljs"> --><pre><code class="hljs lang-json">[
{
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"reason"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"reporterAccount"</span>: {
- <span class="hljs-attr">"displayName"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"displayName"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"description"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"isLocal"</span>: <span class="hljs-string">"boolean"</span>,
+ <span class="hljs-attr">"ownerAccount"</span>: {
<span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"url"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"name"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"host"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"followingCount"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"followersCount"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"avatar"</span>: {
- <span class="hljs-attr">"path"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>
- }
- },
- <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>
+ <span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>
+ }
}
]
</code></pre>
</div>
</div>
</div>
- <div id="operation--videos--id--abuse-post" class="operation panel" data-traverse-target="operation--videos--id--abuse-post">
+ <div id="operation--video-channels-post" class="operation panel" data-traverse-target="operation--video-channels-post">
<!-- <section class="operation-tags row"> -->
<!-- <div class="doc-copy"> -->
<div class="operation-tags">
- <a class="label" href="#tag-VideoAbuse">VideoAbuse</a>
+ <a class="label" href="#tag-VideoChannel">VideoChannel</a>
<!---->
</div>
<!-- </div> -->
<!-- </section> -->
<h2 class="operation-title">
- <span class="operation-name">
- <span class="operation-name">POST</span>
- <span class="operation-path">/videos/{id}/abuse</span>
- </span>
+ <span class="operation-summary">Creates a video channel for the current user</span>
</h2>
<div class="doc-row">
<div class="doc-copy">
- <section class="swagger-request-params">
- <div class="prop-row prop-group">
+ <section class="swagger-operation-path">
+ <span class="operation-method">POST</span>
+ <span class="operation-path">/video-channels</span>
+ </section>
+ </div>
+ </div>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-request-body">
+ <div class="prop-row">
<div class="prop-name">
- <div class="prop-title">id</div>
- <span class="json-property-required"></span>
- </div>
- <div class="prop-value">
- <p>The video id </p>
+ <div class="swagger-request-model">
+ <span class="">
+ <a class="json-schema-ref" href="#/definitions/VideoChannelInput">VideoChannelInput</a>
+ </span>
+ </div>
</div>
- </div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
- <div class="prop-value">
- <span class="json-property-type">string</span>
- <span class="json-property-range" title="Value limits"></span>
+ <div class="prop-value columns small-6">
+ <!-- <div class="swagger-request-description"> -->
+ <p>undefined</p>
+ <!-- </div> -->
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">path</div>
- </div>
</section>
</div>
- <div class="doc-examples"></div>
+ <div class="doc-examples">
+ <section>
+ <h5>Request Content-Types:
+ <span>application/json</span>
+ </h5>
+ <h5>Request Example</h5>
+ <!-- <div class="hljs"> --><pre><code class="hljs lang-json">{
+ <span class="hljs-attr">"name"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"description"</span>: <span class="hljs-string">"string"</span>
+}
+</code></pre>
+ <!-- </div> -->
+ </section>
+ </div>
</div>
<div class="doc-row">
<div class="doc-copy">
<div class="prop-title">204 No Content</div>
</div>
<div class="prop-value">
- <p>successful operation</p>
+ <p>Successful operation</p>
</div>
</div>
</section>
</h5>
</div>
</div>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-request-security">
+ <table class="table">
+ <thead>
+ <tr>
+ <th class="swagger-request-security-schema"></th>
+ <th class="swagger-request-security-scopes"></th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>
+ <a href="#security-definition-OAuth2">OAuth2</a>
+ </td>
+ <td> </td>
+ </tr>
+ </tbody>
+ </table>
+ </section>
+ </div>
+ </div>
</div>
- <h1 id="tag-VideoBlacklist" class="swagger-summary-tag" data-traverse-target="tag-VideoBlacklist">VideoBlacklist</h1>
- <div id="operation--videos--videoId--blacklist-post" class="operation panel" data-traverse-target="operation--videos--videoId--blacklist-post">
+ <div id="operation--video-channels--id--get" class="operation panel" data-traverse-target="operation--video-channels--id--get">
<!-- <section class="operation-tags row"> -->
<!-- <div class="doc-copy"> -->
<div class="operation-tags">
- <a class="label" href="#tag-VideoBlacklist">VideoBlacklist</a>
+ <a class="label" href="#tag-VideoChannel">VideoChannel</a>
<!---->
</div>
<!-- </div> -->
<!-- </section> -->
<h2 class="operation-title">
- <span class="operation-name">
- <span class="operation-name">POST</span>
- <span class="operation-path">/videos/{videoId}/blacklist</span>
- </span>
+ <span class="operation-summary">Get a video channel by its id</span>
</h2>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-operation-path">
+ <span class="operation-method">GET</span>
+ <span class="operation-path">/video-channels/{id}</span>
+ </section>
+ </div>
+ </div>
<div class="doc-row">
<div class="doc-copy">
<section class="swagger-request-params">
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">videoId</div>
+ <div class="prop-title">id:
+ <span class="prop-type">
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
<span class="json-property-required"></span>
+ <div class="prop-subtitle"> in path </div>
</div>
<div class="prop-value">
- <p>The video id </p>
+ <p>The video channel id or uuid</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
- <div class="prop-value">
- <span class="json-property-type">string</span>
- <span class="json-property-range" title="Value limits"></span>
- </div>
- </div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">path</div>
- </div>
</section>
</div>
<div class="doc-examples"></div>
<section class="swagger-responses">
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">204 No Content</div>
+ <div class="prop-title">200 OK</div>
+ <div class="prop-ref">
+ <span class="">
+ <a class="json-schema-ref" href="#/definitions/VideoChannel">VideoChannel</a>
+ </span>
+ </div>
+ <!-- <span class="swagger-global"></span> <span class="json-schema-reference"><a href=""></a></span> -->
</div>
<div class="prop-value">
<p>successful operation</p>
<h5>Response Content-Types:
<span>application/json</span>
</h5>
+ <section>
+ <h5>Response Example
+ <span>(200 OK)</span>
+ </h5>
+ <!-- <div class="hljs"> --><pre><code class="hljs lang-json">{
+ <span class="hljs-attr">"displayName"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"description"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"isLocal"</span>: <span class="hljs-string">"boolean"</span>,
+ <span class="hljs-attr">"ownerAccount"</span>: {
+ <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>
+ }
+}
+</code></pre>
+ <!-- </div> -->
+ </section>
</div>
</div>
</div>
- <div id="operation--videos--videoId--blacklist-delete" class="operation panel" data-traverse-target="operation--videos--videoId--blacklist-delete">
+ <div id="operation--video-channels--id--put" class="operation panel" data-traverse-target="operation--video-channels--id--put">
<!-- <section class="operation-tags row"> -->
<!-- <div class="doc-copy"> -->
<div class="operation-tags">
- <a class="label" href="#tag-VideoBlacklist">VideoBlacklist</a>
+ <a class="label" href="#tag-VideoChannel">VideoChannel</a>
<!---->
</div>
<!-- </div> -->
<!-- </section> -->
<h2 class="operation-title">
- <span class="operation-name">
- <span class="operation-name">DELETE</span>
- <span class="operation-path">/videos/{videoId}/blacklist</span>
- </span>
+ <span class="operation-summary">Update a video channel by its id</span>
</h2>
<div class="doc-row">
<div class="doc-copy">
+ <section class="swagger-operation-path">
+ <span class="operation-method">PUT</span>
+ <span class="operation-path">/video-channels/{id}</span>
+ </section>
+ </div>
+ </div>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-request-body">
+ <div class="prop-row">
+ <div class="prop-name">
+ <div class="swagger-request-model">
+ <span class="">
+ <a class="json-schema-ref" href="#/definitions/VideoChannelInput">VideoChannelInput</a>
+ </span>
+ </div>
+ </div>
+ <div class="prop-value columns small-6">
+ <!-- <div class="swagger-request-description"> -->
+ <p>undefined</p>
+ <!-- </div> -->
+ </div>
+ </div>
+ </section>
<section class="swagger-request-params">
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">videoId</div>
+ <div class="prop-title">id:
+ <span class="prop-type">
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
<span class="json-property-required"></span>
+ <div class="prop-subtitle"> in path </div>
</div>
<div class="prop-value">
- <p>The video id </p>
- </div>
- </div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
- <div class="prop-value">
- <span class="json-property-type">string</span>
- <span class="json-property-range" title="Value limits"></span>
+ <p>The video channel id or uuid</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">path</div>
- </div>
</section>
</div>
- <div class="doc-examples"></div>
+ <div class="doc-examples">
+ <section>
+ <h5>Request Content-Types:
+ <span>application/json</span>
+ </h5>
+ <h5>Request Example</h5>
+ <!-- <div class="hljs"> --><pre><code class="hljs lang-json">{
+ <span class="hljs-attr">"name"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"description"</span>: <span class="hljs-string">"string"</span>
+}
+</code></pre>
+ <!-- </div> -->
+ </section>
+ </div>
</div>
<div class="doc-row">
<div class="doc-copy">
<div class="prop-title">204 No Content</div>
</div>
<div class="prop-value">
- <p>successful operation</p>
+ <p>Successful operation</p>
</div>
</div>
</section>
</h5>
</div>
</div>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-request-security">
+ <table class="table">
+ <thead>
+ <tr>
+ <th class="swagger-request-security-schema"></th>
+ <th class="swagger-request-security-scopes"></th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>
+ <a href="#security-definition-OAuth2">OAuth2</a>
+ </td>
+ <td> </td>
+ </tr>
+ </tbody>
+ </table>
+ </section>
+ </div>
+ </div>
</div>
- <div id="operation--videos-blacklist-get" class="operation panel" data-traverse-target="operation--videos-blacklist-get">
+ <div id="operation--video-channels--id--delete" class="operation panel" data-traverse-target="operation--video-channels--id--delete">
<!-- <section class="operation-tags row"> -->
<!-- <div class="doc-copy"> -->
<div class="operation-tags">
- <a class="label" href="#tag-VideoBlacklist">VideoBlacklist</a>
+ <a class="label" href="#tag-VideoChannel">VideoChannel</a>
<!---->
</div>
<!-- </div> -->
<!-- </section> -->
<h2 class="operation-title">
- <span class="operation-name">
- <span class="operation-name">GET</span>
- <span class="operation-path">/videos/blacklist</span>
- </span>
+ <span class="operation-summary">Delete a video channel by its id</span>
</h2>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-operation-path">
+ <span class="operation-method">DELETE</span>
+ <span class="operation-path">/video-channels/{id}</span>
+ </section>
+ </div>
+ </div>
<div class="doc-row">
<div class="doc-copy">
<section class="swagger-request-params">
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">start</div>
- </div>
- <div class="prop-value">
- <p>starting page</p>
+ <div class="prop-title">id:
+ <span class="prop-type">
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <span class="json-property-required"></span>
+ <div class="prop-subtitle"> in path </div>
</div>
- </div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
<div class="prop-value">
- <span class="json-property-type">number</span>
- <span class="json-property-range" title="Value limits"></span>
+ <p>The video channel id or uuid</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">query</div>
- </div>
+ </section>
+ </div>
+ <div class="doc-examples"></div>
+ </div>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-responses">
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">stop</div>
- </div>
- <div class="prop-value">
- <p>stopping page</p>
+ <div class="prop-title">204 No Content</div>
</div>
- </div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
<div class="prop-value">
- <span class="json-property-type">number</span>
- <span class="json-property-range" title="Value limits"></span>
+ <p>Successful operation</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">query</div>
- </div>
+ </section>
+ </div>
+ <div class="doc-examples">
+ <h5>Response Content-Types:
+ <span>application/json</span>
+ </h5>
+ </div>
+ </div>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-request-security">
+ <table class="table">
+ <thead>
+ <tr>
+ <th class="swagger-request-security-schema"></th>
+ <th class="swagger-request-security-scopes"></th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>
+ <a href="#security-definition-OAuth2">OAuth2</a>
+ </td>
+ <td> </td>
+ </tr>
+ </tbody>
+ </table>
+ </section>
+ </div>
+ </div>
+ </div>
+ <div id="operation--video-channels--id--videos-get" class="operation panel" data-traverse-target="operation--video-channels--id--videos-get">
+ <!-- <section class="operation-tags row"> -->
+ <!-- <div class="doc-copy"> -->
+ <div class="operation-tags">
+ <a class="label" href="#tag-VideoChannel">VideoChannel</a>
+ <!---->
+ </div>
+ <!-- </div> -->
+ <!-- </section> -->
+ <h2 class="operation-title">
+ <span class="operation-summary">Get videos of a video channel by its id</span>
+ </h2>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-operation-path">
+ <span class="operation-method">GET</span>
+ <span class="operation-path">/video-channels/{id}/videos</span>
+ </section>
+ </div>
+ </div>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-request-params">
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">sort</div>
- </div>
- <div class="prop-value">
- <p>sorting</p>
+ <div class="prop-title">id:
+ <span class="prop-type">
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <span class="json-property-required"></span>
+ <div class="prop-subtitle"> in path </div>
</div>
- </div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
<div class="prop-value">
- <span class="json-property-type">number</span>
- <span class="json-property-range" title="Value limits"></span>
+ <p>The video channel id or uuid</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">query</div>
- </div>
</section>
</div>
<div class="doc-examples"></div>
<div class="prop-name">
<div class="prop-title">200 OK</div>
<div class="prop-ref">
- <span class="json-schema-ref-array">
- <a class="json-schema-ref" href="#/definitions/VideoBlacklist">VideoBlacklist</a>
+ <span class="">
+ <a class="json-schema-ref" href="#/definitions/Video">Video</a>
</span>
</div>
<!-- <span class="swagger-global"></span> <span class="json-schema-reference"><a href=""></a></span> -->
<h5>Response Example
<span>(200 OK)</span>
</h5>
- <!-- <div class="hljs"> --><pre><code class="hljs lang-json">[
- {
+ <!-- <div class="hljs"> --><pre><code class="hljs lang-json">{
+ <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"publishedAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"category"</span>: {
<span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"videoId"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
+ },
+ <span class="hljs-attr">"licence"</span>: {
+ <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
+ },
+ <span class="hljs-attr">"language"</span>: {
+ <span class="hljs-attr">"id"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
+ },
+ <span class="hljs-attr">"privacy"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"description"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"duration"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"isLocal"</span>: <span class="hljs-string">"boolean"</span>,
+ <span class="hljs-attr">"name"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"thumbnailPath"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"previewPath"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"embedPath"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"views"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"likes"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"dislikes"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"nsfw"</span>: <span class="hljs-string">"boolean"</span>,
+ <span class="hljs-attr">"account"</span>: {
<span class="hljs-attr">"name"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"description"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"duration"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"views"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"likes"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"dislikes"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"nsfw"</span>: <span class="hljs-string">"boolean"</span>
+ <span class="hljs-attr">"displayName"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"url"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"host"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"avatar"</span>: {
+ <span class="hljs-attr">"path"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>
+ }
}
-]
+}
</code></pre>
<!-- </div> -->
</section>
</div>
</div>
</div>
- <h1 id="tag-VideoChannel" class="swagger-summary-tag" data-traverse-target="tag-VideoChannel">VideoChannel</h1>
- <div id="operation--videos-channels-get" class="operation panel" data-traverse-target="operation--videos-channels-get">
+ <div id="operation--accounts--name--video-channels-get" class="operation panel" data-traverse-target="operation--accounts--name--video-channels-get">
<!-- <section class="operation-tags row"> -->
<!-- <div class="doc-copy"> -->
<div class="operation-tags">
<!-- </div> -->
<!-- </section> -->
<h2 class="operation-title">
- <span class="operation-name">
- <span class="operation-name">GET</span>
- <span class="operation-path">/videos/channels</span>
- </span>
+ <span class="operation-summary">Get video channels of an account by its name</span>
</h2>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-operation-path">
+ <span class="operation-method">GET</span>
+ <span class="operation-path">/accounts/{name}/video-channels</span>
+ </section>
+ </div>
+ </div>
<div class="doc-row">
<div class="doc-copy">
<section class="swagger-request-params">
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">start</div>
- </div>
- <div class="prop-value">
- <p>starting page</p>
+ <div class="prop-title">name:
+ <span class="prop-type">
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <span class="json-property-required"></span>
+ <div class="prop-subtitle"> in path </div>
</div>
- </div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
<div class="prop-value">
- <span class="json-property-type">number</span>
- <span class="json-property-range" title="Value limits"></span>
+ <p>The name of the account (chocobozzz or
+ <a href="mailto:chocobozzz@peertube.cpy.re">chocobozzz@peertube.cpy.re</a> for example)</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">query</div>
- </div>
+ </section>
+ </div>
+ <div class="doc-examples"></div>
+ </div>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-responses">
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">stop</div>
+ <div class="prop-title">200 OK</div>
+ <div class="prop-ref">
+ <span class="json-schema-ref-array">
+ <a class="json-schema-ref" href="#/definitions/VideoChannel">VideoChannel</a>
+ </span>
+ </div>
+ <!-- <span class="swagger-global"></span> <span class="json-schema-reference"><a href=""></a></span> -->
</div>
<div class="prop-value">
- <p>stopping page</p>
+ <p>successful operation</p>
</div>
</div>
<div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
+ <div class="prop-name">type</div>
<div class="prop-value">
- <span class="json-property-type">number</span>
- <span class="json-property-range" title="Value limits"></span>
- </div>
- </div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">query</div>
- </div>
- <div class="prop-row prop-group">
- <div class="prop-name">
- <div class="prop-title">sort</div>
- </div>
- <div class="prop-value">
- <p>sorting</p>
- </div>
- </div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
- <div class="prop-value">
- <span class="json-property-type">number</span>
- <span class="json-property-range" title="Value limits"></span>
- </div>
- </div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">query</div>
- </div>
- </section>
- </div>
- <div class="doc-examples"></div>
- </div>
- <div class="doc-row">
- <div class="doc-copy">
- <section class="swagger-responses">
- <div class="prop-row prop-group">
- <div class="prop-name">
- <div class="prop-title">200 OK</div>
- <div class="prop-ref">
+ <span class="json-property-type">
<span class="json-schema-ref-array">
<a class="json-schema-ref" href="#/definitions/VideoChannel">VideoChannel</a>
</span>
- </div>
- <!-- <span class="swagger-global"></span> <span class="json-schema-reference"><a href=""></a></span> -->
- </div>
- <div class="prop-value">
- <p>successful operation</p>
+ </span>
+ <span class="json-property-range" title="Value limits"></span>
</div>
</div>
</section>
<span class="hljs-attr">"displayName"</span>: <span class="hljs-string">"string"</span>,
<span class="hljs-attr">"description"</span>: <span class="hljs-string">"string"</span>,
<span class="hljs-attr">"isLocal"</span>: <span class="hljs-string">"boolean"</span>,
- <span class="hljs-attr">"owner"</span>: {
- <span class="hljs-attr">"name"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"ownerAccount"</span>: {
+ <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
<span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>
- },
- <span class="hljs-attr">"videos"</span>: [
- {
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"category"</span>: {
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
- },
- <span class="hljs-attr">"licence"</span>: {
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
- },
- <span class="hljs-attr">"language"</span>: {
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
- },
- <span class="hljs-attr">"description"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"duration"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"isLocal"</span>: <span class="hljs-string">"boolean"</span>,
- <span class="hljs-attr">"name"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"thumbnailPath"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"previewPath"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"embedPath"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"views"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"likes"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"dislikes"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"nsfw"</span>: <span class="hljs-string">"boolean"</span>
- }
- ]
+ }
}
]
</code></pre>
</div>
</div>
</div>
- <div id="operation--videos-channels-post" class="operation panel" data-traverse-target="operation--videos-channels-post">
+ <h1 id="tag-User" class="swagger-summary-tag" data-traverse-target="tag-User">User</h1>
+ <div id="operation--users-post" class="operation panel" data-traverse-target="operation--users-post">
<!-- <section class="operation-tags row"> -->
<!-- <div class="doc-copy"> -->
<div class="operation-tags">
- <a class="label" href="#tag-VideoChannel">VideoChannel</a>
+ <a class="label" href="#tag-User">User</a>
<!---->
</div>
<!-- </div> -->
<!-- </section> -->
<h2 class="operation-title">
- <span class="operation-name">
- <span class="operation-name">POST</span>
- <span class="operation-path">/videos/channels</span>
- </span>
+ <span class="operation-summary">Creates user</span>
</h2>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-operation-path">
+ <span class="operation-method">POST</span>
+ <span class="operation-path">/users</span>
+ </section>
+ </div>
+ </div>
<div class="doc-row">
<div class="doc-copy">
<section class="swagger-request-body">
<div class="prop-name">
<div class="swagger-request-model">
<span class="">
- <a class="json-schema-ref" href="#/definitions/VideoChannelInput">VideoChannelInput</a>
+ <a class="json-schema-ref" href="#/definitions/AddUser">AddUser</a>
</span>
</div>
</div>
<div class="prop-value columns small-6">
- <!-- <div class="swagger-request-description"> -->undefined
+ <!-- <div class="swagger-request-description"> -->
+ <p>User to create</p>
<!-- </div> -->
</div>
</div>
</h5>
<h5>Request Example</h5>
<!-- <div class="hljs"> --><pre><code class="hljs lang-json">{
- <span class="hljs-attr">"name"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"description"</span>: <span class="hljs-string">"string"</span>
+ <span class="hljs-attr">"username"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"password"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"email"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"videoQuota"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"role"</span>: <span class="hljs-string">"string"</span>
}
</code></pre>
<!-- </div> -->
<section class="swagger-responses">
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">204 No Content</div>
+ <div class="prop-title">200 OK</div>
+ <div class="prop-ref">
+ <span class="">
+ <a class="json-schema-ref" href="#/definitions/AddUserResponse">AddUserResponse</a>
+ </span>
+ </div>
+ <!-- <span class="swagger-global"></span> <span class="json-schema-reference"><a href=""></a></span> -->
</div>
<div class="prop-value">
<p>successful operation</p>
<h5>Response Content-Types:
<span>application/json</span>
</h5>
+ <section>
+ <h5>Response Example
+ <span>(200 OK)</span>
+ </h5>
+ <!-- <div class="hljs"> --><pre><code class="hljs lang-json">{
+ <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>
+}
+</code></pre>
+ <!-- </div> -->
+ </section>
+ </div>
+ </div>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-request-security">
+ <table class="table">
+ <thead>
+ <tr>
+ <th class="swagger-request-security-schema"></th>
+ <th class="swagger-request-security-scopes"></th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>
+ <a href="#security-definition-OAuth2">OAuth2</a>
+ </td>
+ <td>
+ <a href="#security-definition-scope-admin">admin</a>
+ </td>
+ </tr>
+ </tbody>
+ </table>
+ </section>
</div>
</div>
</div>
- <div id="operation--videos-channels--id--get" class="operation panel" data-traverse-target="operation--videos-channels--id--get">
+ <div id="operation--users-get" class="operation panel" data-traverse-target="operation--users-get">
<!-- <section class="operation-tags row"> -->
<!-- <div class="doc-copy"> -->
<div class="operation-tags">
- <a class="label" href="#tag-VideoChannel">VideoChannel</a>
+ <a class="label" href="#tag-User">User</a>
<!---->
</div>
<!-- </div> -->
<!-- </section> -->
<h2 class="operation-title">
- <span class="operation-name">
- <span class="operation-name">GET</span>
- <span class="operation-path">/videos/channels/{id}</span>
- </span>
+ <span class="operation-summary">Get a list of users</span>
</h2>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-operation-path">
+ <span class="operation-method">GET</span>
+ <span class="operation-path">/users</span>
+ </section>
+ </div>
+ </div>
<div class="doc-row">
<div class="doc-copy">
<section class="swagger-request-params">
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">id</div>
- <span class="json-property-required"></span>
+ <div class="prop-title">start:
+ <span class="prop-type">
+ <span class="json-property-type">number</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in query </div>
</div>
<div class="prop-value">
- <p>The video id </p>
+ <p>Offset</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
+ <div class="prop-row prop-group">
+ <div class="prop-name">
+ <div class="prop-title">count:
+ <span class="prop-type">
+ <span class="json-property-type">number</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in query </div>
+ </div>
<div class="prop-value">
- <span class="json-property-type">string</span>
- <span class="json-property-range" title="Value limits"></span>
+ <p>Number of items</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">path</div>
+ <div class="prop-row prop-group">
+ <div class="prop-name">
+ <div class="prop-title">sort:
+ <span class="prop-type">
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in query </div>
+ </div>
+ <div class="prop-value">
+ <p>Sort column (-createdAt for example)</p>
+ </div>
</div>
</section>
</div>
<div class="prop-name">
<div class="prop-title">200 OK</div>
<div class="prop-ref">
- <span class="">
- <a class="json-schema-ref" href="#/definitions/VideoChannel">VideoChannel</a>
+ <span class="json-schema-ref-array">
+ <a class="json-schema-ref" href="#/definitions/User">User</a>
</span>
</div>
<!-- <span class="swagger-global"></span> <span class="json-schema-reference"><a href=""></a></span> -->
<p>successful operation</p>
</div>
</div>
+ <div class="prop-row prop-inner">
+ <div class="prop-name">type</div>
+ <div class="prop-value">
+ <span class="json-property-type">
+ <span class="json-schema-ref-array">
+ <a class="json-schema-ref" href="#/definitions/User">User</a>
+ </span>
+ </span>
+ <span class="json-property-range" title="Value limits"></span>
+ </div>
+ </div>
</section>
</div>
<div class="doc-examples">
<h5>Response Example
<span>(200 OK)</span>
</h5>
- <!-- <div class="hljs"> --><pre><code class="hljs lang-json">{
- <span class="hljs-attr">"displayName"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"description"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"isLocal"</span>: <span class="hljs-string">"boolean"</span>,
- <span class="hljs-attr">"owner"</span>: {
- <span class="hljs-attr">"name"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>
- },
- <span class="hljs-attr">"videos"</span>: [
- {
+ <!-- <div class="hljs"> --><pre><code class="hljs lang-json">[
+ {
+ <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"username"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"email"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"displayNSFW"</span>: <span class="hljs-string">"boolean"</span>,
+ <span class="hljs-attr">"autoPlayVideo"</span>: <span class="hljs-string">"boolean"</span>,
+ <span class="hljs-attr">"role"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"videoQuota"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"account"</span>: {
+ <span class="hljs-attr">"displayName"</span>: <span class="hljs-string">"string"</span>,
<span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
<span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"url"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"name"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"host"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"followingCount"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"followersCount"</span>: <span class="hljs-string">"number"</span>,
<span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
<span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"category"</span>: {
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
- },
- <span class="hljs-attr">"licence"</span>: {
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
- },
- <span class="hljs-attr">"language"</span>: {
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
- },
- <span class="hljs-attr">"description"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"duration"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"isLocal"</span>: <span class="hljs-string">"boolean"</span>,
- <span class="hljs-attr">"name"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"thumbnailPath"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"previewPath"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"embedPath"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"views"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"likes"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"dislikes"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"nsfw"</span>: <span class="hljs-string">"boolean"</span>
- }
- ]
-}
+ <span class="hljs-attr">"avatar"</span>: {
+ <span class="hljs-attr">"path"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>
+ }
+ },
+ <span class="hljs-attr">"videoChannels"</span>: [
+ {
+ <span class="hljs-attr">"displayName"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"description"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"isLocal"</span>: <span class="hljs-string">"boolean"</span>,
+ <span class="hljs-attr">"ownerAccount"</span>: {
+ <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>
+ }
+ }
+ ]
+ }
+]
</code></pre>
<!-- </div> -->
</section>
</div>
</div>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-request-security">
+ <table class="table">
+ <thead>
+ <tr>
+ <th class="swagger-request-security-schema"></th>
+ <th class="swagger-request-security-scopes"></th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>
+ <a href="#security-definition-OAuth2">OAuth2</a>
+ </td>
+ <td> </td>
+ </tr>
+ </tbody>
+ </table>
+ </section>
+ </div>
+ </div>
</div>
- <div id="operation--videos-channels--id--put" class="operation panel" data-traverse-target="operation--videos-channels--id--put">
+ <div id="operation--users--id--delete" class="operation panel" data-traverse-target="operation--users--id--delete">
<!-- <section class="operation-tags row"> -->
<!-- <div class="doc-copy"> -->
<div class="operation-tags">
- <a class="label" href="#tag-VideoChannel">VideoChannel</a>
+ <a class="label" href="#tag-User">User</a>
<!---->
</div>
<!-- </div> -->
<!-- </section> -->
<h2 class="operation-title">
- <span class="operation-name">
- <span class="operation-name">PUT</span>
- <span class="operation-path">/videos/channels/{id}</span>
- </span>
+ <span class="operation-summary">Delete a user by its id</span>
</h2>
<div class="doc-row">
<div class="doc-copy">
- <section class="swagger-request-body">
- <div class="prop-row">
- <div class="prop-name">
- <div class="swagger-request-model">
- <span class="">
- <a class="json-schema-ref" href="#/definitions/VideoChannelInput">VideoChannelInput</a>
- </span>
- </div>
- </div>
- <div class="prop-value columns small-6">
- <!-- <div class="swagger-request-description"> -->undefined
- <!-- </div> -->
- </div>
- </div>
+ <section class="swagger-operation-path">
+ <span class="operation-method">DELETE</span>
+ <span class="operation-path">/users/{id}</span>
</section>
+ </div>
+ </div>
+ <div class="doc-row">
+ <div class="doc-copy">
<section class="swagger-request-params">
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">id</div>
+ <div class="prop-title">id:
+ <span class="prop-type">
+ <span class="json-property-type">number</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
<span class="json-property-required"></span>
+ <div class="prop-subtitle"> in path </div>
</div>
<div class="prop-value">
- <p>The video id </p>
- </div>
- </div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
- <div class="prop-value">
- <span class="json-property-type">string</span>
- <span class="json-property-range" title="Value limits"></span>
+ <p>The user id</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">path</div>
- </div>
- </section>
- </div>
- <div class="doc-examples">
- <section>
- <h5>Request Content-Types:
- <span>application/json</span>
- </h5>
- <h5>Request Example</h5>
- <!-- <div class="hljs"> --><pre><code class="hljs lang-json">{
- <span class="hljs-attr">"name"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"description"</span>: <span class="hljs-string">"string"</span>
-}
-</code></pre>
- <!-- </div> -->
</section>
</div>
+ <div class="doc-examples"></div>
</div>
<div class="doc-row">
<div class="doc-copy">
<div class="prop-title">204 No Content</div>
</div>
<div class="prop-value">
- <p>successful operation</p>
+ <p>Successful operation</p>
</div>
</div>
</section>
</h5>
</div>
</div>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-request-security">
+ <table class="table">
+ <thead>
+ <tr>
+ <th class="swagger-request-security-schema"></th>
+ <th class="swagger-request-security-scopes"></th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>
+ <a href="#security-definition-OAuth2">OAuth2</a>
+ </td>
+ <td>
+ <a href="#security-definition-scope-admin">admin</a>
+ </td>
+ </tr>
+ </tbody>
+ </table>
+ </section>
+ </div>
+ </div>
</div>
- <div id="operation--videos-channels--id--delete" class="operation panel" data-traverse-target="operation--videos-channels--id--delete">
+ <div id="operation--users--id--get" class="operation panel" data-traverse-target="operation--users--id--get">
<!-- <section class="operation-tags row"> -->
<!-- <div class="doc-copy"> -->
<div class="operation-tags">
- <a class="label" href="#tag-VideoChannel">VideoChannel</a>
+ <a class="label" href="#tag-User">User</a>
<!---->
</div>
<!-- </div> -->
<!-- </section> -->
<h2 class="operation-title">
- <span class="operation-name">
- <span class="operation-name">DELETE</span>
- <span class="operation-path">/videos/channels/{id}</span>
- </span>
+ <span class="operation-summary">Get user by its id</span>
</h2>
<div class="doc-row">
<div class="doc-copy">
- <section class="swagger-request-params">
+ <section class="swagger-operation-path">
+ <span class="operation-method">GET</span>
+ <span class="operation-path">/users/{id}</span>
+ </section>
+ </div>
+ </div>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-request-params">
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">id</div>
+ <div class="prop-title">id:
+ <span class="prop-type">
+ <span class="json-property-type">number</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
<span class="json-property-required"></span>
+ <div class="prop-subtitle"> in path </div>
</div>
<div class="prop-value">
- <p>The video id </p>
- </div>
- </div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
- <div class="prop-value">
- <span class="json-property-type">string</span>
- <span class="json-property-range" title="Value limits"></span>
+ <p>The user id</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">path</div>
- </div>
</section>
</div>
<div class="doc-examples"></div>
<section class="swagger-responses">
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">204 No Content</div>
+ <div class="prop-title">200 OK</div>
+ <div class="prop-ref">
+ <span class="">
+ <a class="json-schema-ref" href="#/definitions/User">User</a>
+ </span>
+ </div>
+ <!-- <span class="swagger-global"></span> <span class="json-schema-reference"><a href=""></a></span> -->
</div>
<div class="prop-value">
<p>successful operation</p>
<h5>Response Content-Types:
<span>application/json</span>
</h5>
+ <section>
+ <h5>Response Example
+ <span>(200 OK)</span>
+ </h5>
+ <!-- <div class="hljs"> --><pre><code class="hljs lang-json">{
+ <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"username"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"email"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"displayNSFW"</span>: <span class="hljs-string">"boolean"</span>,
+ <span class="hljs-attr">"autoPlayVideo"</span>: <span class="hljs-string">"boolean"</span>,
+ <span class="hljs-attr">"role"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"videoQuota"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"account"</span>: {
+ <span class="hljs-attr">"displayName"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"url"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"name"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"host"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"followingCount"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"followersCount"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"avatar"</span>: {
+ <span class="hljs-attr">"path"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>
+ }
+ },
+ <span class="hljs-attr">"videoChannels"</span>: [
+ {
+ <span class="hljs-attr">"displayName"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"description"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"isLocal"</span>: <span class="hljs-string">"boolean"</span>,
+ <span class="hljs-attr">"ownerAccount"</span>: {
+ <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>
+ }
+ }
+ ]
+}
+</code></pre>
+ <!-- </div> -->
+ </section>
+ </div>
+ </div>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-request-security">
+ <table class="table">
+ <thead>
+ <tr>
+ <th class="swagger-request-security-schema"></th>
+ <th class="swagger-request-security-scopes"></th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>
+ <a href="#security-definition-OAuth2">OAuth2</a>
+ </td>
+ <td> </td>
+ </tr>
+ </tbody>
+ </table>
+ </section>
</div>
</div>
</div>
- <div id="operation--videos-accounts--accountId--channels-get" class="operation panel" data-traverse-target="operation--videos-accounts--accountId--channels-get">
+ <div id="operation--users--id--put" class="operation panel" data-traverse-target="operation--users--id--put">
<!-- <section class="operation-tags row"> -->
<!-- <div class="doc-copy"> -->
<div class="operation-tags">
- <a class="label" href="#tag-VideoChannel">VideoChannel</a>
+ <a class="label" href="#tag-User">User</a>
<!---->
</div>
<!-- </div> -->
<!-- </section> -->
<h2 class="operation-title">
- <span class="operation-name">
- <span class="operation-name">GET</span>
- <span class="operation-path">/videos/accounts/{accountId}/channels</span>
- </span>
+ <span class="operation-summary">Update user profile by its id</span>
</h2>
<div class="doc-row">
<div class="doc-copy">
+ <section class="swagger-operation-path">
+ <span class="operation-method">PUT</span>
+ <span class="operation-path">/users/{id}</span>
+ </section>
+ </div>
+ </div>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-request-body">
+ <div class="prop-row">
+ <div class="prop-name">
+ <div class="swagger-request-model">
+ <span class="">
+ <a class="json-schema-ref" href="#/definitions/UpdateUser">UpdateUser</a>
+ </span>
+ </div>
+ </div>
+ <div class="prop-value columns small-6">
+ <!-- <div class="swagger-request-description"> -->
+ <p>undefined</p>
+ <!-- </div> -->
+ </div>
+ </div>
+ </section>
<section class="swagger-request-params">
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">accountId</div>
+ <div class="prop-title">id:
+ <span class="prop-type">
+ <span class="json-property-type">number</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
<span class="json-property-required"></span>
+ <div class="prop-subtitle"> in path </div>
</div>
<div class="prop-value">
- <p>The account id </p>
+ <p>The user id</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
+ </section>
+ </div>
+ <div class="doc-examples">
+ <section>
+ <h5>Request Content-Types:
+ <span>application/json</span>
+ </h5>
+ <h5>Request Example</h5>
+ <!-- <div class="hljs"> --><pre><code class="hljs lang-json">{
+ <span class="hljs-attr">"id"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"email"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"videoQuota"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"role"</span>: <span class="hljs-string">"string"</span>
+}
+</code></pre>
+ <!-- </div> -->
+ </section>
+ </div>
+ </div>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-responses">
+ <div class="prop-row prop-group">
+ <div class="prop-name">
+ <div class="prop-title">204 No Content</div>
+ </div>
<div class="prop-value">
- <span class="json-property-type">string</span>
- <span class="json-property-range" title="Value limits"></span>
+ <p>Successful operation</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">path</div>
- </div>
</section>
</div>
+ <div class="doc-examples">
+ <h5>Response Content-Types:
+ <span>application/json</span>
+ </h5>
+ </div>
+ </div>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-request-security">
+ <table class="table">
+ <thead>
+ <tr>
+ <th class="swagger-request-security-schema"></th>
+ <th class="swagger-request-security-scopes"></th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>
+ <a href="#security-definition-OAuth2">OAuth2</a>
+ </td>
+ <td> </td>
+ </tr>
+ </tbody>
+ </table>
+ </section>
+ </div>
+ </div>
+ </div>
+ <div id="operation--users-me-get" class="operation panel" data-traverse-target="operation--users-me-get">
+ <!-- <section class="operation-tags row"> -->
+ <!-- <div class="doc-copy"> -->
+ <div class="operation-tags">
+ <a class="label" href="#tag-User">User</a>
+ <!---->
+ </div>
+ <!-- </div> -->
+ <!-- </section> -->
+ <h2 class="operation-title">
+ <span class="operation-summary">Get current user information</span>
+ </h2>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-operation-path">
+ <span class="operation-method">GET</span>
+ <span class="operation-path">/users/me</span>
+ </section>
+ </div>
+ </div>
+ <div class="doc-row">
+ <div class="doc-copy"> </div>
<div class="doc-examples"></div>
</div>
<div class="doc-row">
<div class="prop-title">200 OK</div>
<div class="prop-ref">
<span class="json-schema-ref-array">
- <a class="json-schema-ref" href="#/definitions/VideoChannel">VideoChannel</a>
+ <a class="json-schema-ref" href="#/definitions/User">User</a>
</span>
</div>
<!-- <span class="swagger-global"></span> <span class="json-schema-reference"><a href=""></a></span> -->
<p>successful operation</p>
</div>
</div>
+ <div class="prop-row prop-inner">
+ <div class="prop-name">type</div>
+ <div class="prop-value">
+ <span class="json-property-type">
+ <span class="json-schema-ref-array">
+ <a class="json-schema-ref" href="#/definitions/User">User</a>
+ </span>
+ </span>
+ <span class="json-property-range" title="Value limits"></span>
+ </div>
+ </div>
</section>
</div>
<div class="doc-examples">
</h5>
<!-- <div class="hljs"> --><pre><code class="hljs lang-json">[
{
- <span class="hljs-attr">"displayName"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"description"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"isLocal"</span>: <span class="hljs-string">"boolean"</span>,
- <span class="hljs-attr">"owner"</span>: {
+ <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"username"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"email"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"displayNSFW"</span>: <span class="hljs-string">"boolean"</span>,
+ <span class="hljs-attr">"autoPlayVideo"</span>: <span class="hljs-string">"boolean"</span>,
+ <span class="hljs-attr">"role"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"videoQuota"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"account"</span>: {
+ <span class="hljs-attr">"displayName"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"url"</span>: <span class="hljs-string">"string"</span>,
<span class="hljs-attr">"name"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>
+ <span class="hljs-attr">"host"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"followingCount"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"followersCount"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"avatar"</span>: {
+ <span class="hljs-attr">"path"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>
+ }
},
- <span class="hljs-attr">"videos"</span>: [
+ <span class="hljs-attr">"videoChannels"</span>: [
{
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"category"</span>: {
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
- },
- <span class="hljs-attr">"licence"</span>: {
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
- },
- <span class="hljs-attr">"language"</span>: {
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
- },
+ <span class="hljs-attr">"displayName"</span>: <span class="hljs-string">"string"</span>,
<span class="hljs-attr">"description"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"duration"</span>: <span class="hljs-string">"number"</span>,
<span class="hljs-attr">"isLocal"</span>: <span class="hljs-string">"boolean"</span>,
- <span class="hljs-attr">"name"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"thumbnailPath"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"previewPath"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"embedPath"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"views"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"likes"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"dislikes"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"nsfw"</span>: <span class="hljs-string">"boolean"</span>
+ <span class="hljs-attr">"ownerAccount"</span>: {
+ <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>
+ }
}
]
}
</section>
</div>
</div>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-request-security">
+ <table class="table">
+ <thead>
+ <tr>
+ <th class="swagger-request-security-schema"></th>
+ <th class="swagger-request-security-scopes"></th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>
+ <a href="#security-definition-OAuth2">OAuth2</a>
+ </td>
+ <td> </td>
+ </tr>
+ </tbody>
+ </table>
+ </section>
+ </div>
+ </div>
</div>
- <h1 id="tag-VideoComment" class="swagger-summary-tag" data-traverse-target="tag-VideoComment">VideoComment</h1>
- <div id="operation--videos--videoId--comment-threads-get" class="operation panel" data-traverse-target="operation--videos--videoId--comment-threads-get">
+ <div id="operation--users-me-put" class="operation panel" data-traverse-target="operation--users-me-put">
<!-- <section class="operation-tags row"> -->
<!-- <div class="doc-copy"> -->
<div class="operation-tags">
- <a class="label" href="#tag-VideoComment">VideoComment</a>
+ <a class="label" href="#tag-User">User</a>
<!---->
</div>
<!-- </div> -->
<!-- </section> -->
<h2 class="operation-title">
- <span class="operation-name">
- <span class="operation-name">GET</span>
- <span class="operation-path">/videos/{videoId}/comment-threads</span>
- </span>
+ <span class="operation-summary">Update current user information</span>
</h2>
<div class="doc-row">
<div class="doc-copy">
- <section class="swagger-request-params">
- <div class="prop-row prop-group">
- <div class="prop-name">
- <div class="prop-title">videoId</div>
- <span class="json-property-required"></span>
- </div>
- <div class="prop-value">
- <p>The video id </p>
- </div>
- </div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
- <div class="prop-value">
- <span class="json-property-type">string</span>
- <span class="json-property-range" title="Value limits"></span>
- </div>
- </div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">path</div>
- </div>
- <div class="prop-row prop-group">
+ <section class="swagger-operation-path">
+ <span class="operation-method">PUT</span>
+ <span class="operation-path">/users/me</span>
+ </section>
+ </div>
+ </div>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-request-body">
+ <div class="prop-row">
<div class="prop-name">
- <div class="prop-title">start</div>
+ <div class="swagger-request-model">
+ <span class="">
+ <a class="json-schema-ref" href="#/definitions/UpdateMe">UpdateMe</a>
+ </span>
+ </div>
</div>
- <div class="prop-value">
- <p>starting page</p>
+ <div class="prop-value columns small-6">
+ <!-- <div class="swagger-request-description"> -->
+ <p>undefined</p>
+ <!-- </div> -->
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
- <div class="prop-value">
- <span class="json-property-type">number</span>
- <span class="json-property-range" title="Value limits"></span>
- </div>
- </div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">query</div>
- </div>
- <div class="prop-row prop-group">
- <div class="prop-name">
- <div class="prop-title">stop</div>
- </div>
- <div class="prop-value">
- <p>stopping page</p>
- </div>
- </div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
- <div class="prop-value">
- <span class="json-property-type">number</span>
- <span class="json-property-range" title="Value limits"></span>
- </div>
- </div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">query</div>
- </div>
+ </section>
+ </div>
+ <div class="doc-examples">
+ <section>
+ <h5>Request Content-Types:
+ <span>application/json</span>
+ </h5>
+ <h5>Request Example</h5>
+ <!-- <div class="hljs"> --><pre><code class="hljs lang-json">{
+ <span class="hljs-attr">"password"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"email"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"displayNSFW"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"autoPlayVideo"</span>: <span class="hljs-string">"string"</span>
+}
+</code></pre>
+ <!-- </div> -->
+ </section>
+ </div>
+ </div>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-responses">
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">sort</div>
- </div>
- <div class="prop-value">
- <p>sorting</p>
+ <div class="prop-title">204 No Content</div>
</div>
- </div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
<div class="prop-value">
- <span class="json-property-type">number</span>
- <span class="json-property-range" title="Value limits"></span>
+ <p>Successful operation</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">query</div>
- </div>
</section>
</div>
+ <div class="doc-examples">
+ <h5>Response Content-Types:
+ <span>application/json</span>
+ </h5>
+ </div>
+ </div>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-request-security">
+ <table class="table">
+ <thead>
+ <tr>
+ <th class="swagger-request-security-schema"></th>
+ <th class="swagger-request-security-scopes"></th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>
+ <a href="#security-definition-OAuth2">OAuth2</a>
+ </td>
+ <td> </td>
+ </tr>
+ </tbody>
+ </table>
+ </section>
+ </div>
+ </div>
+ </div>
+ <div id="operation--users-me-video-quota-used-get" class="operation panel" data-traverse-target="operation--users-me-video-quota-used-get">
+ <!-- <section class="operation-tags row"> -->
+ <!-- <div class="doc-copy"> -->
+ <div class="operation-tags">
+ <a class="label" href="#tag-User">User</a>
+ <!---->
+ </div>
+ <!-- </div> -->
+ <!-- </section> -->
+ <h2 class="operation-title">
+ <span class="operation-summary">Get current user used quota</span>
+ </h2>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-operation-path">
+ <span class="operation-method">GET</span>
+ <span class="operation-path">/users/me/video-quota-used</span>
+ </section>
+ </div>
+ </div>
+ <div class="doc-row">
+ <div class="doc-copy"> </div>
<div class="doc-examples"></div>
</div>
<div class="doc-row">
<div class="prop-row prop-group">
<div class="prop-name">
<div class="prop-title">200 OK</div>
- <div class="prop-ref">
- <span class="">
- <a class="json-schema-ref" href="#/definitions/CommentThreadResponse">CommentThreadResponse</a>
- </span>
- </div>
+ <div class="prop-ref"></div>
<!-- <span class="swagger-global"></span> <span class="json-schema-reference"><a href=""></a></span> -->
</div>
<div class="prop-value">
<p>successful operation</p>
</div>
</div>
+ <div class="prop-row prop-inner">
+ <div class="prop-name">type</div>
+ <div class="prop-value">
+ <span class="json-property-type">number</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </div>
+ </div>
</section>
</div>
<div class="doc-examples">
<h5>Response Example
<span>(200 OK)</span>
</h5>
- <!-- <div class="hljs"> --><pre><code class="hljs lang-json">{
- <span class="hljs-attr">"total"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"data"</span>: [
- {
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"url"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"text"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"threadId"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"inReplyToCommentId"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"videoId"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"totalReplies"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"account"</span>: {
- <span class="hljs-attr">"displayName"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"url"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"name"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"host"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"followingCount"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"followersCount"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"avatar"</span>: {
- <span class="hljs-attr">"path"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>
- }
- }
- }
- ]
-}
+ <!-- <div class="hljs"> --><pre><code class="hljs lang-json"><span class="hljs-string">"number"</span>
</code></pre>
<!-- </div> -->
</section>
</div>
</div>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-request-security">
+ <table class="table">
+ <thead>
+ <tr>
+ <th class="swagger-request-security-schema"></th>
+ <th class="swagger-request-security-scopes"></th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>
+ <a href="#security-definition-OAuth2">OAuth2</a>
+ </td>
+ <td> </td>
+ </tr>
+ </tbody>
+ </table>
+ </section>
+ </div>
+ </div>
</div>
- <div id="operation--videos--videoId--comment-threads-post" class="operation panel" data-traverse-target="operation--videos--videoId--comment-threads-post">
+ <div id="operation--users-me-videos--videoId--rating-get" class="operation panel" data-traverse-target="operation--users-me-videos--videoId--rating-get">
<!-- <section class="operation-tags row"> -->
<!-- <div class="doc-copy"> -->
<div class="operation-tags">
- <a class="label" href="#tag-VideoComment">VideoComment</a>
+ <a class="label" href="#tag-User">User</a>
<!---->
</div>
<!-- </div> -->
<!-- </section> -->
<h2 class="operation-title">
- <span class="operation-name">
- <span class="operation-name">POST</span>
- <span class="operation-path">/videos/{videoId}/comment-threads</span>
- </span>
+ <span class="operation-summary">Get rating of video by its id, among those of the current user</span>
</h2>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-operation-path">
+ <span class="operation-method">GET</span>
+ <span class="operation-path">/users/me/videos/{videoId}/rating</span>
+ </section>
+ </div>
+ </div>
<div class="doc-row">
<div class="doc-copy">
<section class="swagger-request-params">
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">videoId</div>
+ <div class="prop-title">videoId:
+ <span class="prop-type">
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
<span class="json-property-required"></span>
+ <div class="prop-subtitle"> in path </div>
</div>
<div class="prop-value">
<p>The video id </p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
- <div class="prop-value">
- <span class="json-property-type">string</span>
- <span class="json-property-range" title="Value limits"></span>
- </div>
- </div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">path</div>
- </div>
</section>
</div>
<div class="doc-examples"></div>
<div class="prop-title">200 OK</div>
<div class="prop-ref">
<span class="">
- <a class="json-schema-ref" href="#/definitions/CommentThreadPostResponse">CommentThreadPostResponse</a>
+ <a class="json-schema-ref" href="#/definitions/GetMeVideoRating">GetMeVideoRating</a>
</span>
</div>
<!-- <span class="swagger-global"></span> <span class="json-schema-reference"><a href=""></a></span> -->
<span>(200 OK)</span>
</h5>
<!-- <div class="hljs"> --><pre><code class="hljs lang-json">{
- <span class="hljs-attr">"comment"</span>: {
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"url"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"text"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"threadId"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"inReplyToCommentId"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"videoId"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"totalReplies"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"account"</span>: {
- <span class="hljs-attr">"displayName"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"url"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"name"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"host"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"followingCount"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"followersCount"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"avatar"</span>: {
- <span class="hljs-attr">"path"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>
- }
- }
- }
+ <span class="hljs-attr">"id"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"rating"</span>: <span class="hljs-string">"number"</span>
}
</code></pre>
<!-- </div> -->
</section>
</div>
</div>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-request-security">
+ <table class="table">
+ <thead>
+ <tr>
+ <th class="swagger-request-security-schema"></th>
+ <th class="swagger-request-security-scopes"></th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>
+ <a href="#security-definition-OAuth2">OAuth2</a>
+ </td>
+ <td> </td>
+ </tr>
+ </tbody>
+ </table>
+ </section>
+ </div>
+ </div>
</div>
- <div id="operation--videos--videoId--comment-threads--threadId--get" class="operation panel" data-traverse-target="operation--videos--videoId--comment-threads--threadId--get">
+ <div id="operation--users-me-videos-get" class="operation panel" data-traverse-target="operation--users-me-videos-get">
<!-- <section class="operation-tags row"> -->
<!-- <div class="doc-copy"> -->
<div class="operation-tags">
- <a class="label" href="#tag-VideoComment">VideoComment</a>
+ <a class="label" href="#tag-User">User</a>
<!---->
</div>
<!-- </div> -->
<!-- </section> -->
<h2 class="operation-title">
- <span class="operation-name">
- <span class="operation-name">GET</span>
- <span class="operation-path">/videos/{videoId}/comment-threads/{threadId}</span>
- </span>
+ <span class="operation-summary">Get videos of the current user</span>
</h2>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-operation-path">
+ <span class="operation-method">GET</span>
+ <span class="operation-path">/users/me/videos</span>
+ </section>
+ </div>
+ </div>
<div class="doc-row">
<div class="doc-copy">
<section class="swagger-request-params">
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">videoId</div>
- <span class="json-property-required"></span>
- </div>
- <div class="prop-value">
- <p>The video id </p>
+ <div class="prop-title">start:
+ <span class="prop-type">
+ <span class="json-property-type">number</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in query </div>
</div>
- </div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
<div class="prop-value">
- <span class="json-property-type">string</span>
- <span class="json-property-range" title="Value limits"></span>
+ <p>Offset</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">path</div>
- </div>
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">threadId</div>
- <span class="json-property-required"></span>
+ <div class="prop-title">count:
+ <span class="prop-type">
+ <span class="json-property-type">number</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in query </div>
</div>
<div class="prop-value">
- <p>The thread id </p>
+ <p>Number of items</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
+ <div class="prop-row prop-group">
+ <div class="prop-name">
+ <div class="prop-title">sort:
+ <span class="prop-type">
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in query </div>
+ </div>
<div class="prop-value">
- <span class="json-property-type">string</span>
- <span class="json-property-range" title="Value limits"></span>
+ <p>Sort column (-createdAt for example)</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">path</div>
- </div>
</section>
</div>
<div class="doc-examples"></div>
<div class="prop-name">
<div class="prop-title">200 OK</div>
<div class="prop-ref">
- <span class="">
- <a class="json-schema-ref" href="#/definitions/VideoCommentThreadTree">VideoCommentThreadTree</a>
+ <span class="json-schema-ref-array">
+ <a class="json-schema-ref" href="#/definitions/Video">Video</a>
</span>
</div>
<!-- <span class="swagger-global"></span> <span class="json-schema-reference"><a href=""></a></span> -->
<p>successful operation</p>
</div>
</div>
+ <div class="prop-row prop-inner">
+ <div class="prop-name">type</div>
+ <div class="prop-value">
+ <span class="json-property-type">
+ <span class="json-schema-ref-array">
+ <a class="json-schema-ref" href="#/definitions/Video">Video</a>
+ </span>
+ </span>
+ <span class="json-property-range" title="Value limits"></span>
+ </div>
+ </div>
</section>
</div>
<div class="doc-examples">
<h5>Response Example
<span>(200 OK)</span>
</h5>
- <!-- <div class="hljs"> --><pre><code class="hljs lang-json">{
- <span class="hljs-attr">"comment"</span>: {
+ <!-- <div class="hljs"> --><pre><code class="hljs lang-json">[
+ {
<span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"url"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"text"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"threadId"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"inReplyToCommentId"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"videoId"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>,
<span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"publishedAt"</span>: <span class="hljs-string">"string"</span>,
<span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"totalReplies"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"account"</span>: {
- <span class="hljs-attr">"displayName"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"category"</span>: {
<span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"url"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
+ },
+ <span class="hljs-attr">"licence"</span>: {
+ <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
+ },
+ <span class="hljs-attr">"language"</span>: {
+ <span class="hljs-attr">"id"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
+ },
+ <span class="hljs-attr">"privacy"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"description"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"duration"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"isLocal"</span>: <span class="hljs-string">"boolean"</span>,
+ <span class="hljs-attr">"name"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"thumbnailPath"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"previewPath"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"embedPath"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"views"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"likes"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"dislikes"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"nsfw"</span>: <span class="hljs-string">"boolean"</span>,
+ <span class="hljs-attr">"account"</span>: {
<span class="hljs-attr">"name"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"displayName"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"url"</span>: <span class="hljs-string">"string"</span>,
<span class="hljs-attr">"host"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"followingCount"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"followersCount"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>,
<span class="hljs-attr">"avatar"</span>: {
<span class="hljs-attr">"path"</span>: <span class="hljs-string">"string"</span>,
<span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
<span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>
}
}
- },
- <span class="hljs-attr">"children"</span>: [
- {
- <span class="hljs-attr">"comment"</span>: {
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"url"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"text"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"threadId"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"inReplyToCommentId"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"videoId"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"totalReplies"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"account"</span>: {
- <span class="hljs-attr">"displayName"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"url"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"name"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"host"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"followingCount"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"followersCount"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"avatar"</span>: {
- <span class="hljs-attr">"path"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>
- }
- }
- },
- <span class="hljs-attr">"children"</span>: [
- {
- <span class="hljs-attr">"comment"</span>: {
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"url"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"text"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"threadId"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"inReplyToCommentId"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"videoId"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"totalReplies"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"account"</span>: {
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"url"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"name"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"host"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"followingCount"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"followersCount"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"avatar"</span>: {
- <span class="hljs-attr">"path"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>
- }
- }
- }
- }
- ]
- }
- ]
-}
+ }
+]
</code></pre>
<!-- </div> -->
</section>
</div>
</div>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-request-security">
+ <table class="table">
+ <thead>
+ <tr>
+ <th class="swagger-request-security-schema"></th>
+ <th class="swagger-request-security-scopes"></th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>
+ <a href="#security-definition-OAuth2">OAuth2</a>
+ </td>
+ <td> </td>
+ </tr>
+ </tbody>
+ </table>
+ </section>
+ </div>
+ </div>
</div>
- <div id="operation--videos--videoId--comments--commentId--post" class="operation panel" data-traverse-target="operation--videos--videoId--comments--commentId--post">
+ <div id="operation--users-register-post" class="operation panel" data-traverse-target="operation--users-register-post">
<!-- <section class="operation-tags row"> -->
<!-- <div class="doc-copy"> -->
<div class="operation-tags">
- <a class="label" href="#tag-VideoComment">VideoComment</a>
+ <a class="label" href="#tag-User">User</a>
<!---->
</div>
<!-- </div> -->
<!-- </section> -->
<h2 class="operation-title">
- <span class="operation-name">
- <span class="operation-name">POST</span>
- <span class="operation-path">/videos/{videoId}/comments/{commentId}</span>
- </span>
+ <span class="operation-summary">Register a user</span>
</h2>
<div class="doc-row">
<div class="doc-copy">
- <section class="swagger-request-params">
- <div class="prop-row prop-group">
+ <section class="swagger-operation-path">
+ <span class="operation-method">POST</span>
+ <span class="operation-path">/users/register</span>
+ </section>
+ </div>
+ </div>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-request-body">
+ <div class="prop-row">
<div class="prop-name">
- <div class="prop-title">videoId</div>
- <span class="json-property-required"></span>
- </div>
- <div class="prop-value">
- <p>The video id </p>
+ <div class="swagger-request-model">
+ <span class="">
+ <a class="json-schema-ref" href="#/definitions/RegisterUser">RegisterUser</a>
+ </span>
+ </div>
</div>
- </div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
- <div class="prop-value">
- <span class="json-property-type">string</span>
- <span class="json-property-range" title="Value limits"></span>
+ <div class="prop-value columns small-6">
+ <!-- <div class="swagger-request-description"> -->
+ <p>undefined</p>
+ <!-- </div> -->
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">path</div>
- </div>
+ </section>
+ </div>
+ <div class="doc-examples">
+ <section>
+ <h5>Request Content-Types:
+ <span>application/json</span>
+ </h5>
+ <h5>Request Example</h5>
+ <!-- <div class="hljs"> --><pre><code class="hljs lang-json">{
+ <span class="hljs-attr">"username"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"password"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"email"</span>: <span class="hljs-string">"string"</span>
+}
+</code></pre>
+ <!-- </div> -->
+ </section>
+ </div>
+ </div>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-responses">
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">commentId</div>
- <span class="json-property-required"></span>
+ <div class="prop-title">204 No Content</div>
</div>
<div class="prop-value">
- <p>The comment id </p>
+ <p>Successful operation</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
+ </section>
+ </div>
+ <div class="doc-examples">
+ <h5>Response Content-Types:
+ <span>application/json</span>
+ </h5>
+ </div>
+ </div>
+ </div>
+ <div id="operation--users-me-avatar-pick-post" class="operation panel" data-traverse-target="operation--users-me-avatar-pick-post">
+ <!-- <section class="operation-tags row"> -->
+ <!-- <div class="doc-copy"> -->
+ <div class="operation-tags">
+ <a class="label" href="#tag-User">User</a>
+ <!---->
+ </div>
+ <!-- </div> -->
+ <!-- </section> -->
+ <h2 class="operation-title">
+ <span class="operation-summary">Update current user avatar</span>
+ </h2>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-operation-path">
+ <span class="operation-method">POST</span>
+ <span class="operation-path">/users/me/avatar/pick</span>
+ </section>
+ </div>
+ </div>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-request-params">
+ <div class="prop-row prop-group">
+ <div class="prop-name">
+ <div class="prop-title">avatarfile:
+ <span class="prop-type">
+ <span class="json-property-type">file</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in formData </div>
+ </div>
<div class="prop-value">
- <span class="json-property-type">string</span>
- <span class="json-property-range" title="Value limits"></span>
+ <p>The file to upload.</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">path</div>
- </div>
</section>
</div>
<div class="doc-examples"></div>
<div class="prop-title">200 OK</div>
<div class="prop-ref">
<span class="">
- <a class="json-schema-ref" href="#/definitions/CommentThreadPostResponse">CommentThreadPostResponse</a>
+ <a class="json-schema-ref" href="#/definitions/Avatar">Avatar</a>
</span>
</div>
<!-- <span class="swagger-global"></span> <span class="json-schema-reference"><a href=""></a></span> -->
<span>(200 OK)</span>
</h5>
<!-- <div class="hljs"> --><pre><code class="hljs lang-json">{
- <span class="hljs-attr">"comment"</span>: {
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"url"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"text"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"threadId"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"inReplyToCommentId"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"videoId"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"totalReplies"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"account"</span>: {
- <span class="hljs-attr">"displayName"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"url"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"name"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"host"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"followingCount"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"followersCount"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"avatar"</span>: {
- <span class="hljs-attr">"path"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>
- }
- }
- }
+ <span class="hljs-attr">"path"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>
}
</code></pre>
<!-- </div> -->
</section>
</div>
</div>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-request-security">
+ <table class="table">
+ <thead>
+ <tr>
+ <th class="swagger-request-security-schema"></th>
+ <th class="swagger-request-security-scopes"></th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>
+ <a href="#security-definition-OAuth2">OAuth2</a>
+ </td>
+ <td> </td>
+ </tr>
+ </tbody>
+ </table>
+ </section>
+ </div>
+ </div>
+ </div>
+ <h1 id="tag-VideoBlacklist" class="swagger-summary-tag" data-traverse-target="tag-VideoBlacklist">VideoBlacklist</h1>
+ <div id="operation--videos--id--blacklist-post" class="operation panel" data-traverse-target="operation--videos--id--blacklist-post">
+ <!-- <section class="operation-tags row"> -->
+ <!-- <div class="doc-copy"> -->
+ <div class="operation-tags">
+ <a class="label" href="#tag-VideoBlacklist">VideoBlacklist</a>
+ <!---->
+ </div>
+ <!-- </div> -->
+ <!-- </section> -->
+ <h2 class="operation-title">
+ <span class="operation-summary">Put on blacklist a video by its id</span>
+ </h2>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-operation-path">
+ <span class="operation-method">POST</span>
+ <span class="operation-path">/videos/{id}/blacklist</span>
+ </section>
+ </div>
+ </div>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-request-params">
+ <div class="prop-row prop-group">
+ <div class="prop-name">
+ <div class="prop-title">id:
+ <span class="prop-type">
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <span class="json-property-required"></span>
+ <div class="prop-subtitle"> in path </div>
+ </div>
+ <div class="prop-value">
+ <p>The video id or uuid</p>
+ </div>
+ </div>
+ </section>
+ </div>
+ <div class="doc-examples"></div>
+ </div>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-responses">
+ <div class="prop-row prop-group">
+ <div class="prop-name">
+ <div class="prop-title">204 No Content</div>
+ </div>
+ <div class="prop-value">
+ <p>Successful operation</p>
+ </div>
+ </div>
+ </section>
+ </div>
+ <div class="doc-examples">
+ <h5>Response Content-Types:
+ <span>application/json</span>
+ </h5>
+ </div>
+ </div>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-request-security">
+ <table class="table">
+ <thead>
+ <tr>
+ <th class="swagger-request-security-schema"></th>
+ <th class="swagger-request-security-scopes"></th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>
+ <a href="#security-definition-OAuth2">OAuth2</a>
+ </td>
+ <td>
+ <a href="#security-definition-scope-admin">admin</a>,
+ <a href="#security-definition-scope-moderator">moderator</a>
+ </td>
+ </tr>
+ </tbody>
+ </table>
+ </section>
+ </div>
+ </div>
+ </div>
+ <div id="operation--videos--id--blacklist-delete" class="operation panel" data-traverse-target="operation--videos--id--blacklist-delete">
+ <!-- <section class="operation-tags row"> -->
+ <!-- <div class="doc-copy"> -->
+ <div class="operation-tags">
+ <a class="label" href="#tag-VideoBlacklist">VideoBlacklist</a>
+ <!---->
+ </div>
+ <!-- </div> -->
+ <!-- </section> -->
+ <h2 class="operation-title">
+ <span class="operation-summary">Delete an entry of the blacklist of a video by its id</span>
+ </h2>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-operation-path">
+ <span class="operation-method">DELETE</span>
+ <span class="operation-path">/videos/{id}/blacklist</span>
+ </section>
+ </div>
+ </div>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-request-params">
+ <div class="prop-row prop-group">
+ <div class="prop-name">
+ <div class="prop-title">id:
+ <span class="prop-type">
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <span class="json-property-required"></span>
+ <div class="prop-subtitle"> in path </div>
+ </div>
+ <div class="prop-value">
+ <p>The video id or uuid</p>
+ </div>
+ </div>
+ </section>
+ </div>
+ <div class="doc-examples"></div>
+ </div>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-responses">
+ <div class="prop-row prop-group">
+ <div class="prop-name">
+ <div class="prop-title">204 No Content</div>
+ </div>
+ <div class="prop-value">
+ <p>Successful operation</p>
+ </div>
+ </div>
+ </section>
+ </div>
+ <div class="doc-examples">
+ <h5>Response Content-Types:
+ <span>application/json</span>
+ </h5>
+ </div>
+ </div>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-request-security">
+ <table class="table">
+ <thead>
+ <tr>
+ <th class="swagger-request-security-schema"></th>
+ <th class="swagger-request-security-scopes"></th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>
+ <a href="#security-definition-OAuth2">OAuth2</a>
+ </td>
+ <td>
+ <a href="#security-definition-scope-admin">admin</a>,
+ <a href="#security-definition-scope-moderator">moderator</a>
+ </td>
+ </tr>
+ </tbody>
+ </table>
+ </section>
+ </div>
+ </div>
</div>
- <div id="operation--videos--videoId--comments--commentId--delete" class="operation panel" data-traverse-target="operation--videos--videoId--comments--commentId--delete">
+ <div id="operation--videos-blacklist-get" class="operation panel" data-traverse-target="operation--videos-blacklist-get">
<!-- <section class="operation-tags row"> -->
<!-- <div class="doc-copy"> -->
<div class="operation-tags">
- <a class="label" href="#tag-VideoComment">VideoComment</a>
+ <a class="label" href="#tag-VideoBlacklist">VideoBlacklist</a>
<!---->
</div>
<!-- </div> -->
<!-- </section> -->
<h2 class="operation-title">
- <span class="operation-name">
- <span class="operation-name">DELETE</span>
- <span class="operation-path">/videos/{videoId}/comments/{commentId}</span>
- </span>
+ <span class="operation-summary">Get list of videos on blacklist</span>
</h2>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-operation-path">
+ <span class="operation-method">GET</span>
+ <span class="operation-path">/videos/blacklist</span>
+ </section>
+ </div>
+ </div>
<div class="doc-row">
<div class="doc-copy">
<section class="swagger-request-params">
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">videoId</div>
- <span class="json-property-required"></span>
- </div>
- <div class="prop-value">
- <p>The video id </p>
+ <div class="prop-title">start:
+ <span class="prop-type">
+ <span class="json-property-type">number</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in query </div>
</div>
- </div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
<div class="prop-value">
- <span class="json-property-type">string</span>
- <span class="json-property-range" title="Value limits"></span>
+ <p>Offset</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">path</div>
- </div>
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">commentId</div>
- <span class="json-property-required"></span>
+ <div class="prop-title">count:
+ <span class="prop-type">
+ <span class="json-property-type">number</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in query </div>
</div>
<div class="prop-value">
- <p>The comment id </p>
+ <p>Number of items</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
+ <div class="prop-row prop-group">
+ <div class="prop-name">
+ <div class="prop-title">sort:
+ <span class="prop-type">
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
+ <div class="prop-subtitle"> in query </div>
+ </div>
<div class="prop-value">
- <span class="json-property-type">string</span>
- <span class="json-property-range" title="Value limits"></span>
+ <p>Sort column (-createdAt for example)</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">path</div>
- </div>
</section>
</div>
<div class="doc-examples"></div>
<section class="swagger-responses">
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">204 No Content</div>
+ <div class="prop-title">200 OK</div>
+ <div class="prop-ref">
+ <span class="json-schema-ref-array">
+ <a class="json-schema-ref" href="#/definitions/VideoBlacklist">VideoBlacklist</a>
+ </span>
+ </div>
+ <!-- <span class="swagger-global"></span> <span class="json-schema-reference"><a href=""></a></span> -->
</div>
<div class="prop-value">
<p>successful operation</p>
</div>
</div>
+ <div class="prop-row prop-inner">
+ <div class="prop-name">type</div>
+ <div class="prop-value">
+ <span class="json-property-type">
+ <span class="json-schema-ref-array">
+ <a class="json-schema-ref" href="#/definitions/VideoBlacklist">VideoBlacklist</a>
+ </span>
+ </span>
+ <span class="json-property-range" title="Value limits"></span>
+ </div>
+ </div>
</section>
</div>
<div class="doc-examples">
<h5>Response Content-Types:
<span>application/json</span>
</h5>
+ <section>
+ <h5>Response Example
+ <span>(200 OK)</span>
+ </h5>
+ <!-- <div class="hljs"> --><pre><code class="hljs lang-json">[
+ {
+ <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"videoId"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"name"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"description"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"duration"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"views"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"likes"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"dislikes"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"nsfw"</span>: <span class="hljs-string">"boolean"</span>
+ }
+]
+</code></pre>
+ <!-- </div> -->
+ </section>
+ </div>
+ </div>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-request-security">
+ <table class="table">
+ <thead>
+ <tr>
+ <th class="swagger-request-security-schema"></th>
+ <th class="swagger-request-security-scopes"></th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>
+ <a href="#security-definition-OAuth2">OAuth2</a>
+ </td>
+ <td>
+ <a href="#security-definition-scope-admin">admin</a>,
+ <a href="#security-definition-scope-moderator">moderator</a>
+ </td>
+ </tr>
+ </tbody>
+ </table>
+ </section>
</div>
</div>
</div>
<!-- </div> -->
<!-- </section> -->
<h2 class="operation-title">
- <span class="operation-name">
- <span class="operation-name">PUT</span>
- <span class="operation-path">/videos/{id}/rate</span>
- </span>
+ <span class="operation-summary">Vote for a video by its id</span>
</h2>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-operation-path">
+ <span class="operation-method">PUT</span>
+ <span class="operation-path">/videos/{id}/rate</span>
+ </section>
+ </div>
+ </div>
<div class="doc-row">
<div class="doc-copy">
<section class="swagger-request-params">
<div class="prop-row prop-group">
<div class="prop-name">
- <div class="prop-title">id</div>
+ <div class="prop-title">id:
+ <span class="prop-type">
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </span>
+ </div>
<span class="json-property-required"></span>
+ <div class="prop-subtitle"> in path </div>
</div>
<div class="prop-value">
- <p>The video id </p>
- </div>
- </div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">type</div>
- <div class="prop-value">
- <span class="json-property-type">string</span>
- <span class="json-property-range" title="Value limits"></span>
+ <p>The video id or uuid</p>
</div>
</div>
- <div class="prop-row prop-inner">
- <div class="prop-name param-label">in</div>
- <div class="prop-value">path</div>
- </div>
</section>
</div>
<div class="doc-examples"></div>
<div class="prop-title">204 No Content</div>
</div>
<div class="prop-value">
- <p>successful operation</p>
+ <p>Successful operation</p>
</div>
</div>
</section>
</h5>
</div>
</div>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="swagger-request-security">
+ <table class="table">
+ <thead>
+ <tr>
+ <th class="swagger-request-security-schema"></th>
+ <th class="swagger-request-security-scopes"></th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>
+ <a href="#security-definition-OAuth2">OAuth2</a>
+ </td>
+ <td> </td>
+ </tr>
+ </tbody>
+ </table>
+ </section>
+ </div>
+ </div>
</div>
<h1>Schema Definitions</h1>
- <div id="definition-VideoConstant" class="definition panel" data-traverse-target="definition-VideoConstant">
+ <div id="definition-VideoConstantNumber" class="definition panel" data-traverse-target="definition-VideoConstantNumber">
<h2 class="panel-title">
- <a name="/definitions/VideoConstant"></a>VideoConstant:
+ <a name="/definitions/VideoConstantNumber"></a>VideoConstantNumber:
<!-- <span class="json-property-type"><span class="json-property-type">object</span>
<span class="json-property-range" title="Value limits"></span>
</div>
</div>
</div>
+ <div id="definition-VideoConstantString" class="definition panel" data-traverse-target="definition-VideoConstantString">
+ <h2 class="panel-title">
+ <a name="/definitions/VideoConstantString"></a>VideoConstantString:
+ <!-- <span class="json-property-type"><span class="json-property-type">object</span>
+ <span class="json-property-range" title="Value limits"></span>
+
+
+ </span> -->
+ </h2>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <section class="json-schema-properties">
+ <dl>
+ <dt data-property-name="id">
+ <span class="json-property-name">id:</span>
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </dt>
+ <dt data-property-name="label">
+ <span class="json-property-name">label:</span>
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </dt>
+ </dl>
+ </section>
+ </div>
+ <div class="doc-examples">
+ <section>
+ <h5>Example</h5>
+ <!-- <div class="hljs"> --><pre><code class="hljs lang-json">{
+ <span class="hljs-attr">"id"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
+}
+</code></pre>
+ <!-- </div> -->
+ </section>
+ </div>
+ </div>
+ </div>
+ <div id="definition-VideoPrivacy" class="definition panel" data-traverse-target="definition-VideoPrivacy">
+ <h2 class="panel-title">
+ <a name="/definitions/VideoPrivacy"></a>VideoPrivacy: string
+ <!-- <span class="json-property-type"><span class="json-property-type">string</span> <span class="json-property-enum" title="Possible values">
+ <span class="json-property-enum-item">Public</span>,
+ <span class="json-property-enum-item">Unlisted</span>,
+ <span class="json-property-enum-item">Private</span>
+ </span>
+ <span class="json-property-range" title="Value limits"></span>
+
+
+ </span> -->
+ </h2>
+ <div class="doc-row">
+ <div class="doc-copy">
+ <span class="json-property-type">string</span>
+ <span class="json-property-enum" title="Possible values">
+ <span class="json-property-enum-item">Public</span>,
+ <span class="json-property-enum-item">Unlisted</span>,
+ <span class="json-property-enum-item">Private</span>
+ </span>
+ <span class="json-property-range" title="Value limits"></span>
+ </div>
+ </div>
+ </div>
<div id="definition-Video" class="definition panel" data-traverse-target="definition-Video">
<h2 class="panel-title">
<a name="/definitions/Video"></a>Video:
<span class="json-property-type">string</span>
<span class="json-property-range" title="Value limits"></span>
</dt>
+ <dt data-property-name="publishedAt">
+ <span class="json-property-name">publishedAt:</span>
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </dt>
<dt data-property-name="updatedAt">
<span class="json-property-name">updatedAt:</span>
<span class="json-property-type">string</span>
<span class="json-property-name">category:</span>
<span class="json-property-type">
<span class="">
- <a class="json-schema-ref" href="#/definitions/VideoConstant">VideoConstant</a>
+ <a class="json-schema-ref" href="#/definitions/VideoConstantNumber">VideoConstantNumber</a>
</span>
</span>
<span class="json-property-range" title="Value limits"></span>
<span class="json-property-name">licence:</span>
<span class="json-property-type">
<span class="">
- <a class="json-schema-ref" href="#/definitions/VideoConstant">VideoConstant</a>
+ <a class="json-schema-ref" href="#/definitions/VideoConstantNumber">VideoConstantNumber</a>
</span>
</span>
<span class="json-property-range" title="Value limits"></span>
<span class="json-property-name">language:</span>
<span class="json-property-type">
<span class="">
- <a class="json-schema-ref" href="#/definitions/VideoConstant">VideoConstant</a>
+ <a class="json-schema-ref" href="#/definitions/VideoConstantString">VideoConstantString</a>
+ </span>
+ </span>
+ <span class="json-property-range" title="Value limits"></span>
+ </dt>
+ <dt data-property-name="privacy">
+ <span class="json-property-name">privacy:</span>
+ <span class="json-property-type">
+ <span class="">
+ <a class="json-schema-ref" href="#/definitions/VideoPrivacy">VideoPrivacy</a>
</span>
</span>
<span class="json-property-range" title="Value limits"></span>
<span class="json-property-type">object</span>
<span class="json-property-range" title="Value limits"></span>
</dt>
+ <dt class="json-inner-schema">
+ <section class="json-schema-properties">
+ <dl>
+ <dt data-property-name="name">
+ <span class="json-property-name">name:</span>
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </dt>
+ <dt data-property-name="displayName">
+ <span class="json-property-name">displayName:</span>
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </dt>
+ <dt data-property-name="url">
+ <span class="json-property-name">url:</span>
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </dt>
+ <dt data-property-name="host">
+ <span class="json-property-name">host:</span>
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </dt>
+ <dt data-property-name="avatar">
+ <span class="json-property-name">avatar:</span>
+ <span class="json-property-type">
+ <span class="">
+ <a class="json-schema-ref" href="#/definitions/Avatar">Avatar</a>
+ </span>
+ </span>
+ <span class="json-property-range" title="Value limits"></span>
+ </dt>
+ </dl>
+ </section>
+ </dt>
</dl>
</section>
</div>
<span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
<span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>,
<span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"publishedAt"</span>: <span class="hljs-string">"string"</span>,
<span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>,
<span class="hljs-attr">"category"</span>: {
<span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
<span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
},
<span class="hljs-attr">"language"</span>: {
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"id"</span>: <span class="hljs-string">"string"</span>,
<span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
},
+ <span class="hljs-attr">"privacy"</span>: <span class="hljs-string">"string"</span>,
<span class="hljs-attr">"description"</span>: <span class="hljs-string">"string"</span>,
<span class="hljs-attr">"duration"</span>: <span class="hljs-string">"number"</span>,
<span class="hljs-attr">"isLocal"</span>: <span class="hljs-string">"boolean"</span>,
<span class="hljs-attr">"views"</span>: <span class="hljs-string">"number"</span>,
<span class="hljs-attr">"likes"</span>: <span class="hljs-string">"number"</span>,
<span class="hljs-attr">"dislikes"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"nsfw"</span>: <span class="hljs-string">"boolean"</span>
+ <span class="hljs-attr">"nsfw"</span>: <span class="hljs-string">"boolean"</span>,
+ <span class="hljs-attr">"account"</span>: {
+ <span class="hljs-attr">"name"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"displayName"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"url"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"host"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"avatar"</span>: {
+ <span class="hljs-attr">"path"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>
+ }
+ }
}
</code></pre>
<!-- </div> -->
<span class="json-property-type">object</span>
<span class="json-property-range" title="Value limits"></span>
</dt>
+ <dt class="json-inner-schema">
+ <section class="json-schema-properties">
+ <dl>
+ <dt data-property-name="id">
+ <span class="json-property-name">id:</span>
+ <span class="json-property-type">number</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </dt>
+ <dt data-property-name="name">
+ <span class="json-property-name">name:</span>
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </dt>
+ <dt data-property-name="uuid">
+ <span class="json-property-name">uuid:</span>
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </dt>
+ <dt data-property-name="url">
+ <span class="json-property-name">url:</span>
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </dt>
+ </dl>
+ </section>
+ </dt>
<dt data-property-name="createdAt">
<span class="json-property-name">createdAt:</span>
<span class="json-property-type">string</span>
<span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>
}
},
+ <span class="hljs-attr">"video"</span>: {
+ <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"name"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"url"</span>: <span class="hljs-string">"string"</span>
+ },
<span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>
}
</code></pre>
<span class="json-property-type">boolean</span>
<span class="json-property-range" title="Value limits"></span>
</dt>
- <dt data-property-name="owner">
- <span class="json-property-name">owner:</span>
+ <dt data-property-name="ownerAccount">
+ <span class="json-property-name">ownerAccount:</span>
<span class="json-property-type">object</span>
<span class="json-property-range" title="Value limits"></span>
</dt>
- <dt data-property-name="videos">
- <span class="json-property-name">videos:</span>
- <span class="json-property-type">
- <span class="json-schema-ref-array">
- <a class="json-schema-ref" href="#/definitions/Video">Video</a>
- </span>
- </span>
- <span class="json-property-range" title="Value limits"></span>
+ <dt class="json-inner-schema">
+ <section class="json-schema-properties">
+ <dl>
+ <dt data-property-name="id">
+ <span class="json-property-name">id:</span>
+ <span class="json-property-type">number</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </dt>
+ <dt data-property-name="uuid">
+ <span class="json-property-name">uuid:</span>
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </dt>
+ </dl>
+ </section>
</dt>
</dl>
</section>
<span class="hljs-attr">"displayName"</span>: <span class="hljs-string">"string"</span>,
<span class="hljs-attr">"description"</span>: <span class="hljs-string">"string"</span>,
<span class="hljs-attr">"isLocal"</span>: <span class="hljs-string">"boolean"</span>,
- <span class="hljs-attr">"owner"</span>: {
- <span class="hljs-attr">"name"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"ownerAccount"</span>: {
+ <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
<span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>
- },
- <span class="hljs-attr">"videos"</span>: [
- {
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"category"</span>: {
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
- },
- <span class="hljs-attr">"licence"</span>: {
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
- },
- <span class="hljs-attr">"language"</span>: {
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
- },
- <span class="hljs-attr">"description"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"duration"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"isLocal"</span>: <span class="hljs-string">"boolean"</span>,
- <span class="hljs-attr">"name"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"thumbnailPath"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"previewPath"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"embedPath"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"views"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"likes"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"dislikes"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"nsfw"</span>: <span class="hljs-string">"boolean"</span>
- }
- ]
+ }
}
</code></pre>
<!-- </div> -->
</span>
<span class="json-property-range" title="Value limits"></span>
</dt>
+ <dt class="json-inner-schema">
+ <section class="json-schema-array-items">
+ <span class="json-property-type">
+ <span class="">
+ <a class="json-schema-ref" href="#/definitions/VideoCommentThreadTree">VideoCommentThreadTree</a>
+ </span>
+ </span>
+ <span class="json-property-range" title="Value limits"></span>
+ <div class="json-inner-schema"> </div>
+ </section>
+ </dt>
</dl>
</section>
</div>
</span>
<span class="json-property-range" title="Value limits"></span>
</dt>
+ <dt class="json-inner-schema">
+ <section class="json-schema-array-items">
+ <span class="json-property-type">
+ <span class="">
+ <a class="json-schema-ref" href="#/definitions/VideoChannel">VideoChannel</a>
+ </span>
+ </span>
+ <span class="json-property-range" title="Value limits"></span>
+ <div class="json-inner-schema"> </div>
+ </section>
+ </dt>
</dl>
</section>
</div>
<span class="hljs-attr">"displayName"</span>: <span class="hljs-string">"string"</span>,
<span class="hljs-attr">"description"</span>: <span class="hljs-string">"string"</span>,
<span class="hljs-attr">"isLocal"</span>: <span class="hljs-string">"boolean"</span>,
- <span class="hljs-attr">"owner"</span>: {
- <span class="hljs-attr">"name"</span>: <span class="hljs-string">"string"</span>,
+ <span class="hljs-attr">"ownerAccount"</span>: {
+ <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
<span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>
- },
- <span class="hljs-attr">"videos"</span>: [
- {
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"createdAt"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"updatedAt"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"category"</span>: {
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
- },
- <span class="hljs-attr">"licence"</span>: {
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
- },
- <span class="hljs-attr">"language"</span>: {
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"label"</span>: <span class="hljs-string">"string"</span>
- },
- <span class="hljs-attr">"description"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"duration"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"isLocal"</span>: <span class="hljs-string">"boolean"</span>,
- <span class="hljs-attr">"name"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"thumbnailPath"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"previewPath"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"embedPath"</span>: <span class="hljs-string">"string"</span>,
- <span class="hljs-attr">"views"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"likes"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"dislikes"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"nsfw"</span>: <span class="hljs-string">"boolean"</span>
- }
- ]
+ }
}
]
}
<span class="json-property-type">object</span>
<span class="json-property-range" title="Value limits"></span>
</dt>
+ <dt class="json-inner-schema">
+ <section class="json-schema-properties">
+ <dl>
+ <dt data-property-name="allowed">
+ <span class="json-property-name">allowed:</span>
+ <span class="json-property-type">boolean</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </dt>
+ </dl>
+ </section>
+ </dt>
<dt data-property-name="transcoding">
<span class="json-property-name">transcoding:</span>
<span class="json-property-type">object</span>
<span class="json-property-range" title="Value limits"></span>
</dt>
+ <dt class="json-inner-schema">
+ <section class="json-schema-properties">
+ <dl>
+ <dt data-property-name="enabledResolutions">
+ <span class="json-property-name">enabledResolutions:</span>
+ <span class="json-property-type">number[]</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </dt>
+ <dt class="json-inner-schema">
+ <section class="json-schema-array-items">
+ <span class="json-property-type">number</span>
+ <span class="json-property-range" title="Value limits"></span>
+ <div class="json-inner-schema"> </div>
+ </section>
+ </dt>
+ </dl>
+ </section>
+ </dt>
<dt data-property-name="avatar">
<span class="json-property-name">avatar:</span>
<span class="json-property-type">object</span>
<span class="json-property-range" title="Value limits"></span>
</dt>
+ <dt class="json-inner-schema">
+ <section class="json-schema-properties">
+ <dl>
+ <dt data-property-name="file">
+ <span class="json-property-name">file:</span>
+ <span class="json-property-type">object</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </dt>
+ <dt class="json-inner-schema">
+ <section class="json-schema-properties">
+ <dl>
+ <dt data-property-name="size">
+ <span class="json-property-name">size:</span>
+ <span class="json-property-type">object</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </dt>
+ <dt class="json-inner-schema">
+ <section class="json-schema-properties">
+ <dl>
+ <dt data-property-name="max">
+ <span class="json-property-name">max:</span>
+ <span class="json-property-type">number</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </dt>
+ </dl>
+ </section>
+ </dt>
+ </dl>
+ </section>
+ </dt>
+ <dt data-property-name="extensions">
+ <span class="json-property-name">extensions:</span>
+ <span class="json-property-type">string[]</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </dt>
+ <dt class="json-inner-schema">
+ <section class="json-schema-array-items">
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ <div class="json-inner-schema"> </div>
+ </section>
+ </dt>
+ </dl>
+ </section>
+ </dt>
<dt data-property-name="video">
<span class="json-property-name">video:</span>
<span class="json-property-type">object</span>
<span class="json-property-range" title="Value limits"></span>
</dt>
+ <dt class="json-inner-schema">
+ <section class="json-schema-properties">
+ <dl>
+ <dt data-property-name="file">
+ <span class="json-property-name">file:</span>
+ <span class="json-property-type">object</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </dt>
+ <dt class="json-inner-schema">
+ <section class="json-schema-properties">
+ <dl>
+ <dt data-property-name="extensions">
+ <span class="json-property-name">extensions:</span>
+ <span class="json-property-type">string[]</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </dt>
+ <dt class="json-inner-schema">
+ <section class="json-schema-array-items">
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ <div class="json-inner-schema"> </div>
+ </section>
+ </dt>
+ </dl>
+ </section>
+ </dt>
+ </dl>
+ </section>
+ </dt>
</dl>
</section>
</div>
<div class="doc-copy">
<section class="json-schema-properties">
<dl>
- <dt data-property-name="id">
- <span class="json-property-name">id:</span>
- <span class="json-property-type">number</span>
+ <dt data-property-name="video">
+ <span class="json-property-name">video:</span>
+ <span class="json-property-type">object</span>
<span class="json-property-range" title="Value limits"></span>
</dt>
- <dt data-property-name="uuid">
- <span class="json-property-name">uuid:</span>
- <span class="json-property-type">string</span>
- <span class="json-property-range" title="Value limits"></span>
+ <dt class="json-inner-schema">
+ <section class="json-schema-properties">
+ <dl>
+ <dt data-property-name="id">
+ <span class="json-property-name">id:</span>
+ <span class="json-property-type">number</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </dt>
+ <dt data-property-name="uuid">
+ <span class="json-property-name">uuid:</span>
+ <span class="json-property-type">string</span>
+ <span class="json-property-range" title="Value limits"></span>
+ </dt>
+ </dl>
+ </section>
</dt>
</dl>
</section>
<section>
<h5>Example</h5>
<!-- <div class="hljs"> --><pre><code class="hljs lang-json">{
- <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
- <span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>
+ <span class="hljs-attr">"video"</span>: {
+ <span class="hljs-attr">"id"</span>: <span class="hljs-string">"number"</span>,
+ <span class="hljs-attr">"uuid"</span>: <span class="hljs-string">"string"</span>
+ }
}
</code></pre>
<!-- </div> -->
</span>
<span class="json-property-range" title="Value limits"></span>
</dt>
+ <dt class="json-inner-schema">
+ <section class="json-schema-array-items">
+ <span class="json-property-type">
+ <span class="">
+ <a class="json-schema-ref" href="#/definitions/VideoComment">VideoComment</a>
+ </span>
+ </span>
+ <span class="json-property-range" title="Value limits"></span>
+ <div class="json-inner-schema"> </div>
+ </section>
+ </dt>
</dl>
</section>
</div>
projects / github / Chocobozzz / PeerTube.git / blobdiff