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

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

Autentificare

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

Authorization: CHEIA_TA_API

URL de bază

https://telesto.app/v2

Limite de rată

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

Depășirea limitei de rată va rezulta într-o blocare temporară de 15 minute pentru adresa ta IP.

Format 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 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 rată depășită (așteaptă 15 min)
500 SERVER_ERROR Eroare internă, încearcă din nou mai târziu

Exemplu rapid

Cerere

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

Răspuns

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

Bune practici

  • Stochează cheia ta API în siguranță (niciodată în cod client-side)
  • Implementează logica de reîncercare pentru răspunsurile 429 (limită de rată)
  • Folosește cache pentru răspunsuri când este posibil pentru a reduce apelurile API
  • Folosește HTTPS pentru toate cererile

Sfat: Testează integrarea ta în loturi mici mai întâi pentru a te asigura că rămâi în limitele de rată.

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. Asigură-te că ai un abonament Pro
  2. Contactează suportul pentru a solicita acces API și pentru a obține cheia ta
  3. Revizuiește documentația pentru endpoint-urile disponibile

Momentan în Beta: Extindem activ endpoint-urile API și funcționalitatea. Dacă ești interesat să folosești API-ul sau ai nevoie de endpoint-uri specifice, te rugăm să contactezi echipa noastră de suport.