Getting Started
Learn the basics of the Velora API and make your first request in minutes.
1Create an Application
First, you'll need to create an application in the Developer Dashboard. This gives you a Client ID and Client Secret for authentication.
- Go to the Developer Dashboard
- Click "New Application"
- Fill in your application name and description
- Add your OAuth redirect URI(s)
- Save your Client ID and Client Secret securely
Important: Your Client Secret is only shown once. Store it securely - you'll need it for authentication.
2Authentication
Velora uses OAuth 2.0 with PKCE for secure authentication. For server-to-server requests, you can use Client Credentials.
Authorization Code Flow
For user-specific access, exchange the authorization code for tokens:
curl -X POST https://api.velora.tv/api/developer/oauth/token \
-H "Content-Type: application/json" \
-d '{
"grant_type": "authorization_code",
"code": "AUTH_CODE_FROM_CALLBACK",
"redirect_uri": "YOUR_REDIRECT_URI",
"client_id": "YOUR_CLIENT_ID",
"client_secret": "YOUR_CLIENT_SECRET",
"code_verifier": "YOUR_PKCE_CODE_VERIFIER"
}'Response
{
"access_token": "eyJhbGciOiJSUzI1NiIsInR5cCI...",
"token_type": "Bearer",
"expires_in": 3600
}For user-specific actions, see the Authentication guide.
3Make Your First Request
Now you can make authenticated requests to the API. Let's get a list of live streams:
curl https://api.velora.tv/api/streams \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
Response
{
"streams": [
{
"id": "abc123",
"userId": "user_123",
"username": "coolstreamer",
"title": "Playing Velora Games!",
"viewerCount": 1234,
"startedAt": "2026-01-18T10:30:00Z",
"thumbnailUrl": "https://cdn.velora.tv/..."
}
],
"pagination": {
"cursor": "eyJsYXN0X2lkIjoi..."
}
}Base URL
All API requests are made to the following base URL:
https://api.velora.tvRate Limits
The API has rate limits to ensure fair usage:
| Environment | Rate Limit |
|---|---|
| Sandbox | 30 requests/minute |
| Production | 800 requests/minute |
See the Rate Limits guide for more details.