Integreer Telesto met uw eigen interne oplossingen of diensten van derden met behulp van onze RESTful API. Perfect voor aangepaste integraties en geautomatiseerde workflows.

Vereisten: Pro-abonnement en geldige API-sleutel vereist voor alle endpoints.

Authenticatie

Alle API-verzoeken vereisen authenticatie met behulp van uw API-sleutel in de Authorization header:

Authorization: YOUR_API_KEY

Basis URL

https://telesto.app/v2

Rate Limits

  • 100 verzoeken per uur per IP-adres
  • 15 minuten timeout indien rate limit wordt overschreden
  • Alle verzoeken moeten API-sleutel in Authorization header bevatten

Het overschrijden van de rate limit resulteert in een tijdelijke blokkering van 15 minuten voor uw IP-adres.

Response Formaat

Alle responses worden geretourneerd in JSON-formaat. Lege of null velden worden geretourneerd als lege strings voor consistentie.

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

Code Type Beschrijving
401 UNAUTHORIZED Ontbrekende of ongeldige API-sleutel
403 FORBIDDEN Pro-abonnement vereist
404 NOT_FOUND Resource niet gevonden
429 TOO_MANY_REQUESTS Rate limit overschreden (wacht 15 min)
500 SERVER_ERROR Interne fout, probeer later opnieuw

Snel Voorbeeld

Verzoek

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

  • Bewaar uw API-sleutel veilig (nooit in client-side code)
  • Implementeer retry-logica voor 429 (rate limit) responses
  • Cache responses wanneer mogelijk om API-aanroepen te verminderen
  • Gebruik HTTPS voor alle verzoeken

Tip: Test uw integratie eerst in kleine batches om ervoor te zorgen dat u binnen de rate limits blijft.

Volledige Documentatie

Volledige API-documentatie met gedetailleerde parameters en voorbeelden is beschikbaar op:

https://documenter.getpostman.com/view/3493/2s93Y2R1a8

Aan de Slag

  1. Zorg ervoor dat u een Pro-abonnement heeft
  2. Neem contact op met support om API-toegang aan te vragen en uw sleutel te verkrijgen
  3. Bekijk de documentatie voor beschikbare endpoints

Momenteel in Beta: We breiden actief API-endpoints en functionaliteit uit. Als u geïnteresseerd bent in het gebruik van de API of specifieke endpoints nodig heeft, neem dan contact op met ons supportteam.