Integrieren Sie Telesto über unsere RESTful-API in Ihre eigenen internen Lösungen oder Drittanbieterdienste. Perfekt für individuelle Integrationen und automatisierte Workflows.

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

Ihre Möglichkeiten

  • Produkte erstellen, lesen, aktualisieren und löschen Sie Ihren Katalog
  • Bestand nach Lager sehen Sie genau, wo sich der Bestand jedes Produkts befindet, nicht nur die Gesamtsumme des Kontos
  • Transaktionen buchen Sie Bestand ein und aus und lesen Sie das vollständige Journal aus, um es mit Ihrem eigenen System abzugleichen
  • Kategorien, Lagerorte und Lieferanten vollständiges Erstellen, Lesen, Aktualisieren und Löschen

API-Referenz

Die vollständige Referenz dokumentiert jeden Endpunkt, jeden Parameter und jede Antwort, mit fertigen Codebeispielen in curl, PHP, Python, Node und Ruby. Sie können auch direkt von der Seite aus echte Anfragen an Ihr eigenes Konto senden.

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

Authentifizierung

Senden Sie Ihren API-Schlüssel bei jeder Anfrage im Authorization-Header. Senden Sie den reinen Schlüssel, ohne Bearer-Präfix:

Authorization: YOUR_API_KEY

Ratenbegrenzungen

100 Anfragen pro Stunde, gezählt pro API-Schlüssel. Bei Überschreitung werden Sie für 15 Minuten gesperrt, und die Antwort teilt Ihnen mit, wie lange Sie warten müssen. Anfragen, die die Authentifizierung nicht bestehen, werden stattdessen Ihrer IP-Adresse angerechnet, sodass ein falscher Schlüssel niemals Ihr Kontingent aufbraucht.

Bewährte Vorgehensweisen

  • Bewahren Sie Ihren API-Schlüssel sicher auf, niemals im clientseitigen Code
  • Rufen Sie große Seiten ab, anstatt viele kleine Anfragen zu stellen, und cachen Sie alles, was sich nicht häufig ändert
  • Beachten Sie den Retry-After-Header, anstatt eine ratenbegrenzte Anfrage sofort zu wiederholen
  • Wenn Sie einen Datensatz aktualisieren, senden Sie nur die Felder, die Sie ändern möchten. Alles, was Sie weglassen, behält seinen aktuellen Wert
  • Wenn eine Bestandstransaktion das Zeitlimit überschreitet, prüfen Sie die Transaktionsliste, bevor Sie sie erneut senden. Ein blindes Wiederholen kann denselben Bestand doppelt bewegen

Erste Schritte

  1. Stellen Sie sicher, dass Sie ein Pro-Abonnement haben
  2. Wenden Sie sich an den Support, um API-Zugang anzufordern und Ihren Schlüssel zu erhalten
  3. Öffnen Sie die API-Referenz und probieren Sie eine Anfrage direkt von der Seite aus

Derzeit in der Beta-Phase: Wir erweitern die API-Endpunkte und -Funktionen laufend. Wenn Sie die API nutzen möchten oder bestimmte Endpunkte benötigen, wenden Sie sich bitte an unser Support-Team.