Integrați Telesto cu propriile voastre soluții interne sau servicii terțe folosind API-ul nostru RESTful. Perfect pentru integrări personalizate și fluxuri de lucru automatizate.

Cerințe: Abonament Pro și cheie API validă necesare pentru toate endpoint-urile.

Autentificare

Toate cererile API necesită autentificare folosind cheia voastră API în header-ul Authorization:

Authorization: CHEIA_VOASTRĂ_API

URL de Bază

https://telesto.app/v2

Limite de Frecvență

  • 100 de cereri pe oră per adresă IP
  • Timeout de 15 minute dacă limita de frecvență este depășită
  • Toate cererile trebuie să includă cheia API în header-ul Authorization

Depășirea limitei de frecvență va rezulta într-un blocat temporar de 15 minute pentru adresa voastră IP.

Format de Răspuns

Toate răspunsurile sunt returnate în format JSON. Câmpurile goale sau null sunt returnate ca șiruri goale pentru consistență.

Răspuns de Succes

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

Răspuns de Eroare

{
    "statusCode": 401,
    "error": {
        "type": "UNAUTHORIZED",
        "description": "Cheie API invalidă"
    }
}

Coduri de Eroare

Cod Tip Descriere
401 UNAUTHORIZED Cheie API lipsă sau invalidă
403 FORBIDDEN Abonament Pro necesar
404 NOT_FOUND Resursa nu a fost găsită
429 TOO_MANY_REQUESTS Limita de frecvență depășită (așteptați 15 min)
500 SERVER_ERROR Eroare internă, încercați din nou mai târziu

Exemplu Rapid

Cerere

curl -X GET "https://telesto.app/v2/products" 
  -H "Authorization: CHEIA_VOASTRĂ_API"

Răspuns

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

Practici Recomandate

  • Stocați cheia voastră API în siguranță (niciodată în codul client-side)
  • Implementați logica de reîncercare pentru răspunsurile 429 (limită de frecvență)
  • Cache-uiți răspunsurile când este posibil pentru a reduce apelurile API
  • Folosiți HTTPS pentru toate cererile

Sfat: Testați integrarea în loturi mici mai întâi pentru a vă asigura că rămâneți în limitele de frecvență.

Documentație Completă

Documentația API completă cu parametri detaliați și exemple este disponibilă la:

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

Primii Pași

  1. Asigurați-vă că aveți un abonament Pro
  2. Contactați suportul pentru a solicita acces API și pentru a obține cheia
  3. Revizuiți documentația pentru endpoint-urile disponibile

În prezent în Beta: Extindem activ endpoint-urile API și funcționalitatea. Dacă sunteți interesați să folosiți API-ul sau aveți nevoie de endpoint-uri specifice, vă rugăm să contactați echipa noastră de suport.