Integrieren Sie Telesto mit Ihren eigenen internen Lösungen oder Drittanbieter-Services über unsere RESTful API. Perfekt für individuelle Integrationen und automatisierte Workflows.

Voraussetzungen: Pro-Abonnement und gültiger API-Schlüssel erforderlich für alle Endpunkte.

Authentifizierung

Alle API-Anfragen erfordern eine Authentifizierung mit Ihrem API-Schlüssel im Authorization-Header:

Authorization: IHR_API_SCHLUESSEL

Basis-URL

https://telesto.app/v2

Ratenlimits

  • 100 Anfragen pro Stunde pro IP-Adresse
  • 15-Minuten-Timeout bei Überschreitung des Ratenlimits
  • Alle Anfragen müssen den API-Schlüssel im Authorization-Header enthalten

Das Überschreiten des Ratenlimits führt zu einer vorübergehenden 15-minütigen Sperrung Ihrer IP-Adresse.

Antwortformat

Alle Antworten werden im JSON-Format zurückgegeben. Leere oder null-Felder werden aus Konsistenzgründen als leere Strings zurückgegeben.

Erfolgreiche Antwort

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

Fehlerantwort

{
    "statusCode": 401,
    "error": {
        "type": "UNAUTHORIZED",
        "description": "Ungültiger API-Schlüssel"
    }
}

Fehlercodes

Code Typ Beschreibung
401 UNAUTHORIZED Fehlender oder ungültiger API-Schlüssel
403 FORBIDDEN Pro-Abonnement erforderlich
404 NOT_FOUND Ressource nicht gefunden
429 TOO_MANY_REQUESTS Ratenlimit überschritten (15 Min. warten)
500 SERVER_ERROR Interner Fehler, später erneut versuchen

Schnellbeispiel

Anfrage

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

Antwort

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

Best Practices

  • Speichern Sie Ihren API-Schlüssel sicher (niemals in clientseitigem Code)
  • Implementieren Sie Retry-Logik für 429 (Ratenlimit) Antworten
  • Cachen Sie Antworten wenn möglich, um API-Aufrufe zu reduzieren
  • Verwenden Sie HTTPS für alle Anfragen

Tipp: Testen Sie Ihre Integration zuerst in kleinen Batches, um sicherzustellen, dass Sie innerhalb der Ratenlimits bleiben.

Vollständige Dokumentation

Die vollständige API-Dokumentation mit detaillierten Parametern und Beispielen ist verfügbar unter:

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

Erste Schritte

  1. Stellen Sie sicher, dass Sie ein Pro-Abonnement haben
  2. Kontaktieren Sie den Support, um API-Zugang zu beantragen und Ihren Schlüssel zu erhalten
  3. Überprüfen Sie die Dokumentation für verfügbare Endpunkte

Derzeit in Beta: Wir erweitern aktiv die API-Endpunkte und -Funktionalität. Wenn Sie daran interessiert sind, die API zu verwenden oder spezielle Endpunkte benötigen, kontaktieren Sie bitte unser Support-Team.