API
Katalog, Bestellungen und Keys per Schnittstelle
Holen Sie unseren Katalog in Ihr System, lösen Sie Bestellungen aus und holen Sie die Keys ab. Diese Seite zeigt den Weg in sechs Schritten. Limits, Testumgebung und Grenzen stehen in der Dokumentation.
Das geht, sobald der Shop öffnet. Bis dahin können Sie alles in Ruhe lesen.
Entwicklerseite
OpenAPI
Jeder Aufruf ist als OpenAPI-3.1-Datei beschrieben. Jede Zahl auf den Seiten ist die Zahl, die der Code erzwingt.
- BearerEin Schlüssel pro Anwendung, nur als Hash gespeichert, mit Ablauf und Rotation
- JSONGeld in ganzen Cent, Daten nach ISO 8601, Namen in snake_case
- 120 pro MinuteLesen für einen neuen Schlüssel, 600 sobald er 7 Tage alt ist
- SigniertWebhooks mit Signatur, auf Wunsch auch signierte Aufrufe (RFC 9421)
Die API ist gebaut und getestet, die Dokumentation ist online. Schlüssel lassen sich anlegen, sobald der Shop öffnet. Noch nicht vorhanden und nur geplant: ein fertiges Software-Kit, ein Vorabguthaben.
Was Sie damit tun können
Katalog abgleichen
Die ganze Liste einmal laden, danach nur, was sich seit Ihrem letzten Abgleich geändert hat. Eine leichte Ansicht zeigt nur den Bestand.
Bereit, öffnet mit dem VerkaufsstartBestellungen auslösen
Eine Bestellung pro Aufruf, mit Preisgrenze, Ihrer eigenen Nummer und einem Schlüssel gegen Doppelkäufe.
Bereit, öffnet mit dem VerkaufsstartKeys abholen
Mit einem eigenen Recht, gezählt und protokolliert. Der erste Abruf beendet das Widerrufsrecht dieser Bestellung.
Bereit, öffnet mit dem VerkaufsstartWebhooks empfangen
Signierte Aufrufe an Ihren Server, wenn sich eine Bestellung oder ein Produkt ändert. Bis zu 3 Adressen.
Bereit, öffnet mit dem VerkaufsstartAls Verkäufer anbieten
Angebote, Preise und Bestand aus Ihrem Lagersystem pflegen. Das setzt voraus, dass Verkauf auf Capydra offen ist.
Bereit, öffnet mit dem VerkaufsstartMit KI-Assistenten nutzen
Dasselbe Konto funktioniert über unseren MCP-Server. Die Regeln und Limits sind dieselben.
Bereit, öffnet mit dem Verkaufsstart
In sechs Schritten zum ersten Aufruf
- 1
Konto anlegen
Sie melden sich im Shop an.
- 2
Schlüssel anlegen
Unter „API-Schlüssel“: Name, Rolle (Käufer oder Verkäufer) und die Rechte, die Sie brauchen. Geben Sie so wenige wie möglich.
- 3
Verzichtserklärung bestätigen
Zwei Sätze zum Widerruf, einmal. Jede Bestellung mit dem Schlüssel verweist darauf.
- 4
Schlüssel sichern
Er wird nur einmal angezeigt. Legen Sie ihn wie ein Passwort ab und tragen Sie die IP-Adressen Ihrer Server in die Liste ein.
- 5
Tageslimit setzen
Die Summe aller Bestellungen eines Tages ist begrenzt: 250 € bei einem neuen Schlüssel, bis 5.000 € einstellbar.
- 6
Ersten Aufruf senden
Mit dem Schlüssel im Kopf „Authorization“. Das Beispiel unten liest die ersten Produkte.
Der erste Aufruf
Ein Schlüssel beginnt mit omk_live_. Er geht in jeden Aufruf als Bearer-Wert. Geld ist in ganzen Cent angegeben und enthält die Servicegebühr.
curl "https://capydra.com/api/v1/catalog/products?page=1" \
-H "Authorization: Bearer omk_live_YOUR_KEY"
# nur, was sich seit Ihrem letzten Abgleich geändert hat
curl "https://capydra.com/api/v1/catalog/products?updatedSince=2026-11-17T00:00:00Z" \
-H "Authorization: Bearer omk_live_YOUR_KEY"Weiter in der Dokumentation
Der Shop ist noch nicht offen: Aufrufe, die etwas ändern, antworten mit 403 showcase_mode, und die Antworten enthalten keine Preise.
Häufige Fragen
Was kostet die API?
Der Zugang kostet nichts. Sie zahlen die Bestellungen, die Sie auslösen. Eine Grundgebühr gibt es nicht.
Gibt es ein Software-Kit?
Noch nicht. Die Dokumentation hat Beispiele mit curl, und die OpenAPI-Datei lässt sich in die gängigen Werkzeuge laden.
Wie bekomme ich höhere Limits?
Schreiben Sie uns Ihr Vorhaben und Ihre Menge. Wir erhöhen für Partner, bei denen wir den Bedarf sehen.
Was passiert, wenn mein Schlüssel gestohlen wird?
Sperren Sie ihn auf der Schlüsselseite und legen Sie einen neuen an. Bis dahin begrenzen das Tageslimit und die IP-Liste den Schaden. Auffällige Aufrufe frieren den Schlüssel von selbst ein.
Wo melde ich einen Fehler in der API?
Über das Kontaktformular mit dem Thema API. Nennen Sie den Aufruf und die Uhrzeit.
Bereit für den ersten Aufruf?
Lesen Sie die Entwicklerseite durch und legen Sie dann einen Schlüssel an.
Anfrage senden