API
Catalogus, bestellingen en keys via een koppeling
Haal onze catalogus in uw systeem, plaats bestellingen en haal de keys op. Deze pagina toont de weg in zes stappen. Limieten, testomgeving en grenzen staan in de documentatie.
Dit kan zodra de winkel opent. Tot die tijd kunt u alles rustig doorlezen.
Ontwikkelaarspagina
OpenAPI
Elke aanroep is beschreven in een OpenAPI 3.1-bestand. Elk getal op de pagina's is het getal dat de code afdwingt.
- BearerEén sleutel per toepassing, alleen als hash opgeslagen, met vervaldatum en rotatie
- JSONGeld in hele centen, data volgens ISO 8601, namen in snake_case
- 120 per minuutleesaanroepen voor een nieuwe sleutel, 600 zodra hij 7 dagen oud is
- OndertekendWebhooks met handtekening, op verzoek ook ondertekende aanroepen (RFC 9421)
De API is gebouwd en getest, de documentatie staat online. Sleutels kunt u aanmaken zodra de winkel opent. Nog niet beschikbaar en alleen gepland: een kant-en-klare softwarekit, een vooruitbetaald tegoed.
Wat u ermee kunt doen
Catalogus synchroniseren
Laad de hele lijst één keer, daarna alleen wat is veranderd sinds uw laatste synchronisatie. Een lichte weergave toont alleen de voorraad.
Klaar, opent met de start van de verkoopBestellingen plaatsen
Eén bestelling per aanroep, met een prijsgrens, uw eigen nummer en een sleutel tegen dubbele aankopen.
Klaar, opent met de start van de verkoopKeys ophalen
Met een eigen recht, geteld en vastgelegd. De eerste aanroep beëindigt het herroepingsrecht van die bestelling.
Klaar, opent met de start van de verkoopWebhooks ontvangen
Ondertekende aanroepen naar uw server wanneer een bestelling of een product verandert. Tot 3 adressen.
Klaar, opent met de start van de verkoopAls verkoper aanbieden
Aanbod, prijzen en voorraad vanuit uw voorraadsysteem bijhouden. Dat vereist dat verkopen op Capydra is geopend.
Klaar, opent met de start van de verkoopGebruiken met AI-assistenten
Hetzelfde account werkt via onze MCP-server. De regels en limieten zijn dezelfde.
Klaar, opent met de start van de verkoop
In zes stappen naar de eerste aanroep
- 1
Account aanmaken
U meldt zich aan in de winkel.
- 2
Sleutel aanmaken
Onder "API-sleutels": een naam, de rol (koper of verkoper) en de rechten die u nodig heeft. Geef er zo min mogelijk.
- 3
Afstandsverklaring bevestigen
Twee zinnen over herroeping, eenmalig. Elke bestelling met de sleutel verwijst ernaar.
- 4
Sleutel veiligstellen
Hij wordt maar één keer getoond. Bewaar hem als een wachtwoord en zet de IP-adressen van uw servers in de lijst.
- 5
Daglimiet instellen
De som van alle bestellingen van een dag is begrensd: €250 bij een nieuwe sleutel, instelbaar tot €5,000.
- 6
Eerste aanroep versturen
Met de sleutel in de header "Authorization". Het voorbeeld hieronder leest de eerste producten.
De eerste aanroep
Een sleutel begint met omk_live_. Hij gaat in elke aanroep mee als bearer-waarde. Geld is opgegeven in hele centen en bevat de servicekosten.
curl "https://capydra.com/api/v1/catalog/products?page=1" \
-H "Authorization: Bearer omk_live_YOUR_KEY"
# alleen wat is veranderd sinds uw laatste synchronisatie
curl "https://capydra.com/api/v1/catalog/products?updatedSince=2026-11-17T00:00:00Z" \
-H "Authorization: Bearer omk_live_YOUR_KEY"Verder in de documentatie
De winkel is nog niet open: aanroepen die iets wijzigen antwoorden met 403 showcase_mode, en de antwoorden bevatten geen prijzen.
Veelgestelde vragen
Wat kost de API?
De toegang kost niets. U betaalt de bestellingen die u plaatst. Vaste kosten zijn er niet.
Is er een softwarekit?
Nog niet. De documentatie heeft voorbeelden met curl, en het OpenAPI-bestand is in de gangbare tools te laden.
Hoe krijg ik hogere limieten?
Schrijf ons uw plan en uw hoeveelheid. Wij verhogen de limieten voor partners bij wie wij de behoefte zien.
Wat gebeurt er als mijn sleutel wordt gestolen?
Blokkeer hem op de sleutelpagina en maak een nieuwe aan. Tot dan beperken de daglimiet en de IP-lijst de schade. Opvallende aanroepen bevriezen de sleutel vanzelf.
Waar meld ik een fout in de API?
Via het contactformulier met het onderwerp API. Noem de aanroep en het tijdstip.
Klaar voor de eerste aanroep?
Lees de ontwikkelaarspagina door en maak dan een sleutel aan.
Verzoek versturen