API Reference
Complete reference for all Lunar Stream Partner API endpoints.
Base URL
https://api.lunarstream.kozow.com/api/v1Authentication
All endpoints require API Key authentication:
| Header | Value |
|---|---|
ls-api-key | Your API Key from Lunar Stream admin |
Example:
bash
curl -X GET "https://api.lunarstream.kozow.com/api/v1/livestream?projectId=YOUR_PROJECT_ID" \
-H "ls-api-key: YOUR_API_KEY"Response Format
All responses follow this structure:
json
{
"data": { ... },
"meta": { ... }
}Pagination
List endpoints support pagination:
json
{
"data": [...],
"meta": {
"pagination": {
"page": 1,
"limit": 10,
"total": 100,
"totalPages": 10
}
}
}Error Responses
json
{
"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 |