Telesto API

Integrate Telesto with your own in-house solutions or third-party services using our RESTful API. Perfect for custom integrations and automated workflows.

Prerequisites: Pro subscription and valid API key required for all endpoints.

Authentication

All API requests require authentication using your API key in the Authorization header:

Base URL

Rate Limits

• 100 requests per hour per IP address
• 15-minute timeout if rate limit is exceeded
• All requests must include API key in Authorization header

Exceeding the rate limit will result in a temporary 15-minute block for your IP address.

Response Format

All responses are returned in JSON format. Empty or null fields are returned as empty strings for consistency.

Success Response

{
    "id": "abc123...",
    "name": "My Product",
    "created": "2024-01-15 10:30:00"
}

Error Response

{
    "statusCode": 401,
    "error": {
        "type": "UNAUTHORIZED",
        "description": "Invalid API key"
    }
}

Error Codes

Quick Example

Request

curl -X GET "https://telesto.app/v2/products" 
  -H "Authorization: YOUR_API_KEY"

Response

[
    {
        "id": "a1b2c3...",
        "name": "Widget",
        "ean_upc": "123456789",
        "stock_onhand": "50",
        "created": "2024-01-15 10:30:00"
    }
]

Best Practices

• Store your API key securely (never in client-side code)
• Implement retry logic for 429 (rate limit) responses
• Cache responses when possible to reduce API calls
• Use HTTPS for all requests

Tip: Test your integration in small batches first to ensure you stay within rate limits.

Full Documentation

Complete API documentation with detailed parameters and examples is available at:

Getting Started

1. Ensure you have a Pro subscription
2. Contact support to request API access and obtain your key
3. Review the documentation for available endpoints

Currently in Beta: We are actively expanding API endpoints and functionality. If you're interested in using the API or need specific endpoints, please contact our support team.