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

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

Ce poți face

  • Produse creează, citește, actualizează și șterge catalogul tău
  • Stoc pe depozit vezi exact unde se află stocul fiecărui produs, nu doar totalul din cont
  • Tranzacții introdu și scoate stoc și citește registrul complet pentru a-l reconcilia cu propriul sistem
  • Categorii, poziții de depozitare și furnizori creare, citire, actualizare și ștergere completă

Referință API

Documentația de referință completă descrie fiecare endpoint, parametru și răspuns, cu exemple de cod gata de folosit în curl, PHP, Python, Node și Ruby. Poți trimite chiar și cereri reale către propriul cont direct din pagină.

https://www.telesto.app/docs/api

Autentificare

Trimite cheia API în antetul Authorization la fiecare cerere. Trimite cheia brută, fără prefixul Bearer:

Authorization: YOUR_API_KEY

Limite de rată

100 de cereri pe oră, numărate pe fiecare cheie API. Depășirea acestei limite te blochează timp de 15 minute, iar răspunsul îți spune cât trebuie să aștepți. Cererile care eșuează la autentificare se numără în schimb pe adresa ta IP, așa că o cheie greșită nu îți consumă niciodată cota.

Bune practici

  • Păstrează cheia API în siguranță, niciodată în codul din partea clientului
  • Preia pagini mari în loc să faci multe cereri mici și memorează în cache tot ce nu se schimbă des
  • Respectă antetul Retry-After în loc să reîncerci imediat o cerere care a depășit limita de rată
  • Când actualizezi o înregistrare, trimite doar câmpurile pe care vrei să le modifici. Orice câmp omis își păstrează valoarea curentă
  • Dacă o tranzacție de stoc expiră, verifică lista de tranzacții înainte de a o trimite din nou. Reîncercarea orbește poate muta același stoc de două ori

Primii pași

  1. Asigură-te că ai un abonament Pro
  2. Contactează echipa de suport pentru a solicita acces la API și a obține cheia ta
  3. Deschide documentația API și încearcă o cerere direct din pagină

În prezent în Beta: Extindem în mod activ endpoint-urile și funcționalitatea API-ului. Dacă te interesează să folosești API-ul sau ai nevoie de anumite endpoint-uri, te rugăm să contactezi echipa noastră de suport.