API
Katalog, ordrer og nøgler via en grænseflade
Hent vores katalog ind i jeres system, udløs ordrer og hent nøglerne. Denne side viser vejen i seks trin. Grænser, testmiljø og begrænsninger står i dokumentationen.
Det virker, så snart butikken åbner. Indtil da kan I læse alt i ro og mag.
Udviklerside
OpenAPI
Hvert kald er beskrevet i en OpenAPI 3.1-fil. Hvert tal på siderne er det tal, som koden håndhæver.
- BearerÉn nøgle pr. applikation, gemmes kun som hash, med udløb og rotation
- JSONPenge i hele cent, datoer efter ISO 8601, navne i snake_case
- 120 pr. minutlæsninger for en ny nøgle, 600 når den er 7 dage gammel
- SigneretWebhooks med signatur, på ønske også signerede kald (RFC 9421)
API'et er bygget og testet, dokumentationen er online. Nøgler kan oprettes, så snart butikken åbner. Findes endnu ikke og er kun planlagt: et færdigt softwarekit, en forudbetalt saldo.
Det kan I bruge den til
Afstem kataloget
Indlæs hele listen én gang, derefter kun det, der er ændret siden jeres seneste afstemning. En let visning viser kun lagerbeholdningen.
Klar, åbner ved salgsstartUdløs ordrer
Én ordre pr. kald, med prisloft, jeres eget nummer og en nøgle mod dobbeltkøb.
Klar, åbner ved salgsstartHent nøgler
Med en egen rettighed, talt og logget. Det første kald afslutter fortrydelsesretten for den ordre.
Klar, åbner ved salgsstartModtag webhooks
Signerede kald til jeres server, når en ordre eller et produkt ændres. Op til 3 adresser.
Klar, åbner ved salgsstartTilbyd som sælger
Vedligehold tilbud, priser og lagerbeholdning fra jeres lagersystem. Det forudsætter, at salg på Capydra er åbent.
Klar, åbner ved salgsstartBrug med AI-assistenter
Den samme konto virker via vores MCP-server. Reglerne og grænserne er de samme.
Klar, åbner ved salgsstart
Seks trin til det første kald
- 1
Opret en konto
I logger ind i butikken.
- 2
Opret en nøgle
Under „API-nøgler”: et navn, rollen (køber eller sælger) og de rettigheder, I har brug for. Giv så få som muligt.
- 3
Bekræft afkaldet
To sætninger om fortrydelse, én gang. Hver ordre, der lægges med nøglen, henviser til dem.
- 4
Sikr nøglen
Den vises kun én gang. Opbevar den som en adgangskode, og tilføj jeres servere IP-adresser til listen.
- 5
Sæt en dagsgrænse
Summen af alle ordrer på en dag er begrænset: €250 for en ny nøgle, kan sættes op til €5,000.
- 6
Send det første kald
Med nøglen i headeren „Authorization”. Eksemplet nedenfor læser de første produkter.
Det første kald
En nøgle begynder med omk_live_. Den indgår i hvert kald som bearer-værdi. Penge angives i hele cent og indeholder servicegebyret.
curl "https://capydra.com/api/v1/catalog/products?page=1" \
-H "Authorization: Bearer omk_live_YOUR_KEY"
# kun det, der er ændret siden jeres seneste afstemning
curl "https://capydra.com/api/v1/catalog/products?updatedSince=2026-11-17T00:00:00Z" \
-H "Authorization: Bearer omk_live_YOUR_KEY"Videre i dokumentationen
Butikken er endnu ikke åben: kald, der ændrer noget, svarer med 403 showcase_mode, og svarene indeholder ingen priser.
Ofte stillede spørgsmål
Hvad koster API'et?
Adgangen er gratis. I betaler for de ordrer, I udløser. Der er intet grundgebyr.
Findes der et softwarekit?
Ikke endnu. Dokumentationen har eksempler med curl, og OpenAPI-filen kan indlæses i de gængse værktøjer.
Hvordan får jeg højere grænser?
Skriv til os med jeres projekt og jeres mængde. Vi hæver for partnere, hvor vi ser behovet.
Hvad sker der, hvis min nøgle bliver stjålet?
Spær den på nøglesiden, og opret en ny. Indtil da begrænser dagsgrænsen og IP-listen skaden. Usædvanlige kald spærrer nøglen af sig selv.
Hvor melder jeg en fejl i API'et?
Via kontaktformularen med emnet API. Oplys kaldet og tidspunktet.
Klar til det første kald?
Læs udviklersiden igennem, og opret derefter en nøgle.
Send en forespørgsel