API
Katalog, beställningar och nycklar via gränssnitt
Hämta vår katalog till ert system, utlös beställningar och hämta nycklarna. Den här sidan visar vägen i sex steg. Gränser, testmiljö och begränsningar finns i dokumentationen.
Det fungerar så snart butiken öppnar. Tills dess kan ni läsa allt i lugn och ro.
Utvecklarsida
OpenAPI
Varje anrop beskrivs i en OpenAPI 3.1-fil. Varje siffra på sidorna är den siffra som koden tillämpar.
- BearerEn nyckel per applikation, lagras bara som hash, med utgångsdatum och rotation
- JSONPengar i hela cent, datum enligt ISO 8601, namn i snake_case
- 120 per minutläsningar för en ny nyckel, 600 när den är 7 dagar gammal
- SigneratWebhooks med signatur, på begäran även signerade anrop (RFC 9421)
API:t är byggt och testat, dokumentationen finns online. Nycklar kan skapas så snart butiken öppnar. Finns ännu inte och är bara planerat: ett färdigt programvarupaket, ett förskottssaldo.
Det här kan ni göra med det
Stäm av katalogen
Läs in hela listan en gång, därefter bara det som ändrats sedan er senaste avstämning. En lätt vy visar bara lagersaldot.
Klart, öppnar när försäljningen startarUtlös beställningar
En beställning per anrop, med pristak, ert eget nummer och en nyckel mot dubbelköp.
Klart, öppnar när försäljningen startarHämta nycklar
Med en egen rättighet, räknat och loggat. Det första anropet avslutar ångerrätten för den beställningen.
Klart, öppnar när försäljningen startarTa emot webhooks
Signerade anrop till er server när en beställning eller en produkt ändras. Upp till 3 adresser.
Klart, öppnar när försäljningen startarErbjud som säljare
Sköt erbjudanden, priser och lagersaldo från ert lagersystem. Det förutsätter att försäljning på Capydra är öppen.
Klart, öppnar när försäljningen startarAnvänd med AI-assistenter
Samma konto fungerar via vår MCP-server. Reglerna och gränserna är desamma.
Klart, öppnar när försäljningen startar
Sex steg till det första anropet
- 1
Skapa ett konto
Ni loggar in i butiken.
- 2
Skapa en nyckel
Under ”API-nycklar”: ett namn, rollen (köpare eller säljare) och de rättigheter ni behöver. Ge så få som möjligt.
- 3
Bekräfta avståendet
Två meningar om ångerrätt, en gång. Varje beställning som görs med nyckeln hänvisar till dem.
- 4
Säkra nyckeln
Den visas bara en gång. Förvara den som ett lösenord och lägg in era servrars IP-adresser i listan.
- 5
Sätt en dagsgräns
Summan av alla beställningar under en dag är begränsad: €250 för en ny nyckel, kan ställas in upp till €5,000.
- 6
Skicka det första anropet
Med nyckeln i rubriken ”Authorization”. Exemplet nedan läser de första produkterna.
Det första anropet
En nyckel börjar med omk_live_. Den går in i varje anrop som bearer-värde. Pengar anges i hela cent och inkluderar serviceavgiften.
curl "https://capydra.com/api/v1/catalog/products?page=1" \
-H "Authorization: Bearer omk_live_YOUR_KEY"
# bara det som ändrats sedan er senaste avstämning
curl "https://capydra.com/api/v1/catalog/products?updatedSince=2026-11-17T00:00:00Z" \
-H "Authorization: Bearer omk_live_YOUR_KEY"Vidare i dokumentationen
Butiken är ännu inte öppen: anrop som ändrar något svarar med 403 showcase_mode, och svaren innehåller inga priser.
Vanliga frågor
Vad kostar API:t?
Åtkomsten är gratis. Ni betalar för de beställningar ni utlöser. Någon grundavgift finns inte.
Finns det ett programvarupaket?
Inte ännu. Dokumentationen har exempel med curl, och OpenAPI-filen går att läsa in i de vanliga verktygen.
Hur får jag högre gränser?
Skriv till oss med ert projekt och er mängd. Vi höjer för partner där vi ser behovet.
Vad händer om min nyckel blir stulen?
Spärra den på nyckelsidan och skapa en ny. Fram till dess begränsar dagsgränsen och IP-listan skadan. Avvikande anrop fryser nyckeln av sig själva.
Var anmäler jag ett fel i API:t?
Via kontaktformuläret med ämnet API. Ange anropet och klockslaget.
Redo för det första anropet?
Läs igenom utvecklarsidan och skapa sedan en nyckel.
Skicka en förfrågan