Getting started
Ez az útmutató angol nyelven íródott.
- Sign in and open /account/api-keys. Create a key: a name, the scope (buyer or seller) and the permissions it needs. Give it as few as you can.
- Accept the two withdrawal-waiver sentences once. Every order made with the key refers to that acceptance.
- The key is shown once. Store it like a password (an environment variable or a secret store), never in code or a repository.
- Send it in every call:
Authorization: Bearer omk_live_.... - Add the IP addresses of your servers to the key's allowlist and set a daily order limit that fits your sales.
First calls
export CAPYDRA_KEY=omk_test_... # the key from /account/api-keys, shown once
# 1. Who am I, which limits apply
curl -s "https://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://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://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"}'
Money is in integer euro cents. A price is all in: it includes the service fee. JSON field names use snake_case; dates are ISO 8601 in UTC.
Machine-readable: /developers/openapi.json (OpenAPI 3.1).