API
Catalog, comenzi și chei prin interfață
Aduceți catalogul nostru în sistemul dumneavoastră, declanșați comenzi și preluați cheile. Această pagină arată calea în șase pași. Limitele, mediul de test și restricțiile se află în documentație.
Acest lucru funcționează de îndată ce se deschide magazinul. Până atunci puteți citi totul în liniște.
Pagina pentru dezvoltatori
OpenAPI
Fiecare apel este descris într-un fișier OpenAPI 3.1. Fiecare cifră de pe pagini este cifra pe care o impune codul.
- BearerO cheie pe aplicație, stocată doar ca hash, cu expirare și rotație
- JSONBani în cenți întregi, date conform ISO 8601, nume în snake_case
- 120 pe minutcitiri pentru o cheie nouă, 600 după ce are 7 zile
- SemnatWebhook-uri cu semnătură, la cerere și apeluri semnate (RFC 9421)
API-ul este construit și testat, documentația este online. Cheile pot fi create de îndată ce se deschide magazinul. Încă nu există și sunt doar planificate: un kit software gata făcut, un sold plătit în avans.
Ce puteți face cu el
Sincronizați catalogul
Încărcați o dată lista completă, apoi doar ce s-a schimbat de la ultima dumneavoastră sincronizare. O vedere ușoară arată doar stocul.
Gata, se deschide odată cu startul vânzărilorDeclanșați comenzi
O comandă pe apel, cu plafon de preț, numărul dumneavoastră propriu și o cheie împotriva dublei cumpărări.
Gata, se deschide odată cu startul vânzărilorPreluați chei
Cu un drept propriu, numărat și înregistrat. Prima preluare încheie dreptul de retragere pentru acea comandă.
Gata, se deschide odată cu startul vânzărilorPrimiți webhook-uri
Apeluri semnate către serverul dumneavoastră când se schimbă o comandă sau un produs. Până la 3 adrese.
Gata, se deschide odată cu startul vânzărilorOferiți ca vânzător
Gestionați oferte, prețuri și stoc din sistemul dumneavoastră de stocuri. Aceasta presupune ca vânzarea pe Capydra să fie deschisă.
Gata, se deschide odată cu startul vânzărilorFolosiți cu asistenți AI
Același cont funcționează prin serverul nostru MCP. Regulile și limitele sunt aceleași.
Gata, se deschide odată cu startul vânzărilor
În șase pași până la primul apel
- 1
Creați un cont
Vă autentificați în magazin.
- 2
Creați o cheie
La „Chei API”: un nume, rolul (cumpărător sau vânzător) și drepturile de care aveți nevoie. Dați cât mai puține.
- 3
Confirmați declarația de renunțare
Două propoziții despre retragere, o singură dată. Fiecare comandă făcută cu cheia face trimitere la ele.
- 4
Securizați cheia
Este afișată o singură dată. Păstrați-o ca pe o parolă și adăugați în listă adresele IP ale serverelor dumneavoastră.
- 5
Stabiliți o limită zilnică
Suma tuturor comenzilor dintr-o zi este plafonată: €250 pentru o cheie nouă, reglabilă până la €5,000.
- 6
Trimiteți primul apel
Cu cheia în antetul „Authorization”. Exemplul de mai jos citește primele produse.
Primul apel
O cheie începe cu omk_live_. Merge în fiecare apel ca valoare bearer. Banii sunt indicați în cenți întregi și includ taxa de serviciu.
curl "https://capydra.com/api/v1/catalog/products?page=1" \
-H "Authorization: Bearer omk_live_YOUR_KEY"
# doar ce s-a schimbat de la ultima dumneavoastră sincronizare
curl "https://capydra.com/api/v1/catalog/products?updatedSince=2026-11-17T00:00:00Z" \
-H "Authorization: Bearer omk_live_YOUR_KEY"Continuați în documentație
Magazinul nu este încă deschis: apelurile care schimbă ceva răspund cu 403 showcase_mode, iar răspunsurile nu conțin prețuri.
Întrebări frecvente
Cât costă API-ul?
Accesul nu costă nimic. Plătiți comenzile pe care le declanșați. Nu există taxă de bază.
Există un kit software?
Încă nu. Documentația are exemple cu curl, iar fișierul OpenAPI poate fi încărcat în instrumentele uzuale.
Cum obțin limite mai mari?
Scrieți-ne planul și volumul dumneavoastră. Mărim limitele pentru partenerii la care vedem nevoia.
Ce se întâmplă dacă îmi este furată cheia?
Blocați-o pe pagina cheilor și creați una nouă. Până atunci, limita zilnică și lista de IP-uri plafonează paguba. Apelurile suspecte blochează cheia automat.
Unde raportez o eroare în API?
Prin formularul de contact, cu subiectul API. Indicați apelul și ora.
Gata pentru primul apel?
Citiți pagina pentru dezvoltatori, apoi creați o cheie.
Trimiteți o solicitare