Integra Telesto con le tue soluzioni interne o 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.

Autenticazione

Tutte le richieste API richiedono l'autenticazione utilizzando la tua chiave API nell'header Authorization:

Authorization: TUA_CHIAVE_API

URL Base

https://telesto.app/v2

Limiti di Velocità

  • 100 richieste per ora per indirizzo IP
  • Timeout di 15 minuti se viene superato il limite di velocità
  • Tutte le richieste devono includere la chiave API nell'header Authorization

Superare il limite di velocità comporterà un blocco temporaneo di 15 minuti per il tuo indirizzo IP.

Formato di Risposta

Tutte le risposte sono restituite in formato JSON. I campi vuoti o null sono restituiti come stringhe vuote per coerenza.

Risposta di Successo

{
    "id": "abc123...",
    "name": "Il Mio Prodotto",
    "created": "2024-01-15 10:30:00"
}

Risposta di Errore

{
    "statusCode": 401,
    "error": {
        "type": "UNAUTHORIZED",
        "description": "Chiave API non valida"
    }
}

Codici di Errore

Codice Tipo Descrizione
401 UNAUTHORIZED Chiave API mancante o non valida
403 FORBIDDEN Abbonamento Pro richiesto
404 NOT_FOUND Risorsa non trovata
429 TOO_MANY_REQUESTS Limite di velocità superato (attendi 15 min)
500 SERVER_ERROR Errore interno, riprova più tardi

Esempio Rapido

Richiesta

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

Risposta

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

Migliori Pratiche

  • Conserva la tua chiave API in modo sicuro (mai nel codice lato client)
  • Implementa la logica di riprova per le risposte 429 (limite di velocità)
  • Memorizza nella cache le risposte quando possibile per ridurre le chiamate API
  • Usa HTTPS per tutte le richieste

Suggerimento: Testa la tua integrazione in piccoli batch prima per assicurarti di rimanere entro i limiti di velocità.

Documentazione Completa

La documentazione API completa con parametri dettagliati ed esempi è disponibile su:

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

Come Iniziare

  1. Assicurati di avere un abbonamento Pro
  2. Contatta il supporto per richiedere l'accesso API e ottenere la tua chiave
  3. Rivedi la documentazione per gli endpoint disponibili

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