Introduction

Welcome to the API documentation for our streaming platform. This API provides a comprehensive set of endpoints to manage movies, TV series, and related media content.

Base URL

All API requests should be made to:

https://api.dobridobrev.com/api/v1/

Authentication

All API requests must include a valid Bearer token in the Authorization header:

Authorization: Bearer your-token-here

Response Format

All responses are returned in JSON format.

Success Response

{
    "data": {
        // Response data here
    }
}

Error Response

{
    "error": "Error message here",
    "code": 400
}

Rate Limiting

Authentication endpoints: 3 requests per 10 minutes
Other endpoints: 60 requests per minute

Pagination

List endpoints return paginated results with 24 items per page.

{
    "data": [
        // Array of items
    ],
    "meta": {
        "current_page": 1,
        "total": 50,
        "per_page": 24
    }
}

HTTP Methods

The API uses standard HTTP methods:

GET - Retrieve resources
POST - Create new resources
PUT - Update existing resources
DELETE - Remove resources

Content Types

For endpoints that accept data (POST/PUT), you should send the data as JSON with the appropriate Content-Type header:

Content-Type: application/json

File Uploads

For endpoints that handle file uploads (images, videos), use multipart/form-data:

Content-Type: multipart/form-data

Streaming API