Tài Liệu API

Tài liệu tham khảo đầy đủ cho tất cả các API endpoints của Lunar Stream Partner.

Base URL

https://api.xxxxxx.xxx/api/v1

Cấu Hình Môi Trường

Thay thế api.xxxxxx.xxx bằng domain API thực tế của bạn:

• Production: api.lunarstream.kozow.com
• Development: api-dev.lunarstream.kozow.com

Xem API Endpoints để biết cấu hình chi tiết.

Xác Thực

Tất cả endpoints yêu cầu xác thực API Key:

Header	Giá trị
ls-api-key	API Key của bạn từ Lunar Stream admin

Ví dụ:

curl -X GET "https://api.xxxxxx.xxx/api/v1/livestream?projectId=YOUR_PROJECT_ID" \
  -H "ls-api-key: YOUR_API_KEY"

Response Format

All responses follow this structure:

{
  "data": { ... },
  "meta": { ... }
}

Pagination

List endpoints support pagination:

{
  "data": [...],
  "meta": {
    "pagination": {
      "page": 1,
      "limit": 10,
      "total": 100,
      "totalPages": 10
    }
  }
}

Error Responses

{
  "statusCode": 400,
  "message": "Validation failed",
  "error": "Bad Request"
}

Status Code	Description
200	Success
201	Created
400	Bad Request - Invalid parameters
401	Unauthorized - Invalid/missing API Key
403	Forbidden - No permission
404	Not Found - Resource doesn't exist
500	Internal Server Error

API Endpoints

Streaming APIs

• Media Servers - Get available servers
• Livestreams - Stream management (CRUD)

Public APIs (No Auth Required)

• Public - Stream info for viewers

Rate Limits

Endpoint Type	Rate Limit
Livestream CRUD	100 req/min
Public APIs	1000 req/min

SDKs & Tools

• Node.js Example
• Python Example
• cURL Examples