Integra Telesto con le tue soluzioni interne o con servizi di terze parti utilizzando la nostra API RESTful. Perfetta per integrazioni personalizzate e flussi di lavoro automatizzati.

Prerequisiti: abbonamento Pro e chiave API valida richiesti per tutti gli endpoint.

Cosa puoi fare

  • Prodotti crea, leggi, aggiorna ed elimina il tuo catalogo
  • Stock per magazzino vedi esattamente dove si trova lo stock di ogni prodotto, non solo il totale dell'account
  • Transazioni movimenta lo stock in entrata e in uscita, e consulta l'intero registro per riconciliarlo con il tuo sistema
  • Categorie, posizioni e fornitori crea, leggi, aggiorna ed elimina liberamente

Riferimento API

Il riferimento completo documenta ogni endpoint, parametro e risposta, con esempi di codice già pronti in curl, PHP, Python, Node e Ruby. Puoi anche inviare richieste reali al tuo account direttamente dalla pagina.

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

Autenticazione

Invia la tua chiave API nell'header Authorization a ogni richiesta. Invia la chiave grezza, senza il prefisso Bearer:

Authorization: YOUR_API_KEY

Limiti di frequenza

100 richieste all'ora, conteggiate per chiave API. Il superamento del limite ti blocca per 15 minuti, e la risposta ti indica quanto tempo attendere. Le richieste che falliscono l'autenticazione vengono invece conteggiate sul tuo indirizzo IP, così una chiave errata non consuma mai la tua quota.

Buone pratiche

  • Conserva la tua chiave API in modo sicuro, mai nel codice lato client
  • Recupera pagine di grandi dimensioni invece di effettuare tante piccole richieste, e memorizza nella cache tutto ciò che non cambia spesso
  • Rispetta l'header Retry-After invece di ripetere immediatamente una richiesta bloccata dal limite di frequenza
  • Quando aggiorni un record, invia solo i campi che vuoi modificare. Tutto ciò che ometti mantiene il suo valore attuale
  • Se una transazione di stock va in timeout, controlla l'elenco delle transazioni prima di inviarla di nuovo. Ripetere alla cieca può movimentare lo stesso stock due volte

Per iniziare

  1. Assicurati di avere un abbonamento Pro
  2. Contatta l'assistenza per richiedere l'accesso all'API e ottenere la tua chiave
  3. Apri la documentazione dell'API e prova una richiesta direttamente dalla pagina

Attualmente in Beta: Stiamo ampliando attivamente gli endpoint e le funzionalità dell'API. Se sei interessato a utilizzare l'API o hai bisogno di endpoint specifici, contatta il nostro team di assistenza.