Voorproefje: Capydra gaat binnenkort open. Bestellen is nog niet mogelijk.

Capydra
Help Cart
Deal of the week

Getting started

Deze handleiding is in het Engels geschreven.

  1. 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.
  2. Accept the two withdrawal-waiver sentences once. Every order made with the key refers to that acceptance.
  3. The key is shown once. Store it like a password (an environment variable or a secret store), never in code or a repository.
  4. Send it in every call: Authorization: Bearer omk_live_....
  5. 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).