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

Capydra
Hilfe Warenkorb
Deal der Woche

Anmeldung und IP-Liste

Schlüssel

  • Ein Schlüssel sieht aus wie omk_live_ plus 32 Zeichen. Wir speichern nur seinen SHA-256-Hash und können ihn nicht noch einmal zeigen. Verloren: erneuern oder sperren.
  • Schlüssel laufen ab (Standard 365 Tage, höchstens 730). Beim Erneuern entsteht ein neuer Schlüssel; der alte funktioniert bis zu 168 Stunden weiter, damit du ohne Ausfall wechselst.
  • Schlüssel werden nur in einer angemeldeten Browsersitzung erstellt, geändert und gesperrt, nie mit einem Schlüssel.

Rechte

RechtErlaubt
catalog:readKatalog und Produkte.
orders:write (auch orders:create)Bestellungen anlegen.
orders:readEigene Bestellungen und den Guthaben-Platzhalter lesen.
keys:readKeys gelieferter Bestellungen abrufen. Nötig für jeden Key-Abruf über die API oder MCP.
webhooks:manageEigene Webhook-Endpunkte verwalten.
seller:read, offers:write, stock:writeNur Verkäufer-Schlüssel: Angebote und Reservierungen lesen, Angebote und Preise ändern, Keys hochladen.

Ein Schlüssel ohne Liste hat alle Rechte seines Bereichs. Ein Aufruf außerhalb der Liste antwortet 403 permission_required mit dem nötigen Recht.

IP-Liste (selbst einstellbar)

Bis zu 20 Einträge je Schlüssel: IPv4-Adressen, IPv4-Bereiche von /8 bis /32 oder IPv6-Adressen. Beim Erstellen oder später unter „Einstellungen“ auf der Schlüsselseite. Ein Aufruf von einer anderen Adresse antwortet 403 ip_not_allowed. Viele solche Antworten frieren den Schlüssel ein, denn meist ist er dann geleakt.

Signierte Anfragen (optional)

Für den stärksten Schutz hinterlegst du einen Ed25519-Public-Key am Schlüssel. Danach muss jeder Aufruf eine HTTP-Message-Signatur tragen (RFC 9421); der Schlüssel allein reicht nicht mehr. Details: /docs.

Wenn ein Schlüssel geleakt ist

Sperre ihn sofort auf der Schlüsselseite und erstelle einen neuen. Bis dahin begrenzen Tageslimit und IP-Liste den Schaden.