Erste Schritte
- Melde dich an und öffne /account/api-keys. Erstelle einen Schlüssel: Name, Bereich (Käufer oder Verkäufer) und die Rechte, die er braucht. Gib ihm so wenige wie möglich.
- Bestätige die beiden Sätze zum Widerrufsverzicht einmal. Jede Bestellung mit dem Schlüssel verweist auf diese Zustimmung.
- Der Schlüssel wird einmal angezeigt. Bewahre ihn wie ein Passwort auf (Umgebungsvariable oder Secret-Speicher), nie im Code oder in einem Repository.
- Sende ihn bei jedem Aufruf:
Authorization: Bearer omk_live_.... - Trage die IP-Adressen deiner Server in die IP-Liste des Schlüssels ein und setze ein Tageslimit, das zu deinen Verkäufen passt.
Erste Aufrufe
export CAPYDRA_KEY=omk_test_... # the key from /account/api-keys, shown once
# 1. Who am I, which limits apply
curl -s "https://developers.capydra.com/api/v1/keys/usage" -H "Authorization: Bearer $CAPYDRA_KEY"
# 2. The catalogue, only what changed in the last hour, without prices (stock projection)
curl -s "https://developers.capydra.com/api/v1/catalog/products?updatedSince=2026-11-16T08:00:00Z&projection=stock" \
-H "Authorization: Bearer $CAPYDRA_KEY"
# 3. Order one key with a price ceiling; the Idempotency-Key makes a retry safe
curl -s -X POST "https://developers.capydra.com/api/v1/purchase/orders" \
-H "Authorization: Bearer $CAPYDRA_KEY" -H "Content-Type: application/json" \
-H "Idempotency-Key: order-10001" \
-d '{"product_id":"prd_elden_ring","qty":1,"max_unit_price_cents":2500,"external_id":"shop-10001"}'
Geldbeträge sind ganze Euro-Cent. Ein Preis ist ein Endpreis: die Servicegebühr ist enthalten. JSON-Felder heißen in snake_case; Zeiten sind ISO 8601 in UTC.
Maschinenlesbar: /developers/openapi.json (OpenAPI 3.1).