API
Katalógus, rendelések és kulcsok felületen keresztül
Hozza be katalógusunkat a rendszerébe, indítson rendeléseket, és vegye át a kulcsokat. Ez az oldal hat lépésben mutatja meg az utat. A limitek, a tesztkörnyezet és a korlátok a dokumentációban találhatók.
Ez akkor működik, amint megnyílik a bolt. Addig nyugodtan elolvashat mindent.
Fejlesztői oldal
OpenAPI
Minden hívás le van írva egy OpenAPI 3.1 fájlban. Az oldalakon szereplő minden szám az, amelyet a kód érvényesít.
- BearerAlkalmazásonként egy kulcs, csak hashként tárolva, lejárattal és cserével
- JSONPénz egész centben, dátumok ISO 8601 szerint, nevek snake_case formában
- 120 percenkéntolvasás egy új kulcsnál, 600, amint 7 napos
- AláírtWebhookok aláírással, kívánságra aláírt hívások is (RFC 9421)
Az API elkészült és tesztelt, a dokumentáció elérhető. A kulcsok létrehozhatók, amint megnyílik a bolt. Még nem létezik, és csak tervezett: egy kész szoftverkészlet, egy előre fizetett egyenleg.
Mire használhatja
Katalógus szinkronizálása
A teljes listát egyszer tölti be, utána csak azt, ami az utolsó szinkronizálás óta változott. Egy könnyű nézet csak a készletet mutatja.
Kész, az értékesítés indulásával nyílikRendelések indítása
Hívásonként egy rendelés, árplafonnal, az Ön saját számával és egy kulccsal a dupla vásárlások ellen.
Kész, az értékesítés indulásával nyílikKulcsok átvétele
Saját jogosultsággal, számolva és naplózva. Az első lekérés megszünteti az adott rendelés elállási jogát.
Kész, az értékesítés indulásával nyílikWebhookok fogadása
Aláírt hívások az Ön szerverére, ha egy rendelés vagy egy termék megváltozik. Legfeljebb 3 cím.
Kész, az értékesítés indulásával nyílikEladóként kínálni
Ajánlatok, árak és készlet kezelése a raktárrendszeréből. Ehhez az kell, hogy az értékesítés a(z) Capydra oldalon nyitva legyen.
Kész, az értékesítés indulásával nyílikHasználat MI-asszisztensekkel
Ugyanaz a fiók működik az MCP-szerverünkön keresztül. A szabályok és a limitek ugyanazok.
Kész, az értékesítés indulásával nyílik
Hat lépés az első hívásig
- 1
Fiók létrehozása
Bejelentkezik a boltba.
- 2
Kulcs létrehozása
Az „API-kulcsok” alatt: név, szerepkör (vevő vagy eladó) és a szükséges jogosultságok. Annyit adjon meg, amennyi feltétlenül kell.
- 3
Lemondó nyilatkozat megerősítése
Két mondat az elállásról, egyszer. A kulccsal indított minden rendelés erre hivatkozik.
- 4
Kulcs biztosítása
Csak egyszer jelenik meg. Őrizze úgy, mint egy jelszót, és vegye fel a szervereinek IP-címeit a listára.
- 5
Napi limit beállítása
Egy nap összes rendelésének összege korlátozott: új kulcsnál €250, €5,000 összegig állítható.
- 6
Az első hívás elküldése
A kulccsal az „Authorization” fejlécben. Az alábbi példa beolvassa az első termékeket.
Az első hívás
A kulcs omk_live_ előtaggal kezdődik. Minden hívásban Bearer értékként szerepel. A pénzösszegek egész centben vannak megadva, és tartalmazzák a szolgáltatási díjat.
curl "https://capydra.com/api/v1/catalog/products?page=1" \
-H "Authorization: Bearer omk_live_YOUR_KEY"
# csak az, ami az utolsó szinkronizálás óta változott
curl "https://capydra.com/api/v1/catalog/products?updatedSince=2026-11-17T00:00:00Z" \
-H "Authorization: Bearer omk_live_YOUR_KEY"Tovább a dokumentációban
A bolt még nem nyitott meg: a változtatást végző hívások 403 showcase_mode választ adnak, és a válaszok nem tartalmaznak árakat.
Gyakori kérdések
Mennyibe kerül az API?
A hozzáférés ingyenes. Az Ön által indított rendeléseket fizeti. Alapdíj nincs.
Van szoftverkészlet?
Még nincs. A dokumentációban curl-példák vannak, az OpenAPI-fájl pedig betölthető a gyakori eszközökbe.
Hogyan kaphatok magasabb limiteket?
Írja meg nekünk a tervét és a mennyiséget. Azoknál a partnereknél emelünk, ahol látjuk az igényt.
Mi történik, ha ellopják a kulcsomat?
Tiltsa le a kulcs oldalán, és hozzon létre újat. Addig a napi limit és az IP-lista korlátozza a kárt. A feltűnő hívások a kulcsot maguktól zárolják.
Hol jelenthetek hibát az API-ban?
A kapcsolatfelvételi űrlapon keresztül, API témával. Adja meg a hívást és az időpontot.
Készen áll az első hívásra?
Olvassa végig a fejlesztői oldalt, majd hozzon létre egy kulcsot.
Kérés küldése