Integrieren Sie Telesto mit Ihren eigenen internen Lösungen oder Drittanbieter-Services über unsere RESTful API. Perfekt für benutzerdefinierte 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

Ratenbegrenzungen

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

Das Überschreiten der Ratenbegrenzung führt zu einer temporären 15-minütigen Sperre für Ihre IP-Adresse.

Antwortformat

Alle Antworten werden im JSON-Format zurückgegeben. Leere oder null-Felder werden als leere Strings für Konsistenz 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 Ratenbegrenzung überschritten (15 Min. warten)
500 SERVER_ERROR Interner Fehler, versuchen Sie es später erneut

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

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

Tipp: Testen Sie Ihre Integration zunächst in kleinen Stapeln, um sicherzustellen, dass Sie innerhalb der Ratenbegrenzungen 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 an der Nutzung der API interessiert sind oder spezifische Endpunkte benötigen, kontaktieren Sie bitte unser Support-Team.