Vorschau: Capydra öffnet bald. Bestellen ist noch nicht möglich.

Capydra
Plus Hilfe Warenkorb
Deal der Woche

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.

Öffnet baldZur 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.

Bereit, öffnet mit dem Verkaufsstart

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 Verkaufsstart
  • Bestellungen auslösen

    Eine Bestellung pro Aufruf, mit Preisgrenze, Ihrer eigenen Nummer und einem Schlüssel gegen Doppelkäufe.

    Bereit, öffnet mit dem Verkaufsstart
  • Keys abholen

    Mit einem eigenen Recht, gezählt und protokolliert. Der erste Abruf beendet das Widerrufsrecht dieser Bestellung.

    Bereit, öffnet mit dem Verkaufsstart
  • Webhooks empfangen

    Signierte Aufrufe an Ihren Server, wenn sich eine Bestellung oder ein Produkt ändert. Bis zu 3 Adressen.

    Bereit, öffnet mit dem Verkaufsstart
  • Als Verkäufer anbieten

    Angebote, Preise und Bestand aus Ihrem Lagersystem pflegen. Das setzt voraus, dass Verkauf auf Capydra offen ist.

    Bereit, öffnet mit dem Verkaufsstart
  • Mit 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. 1

    Konto anlegen

    Sie melden sich im Shop an.

  2. 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. 3

    Verzichtserklärung bestätigen

    Zwei Sätze zum Widerruf, einmal. Jede Bestellung mit dem Schlüssel verweist darauf.

  4. 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. 5

    Tageslimit setzen

    Die Summe aller Bestellungen eines Tages ist begrenzt: 250 € bei einem neuen Schlüssel, bis 5.000 € einstellbar.

  6. 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

403

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