API
Katalog, zamówienia i klucze przez interfejs
Proszę pobrać nasz katalog do swojego systemu, uruchamiać zamówienia i odbierać klucze. Ta strona pokazuje drogę w sześciu krokach. Limity, środowisko testowe i ograniczenia znajdują się w dokumentacji.
Zadziała to, gdy tylko sklep zostanie otwarty. Do tego czasu mogą Państwo spokojnie wszystko przeczytać.
Strona dla programistów
OpenAPI
Każde wywołanie jest opisane w pliku OpenAPI 3.1. Każda liczba na stronach jest liczbą, którą wymusza kod.
- BearerJeden klucz na aplikację, przechowywany tylko jako hash, z terminem ważności i rotacją
- JSONPieniądze w pełnych centach, daty w ISO 8601, nazwy w snake_case
- 120 na minutęodczytów dla nowego klucza, 600 gdy ma on 7 dni
- Z podpisemWebhooki z podpisem, na życzenie także podpisane wywołania (RFC 9421)
API jest zbudowane i przetestowane, dokumentacja jest online. Klucze można tworzyć, gdy tylko sklep zostanie otwarty. Jeszcze niedostępne i tylko planowane: gotowy zestaw programistyczny, przedpłacone saldo.
Co można z nim zrobić
Synchronizacja katalogu
Całą listę wczytują Państwo raz, potem tylko to, co zmieniło się od ostatniej synchronizacji. Lekki widok pokazuje tylko stan magazynowy.
Gotowe, otwiera się wraz ze startem sprzedażyUruchamianie zamówień
Jedno zamówienie na wywołanie, z limitem ceny, Państwa własnym numerem i kluczem chroniącym przed podwójnym zakupem.
Gotowe, otwiera się wraz ze startem sprzedażyOdbieranie kluczy
Z osobnym uprawnieniem, liczone i zapisywane. Pierwsze pobranie kończy prawo odstąpienia od umowy dla tego zamówienia.
Gotowe, otwiera się wraz ze startem sprzedażyOdbieranie webhooków
Podpisane wywołania do Państwa serwera, gdy zmieni się zamówienie lub produkt. Do 3 adresów.
Gotowe, otwiera się wraz ze startem sprzedażyOferowanie jako sprzedawca
Oferty, ceny i stany magazynowe prowadzą Państwo z własnego systemu magazynowego. Wymaga to, aby sprzedaż w Capydra była otwarta.
Gotowe, otwiera się wraz ze startem sprzedażyUżycie z asystentami AI
To samo konto działa przez nasz serwer MCP. Zasady i limity są takie same.
Gotowe, otwiera się wraz ze startem sprzedaży
Sześć kroków do pierwszego wywołania
- 1
Założenie konta
Logują się Państwo w sklepie.
- 2
Utworzenie klucza
W sekcji "Klucze API": nazwa, rola (kupujący lub sprzedawca) i potrzebne uprawnienia. Proszę nadać ich jak najmniej.
- 3
Potwierdzenie oświadczenia o zrzeczeniu się
Dwa zdania o odstąpieniu od umowy, jednorazowo. Odwołuje się do nich każde zamówienie złożone tym kluczem.
- 4
Zabezpieczenie klucza
Jest pokazywany tylko raz. Proszę przechowywać go jak hasło i wpisać do listy adresy IP swoich serwerów.
- 5
Ustawienie limitu dziennego
Suma wszystkich zamówień z jednego dnia jest ograniczona: €250 dla nowego klucza, do €5,000 do ustawienia.
- 6
Wysłanie pierwszego wywołania
Z kluczem w nagłówku "Authorization". Poniższy przykład odczytuje pierwsze produkty.
Pierwsze wywołanie
Klucz zaczyna się od omk_live_. Trafia do każdego wywołania jako wartość bearer. Kwoty podawane są w pełnych centach i zawierają opłatę serwisową.
curl "https://capydra.com/api/v1/catalog/products?page=1" \
-H "Authorization: Bearer omk_live_YOUR_KEY"
# tylko to, co zmieniło się od Państwa ostatniej synchronizacji
curl "https://capydra.com/api/v1/catalog/products?updatedSince=2026-11-17T00:00:00Z" \
-H "Authorization: Bearer omk_live_YOUR_KEY"Dalej w dokumentacji
Sklep nie jest jeszcze otwarty: wywołania, które coś zmieniają, odpowiadają 403 showcase_mode, a odpowiedzi nie zawierają cen.
Często zadawane pytania
Ile kosztuje API?
Dostęp jest bezpłatny. Płacą Państwo za zamówienia, które uruchamiają. Nie ma opłaty podstawowej.
Czy jest zestaw programistyczny?
Jeszcze nie. Dokumentacja zawiera przykłady z curl, a plik OpenAPI można wczytać do popularnych narzędzi.
Jak uzyskać wyższe limity?
Proszę napisać nam o swoim zamiarze i ilości. Podnosimy limity partnerom, u których widzimy potrzebę.
Co się stanie, gdy mój klucz zostanie skradziony?
Proszę go zablokować na stronie kluczy i utworzyć nowy. Do tego czasu limit dzienny i lista IP ograniczają szkody. Nietypowe wywołania same zamrażają klucz.
Gdzie zgłosić błąd w API?
Przez formularz kontaktowy z tematem API. Proszę podać wywołanie i godzinę.
Gotowi na pierwsze wywołanie?
Proszę przeczytać stronę dla programistów do końca, a potem utworzyć klucz.
Wyślij zapytanie