API Documentation

Account Info

GET /account/info

Retrieves account information for the authenticated user.

Response

{
  "status": true,
  "data": {
    "username": "User Name",
    "email": "[email protected]",
    "account_type": "Premium",
    "created_at": "2022-01-01T00:00:00Z"
  }
}

Account Stats

GET /account/stats

Retrieves account statistics for the authenticated user.

Response

{
  "status": true,
  "data": {
    "total_videos": 50,
    "total_views": 10000,
    "total_storage": 5000000000,
    "account_type": "Premium",
    "plays_remaining": 1000,
    "premium_start_date": "2023-01-01T00:00:00Z",
    "premium_expire_date": "2024-01-01T00:00:00Z"
  }
}

List Videos

GET /videos

Retrieves a paginated list of videos for the authenticated user.

Query Parameters

• page (optional): Page number (default: 1)
• per_page (optional): Number of items per page (default: 10)
• folder_id (optional): ID of the folder to filter videos

Response

{
  "status": true,
  "data": {
    "videos": [
      {
        // video object
      },
      // ...
    ],
    "total": 100,
    "pages": 10,
    "current_page": 1
  }
}

Manage Video

Get Video Details

GET /videos/<video_id>

Retrieves details of a specific video.

Update Video

PUT /videos/<video_id>

Updates a specific video's details.

Request Body

{
  "title": "Updated Video Title",
  "intro": {
    "start": 0.0,
    "end": 10.5
  },
  "outro": {
    "start": 590.0,
    "end": 600.0
  },
  "folder_id": 1  // Optional: ID of the folder to move the video to (null for root)
}

Delete Video

DELETE /videos/<video_id>

Deletes a specific video.

Get Direct Link (Only if you Have Premium View

GET /videos/<video_id>/direct-link

Retrieves the direct HLS URL for a specific video.

Response

{
  "status": true,
  "hls_url": "https://example.com/playlist/...",
  "video_id": "...",
  "title": "Video Title",
  "video_duration": 600,
  "intro": {
    "start": 0.0,
    "end": 10.5
  },
  "outro": {
    "start": 590.0,
    "end": 600.0
  },
  "thumbnail": "https://example.com/thumbnail/...",
  "status": "transcoded"
}

List Folders

GET /folders

Retrieves a list of folders for the authenticated user.

Response

{
  "status": true,
  "data": [
    {
      "id": 1,
      "name": "Folder 1",
      "parent_id": null,
      "parent_name": null,
      "total_files": 5
    },
    {
      "id": 2,
      "name": "Subfolder",
      "parent_id": 1,
      "parent_name": "Folder 1",
      "total_files": 3
    },
    // ... more folders
  ]
}

Create Folder

POST /folders

Creates a new folder for the authenticated user.

Request Body

{
  "name": "New Folder",
  "parent_id": null  // Optional, set to create a subfolder
}

Response

{
  "status": true,
  "message": "Folder created successfully",
  "folder": {
    "id": 3,
    "name": "New Folder",
    "parent_id": null,
    "parent_name": null,
    "total_files": 0
  }
}

Update Folder

PUT /folders?folder_id=<folder_id>

Updates an existing folder for the authenticated user.

Request Body

{
  "name": "Updated Folder Name",
  "parent_id": 1  // Optional, update parent folder
}

Response

{
  "status": true,
  "message": "Folder updated successfully",
  "folder": {
    "id": 3,
    "name": "Updated Folder Name",
    "parent_id": 1,
    "parent_name": "Folder 1",
    "total_files": 2
  }
}

Delete Folder

DELETE /folders?folder_id=<folder_id>

Deletes a specific folder for the authenticated user.

Response

{
  "status": true,
  "message": "Folder deleted successfully"
}

Get Upload Server

GET /upload-server

Retrieves the upload server information for video upload.

Parameters

• key: Your API key (query parameter)

Response

{
  "status": true,
  "data": {
    "id": 1,
    "upload_url": "https://example.com/upload?key=YOUR_API_KEY"
  }
}

Error Responses

// Invalid API key
{
  "status": false,
  "message": "Invalid API key"
}

// No available servers
{
  "status": false,
  "message": "No available servers"
}

Get Upload Server Examples

Upload Video

POST /upload-chunk

Uploads a video file to the server in chunks. Maximum chunk size is 100MB.

Parameters

• file: The chunk of the video file to upload (multipart/form-data)
• chunkIndex: The index of the current chunk (starting from 0)
• totalChunks: The total number of chunks for the file
• fileId: (Optional) A unique identifier for the file. If not provided, one will be generated.
• folderId: (Optional) The ID of the folder to upload to (default: 0 for root)

Response

// For intermediate chunks
{
  "fileId": "abcdef1234567890",
  "fileName": "video.mp4",
  "chunkIndex": 1,
  "message": "Chunk received"
}

// For the final chunk
{
  "file_id": "abcdef1234567890",
  "fileName": "video.mp4"
}

Error Responses

// No file part in request
{
  "error": "No file part"
}

// No selected file
{
  "error": "No selected file"
}

// File type not allowed
{
  "error": "File type not allowed"
}

// API key not provided
{
  "error": "API key not provided"
}

// Invalid API key
{
  "error": "Invalid API key"
}

// Missing chunk
{
  "error": "Chunk X missing"
}

Upload Examples

Player Messages

The player sends messages to the parent window using the postMessage API. These messages provide information about the current playback state.

Message Structure

{
  channel: 'vidcdn',
  event: 'time',
  time: number,
  duration: number,
  percent: number
}

Message Types

• time: Sent every 5 seconds during playback
  • Provides current playback time, total duration, and percentage played
  • Useful for tracking viewing progress and updating UI elements like progress bars
  • Can be used to implement features like resume playback or analytics
• complete: Sent when the video playback is complete
  • Indicates that the entire video has been watched
  • Can be used to trigger actions like showing related videos or updating watch history
  • Useful for analytics to track completed views

Message Details

Each message type includes the following information:

• channel: Always set to 'vidcdn' to identify the source of the message
• event: Either 'time' or 'complete' to indicate the message type
• time: Current playback time in seconds
• duration: Total duration of the video in seconds
• percent: Percentage of the video that has been played (0-100)

Listening for Messages

To receive these messages in your parent application, you need to add an event listener:

window.addEventListener('message', (event) => {
  if (event.data && event.data.channel === 'vidcdn') {
    const message = JSON.parse(event.data);
    switch (message.event) {
      case 'time':
        console.log('Current time:', message.time);
        console.log('Duration:', message.duration);
        console.log('Percent played:', message.percent);
        break;
      case 'complete':
        console.log('Video playback completed');
        break;
    }
  }
});

You can use these messages to track playback progress, update your UI, or trigger other actions in your application based on the video playback state.

Overview

In case of an error, the API will return an appropriate HTTP status code along with a JSON response containing an error message and additional details when applicable.

Error Codes

Common HTTP status codes you may encounter:

• 400 Bad Request: The request was invalid or cannot be served.
• 401 Unauthorized: The request requires authentication.
• 403 Forbidden: The server understood the request but refuses to authorize it.
• 404 Not Found: The requested resource could not be found.
• 429 Too Many Requests: You have sent too many requests in a given amount of time.
• 500 Internal Server Error: The server encountered an unexpected condition that prevented it from fulfilling the request.

Error Examples

Invalid API Key

HTTP/1.1 401 Unauthorized
Content-Type: application/json

{
  "status": false,
  "message": "Invalid API key"
}

Resource Not Found

HTTP/1.1 404 Not Found
Content-Type: application/json

{
  "status": false,
  "message": "The requested video could not be found"
}

Rate Limit Exceeded

HTTP/1.1 429 Too Many Requests
Content-Type: application/json

{
  "status": false,
  "message": "Rate limit exceeded. Please try again later.",
  "retry_after": 60
}

Overview

The Report API allows you to retrieve user statistics with custom filters.

Usage

GET /api/report

Retrieves a customized report of user statistics.

Query Parameters

• start_date (optional): Start date for the report (format: YYYY-MM-DD)
• end_date (optional): End date for the report (format: YYYY-MM-DD)
• video_id (optional): ID of the video to filter stats

Response

{
  "status": true,
  "data": {
    "report": [
      {
        "date": "2023-01-01",
        "views": 100,
        "plays": 50,
        "downloads": 20
      },
      {
        "date": "2023-01-02",
        "views": 120,
        "plays": 60,
        "downloads": 25
      },
      // ...
    ],
    "summary": {
      "total_views": 220,
      "total_plays": 110,
      "total_downloads": 45,
      "date_range": {
        "start": "2023-01-01",
        "end": "2023-01-02"
      }
    }
  }
}

Examples