Podgląd: Capydra wkrótce rusza. Składanie zamówień nie jest jeszcze możliwe.

Capydra
Help Cart
Deal of the week

Authentication and IP list

Ten przewodnik jest napisany po angielsku.

Keys

  • A key looks like omk_live_ plus 32 characters. We store only its SHA-256 hash; we cannot show it again. Lost: rotate or revoke it.
  • Keys expire (365 days by default, at most 730). Rotation makes a new key and keeps the old one working for up to 168 hours, so you can swap without downtime.
  • Keys are made, changed and revoked only in a signed-in browser session, never with a key.

Permissions (scopes)

PermissionAllows
catalog:readCatalogue and products.
orders:write (also called orders:create)Create orders.
orders:readRead your orders and the balance placeholder.
keys:readFetch the keys of delivered orders. Needed for every key reveal through the API or MCP.
webhooks:manageManage your webhook endpoints.
seller:read, offers:write, stock:writeSeller keys only: read offers and reservations, change offers and prices, upload keys.

A key without a list has every permission of its scope. A call outside the list answers 403 permission_required with the permission it needs.

IP allowlist (self-service)

Up to 20 entries per key: IPv4 addresses, IPv4 ranges from /8 to /32, or IPv6 addresses. Set it when you make the key or later under "Settings" on the key page. A call from any other address answers 403 ip_not_allowed. Many such answers freeze the key, because they usually mean the key leaked.

Signed requests (optional)

For the strongest protection, store an Ed25519 public key on the key. From then on every call must carry an HTTP message signature (RFC 9421); the key alone is no longer enough. Details: /docs.

If a key leaks

Revoke it on the key page at once and make a new one. Until then the daily order limit and the IP allowlist cap the damage.