Developer Surface
Comprehensive documentation, API references, webhook specifications, and code examples
Documentation
Getting Started
Quick start guide for integrating with Telly APIs and SDKs
API Reference
Complete API documentation with endpoints, parameters, and examples
Webhook Specification
Learn how to receive real-time events and notifications
SDK Documentation
JavaScript/TypeScript SDK with examples and best practices
Authentication
API keys, OAuth, and security best practices
Code Examples
Sample implementations and integration patterns
API Reference
/api/v1/titlescatalogRetrieve a list of titles with filtering and pagination
/api/v1/titles/{id}catalogGet detailed information about a specific title
/api/v1/titles/{id}/likeinteractionsLike a title (requires authentication)
/api/v1/titles/{id}/super-likeinteractionsSuper-like a title (requires authentication)
/api/v1/sessionssessionsList active and scheduled Duo sessions
/api/v1/sessionssessionsCreate a new Duo session
/api/v1/sessions/{id}/joinsessionsJoin an existing Duo session
/api/v1/webhookswebhooksList registered webhooks for your application
/api/v1/webhookswebhooksRegister a new webhook endpoint
Webhook Specification
Overview
Webhooks allow you to receive real-time notifications about events in the Telly platform. Configure your webhook endpoints to receive POST requests when specific events occur.
Endpoint Requirements
- •Must accept POST requests
- •Must respond with 200 status code within 5 seconds
- •Must use HTTPS (TLS 1.2+)
- •Must verify webhook signatures for security
session.created
Triggered when a new Duo session is created
Example Payload:
{
"session_id": "string",
"host_id": "string",
"created_at": "datetime"
}session.started
Triggered when a session begins
Example Payload:
{
"session_id": "string",
"started_at": "datetime"
}session.ended
Triggered when a session ends
Example Payload:
{
"session_id": "string",
"ended_at": "datetime",
"duration": "number"
}title.liked
Triggered when a title receives a like
Example Payload:
{
"title_id": "string",
"user_id": "string",
"timestamp": "datetime"
}sync.status.changed
Triggered when sync status changes in a session
Example Payload:
{
"session_id": "string",
"status": "string",
"metrics": "object"
}Changelog
API v2.1.0
March 10, 2024
- Added new endpoints for enhanced session management
- Improved webhook payload structure with additional metadata
- Enhanced error responses with detailed error codes
API v2.0.5
February 28, 2024
- Fixed pagination issues in title listing endpoints
- Resolved webhook signature verification edge cases