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 autenticazione utilizzando la tua chiave API nell'header Authorization:

Authorization: YOUR_API_KEY

URL Base

https://telesto.app/v2

Limiti di Velocità

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

Il superamento del 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 vengono restituiti come stringhe vuote per coerenza.

Risposta di Successo

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

Risposta di Errore

{
    "statusCode": 401,
    "error": {
        "type": "UNAUTHORIZED",
        "description": "Invalid API key"
    }
}

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: YOUR_API_KEY"

Risposta

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

Best Practice

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

Suggerimento: Testa la tua integrazione in piccoli lotti prima per assicurarti di rispettare i limiti di velocità.

Documentazione Completa

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

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

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.