Podgląd: Capydra wkrótce rusza. Składanie zamówień nie jest jeszcze możliwe.

Capydra
Plus Pomoc Koszyk
Okazja tygodnia

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.

Wkrótce dostępneDo 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.

Gotowe, otwiera się wraz ze startem sprzedaży

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ży
  • Uruchamianie 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ży
  • Odbieranie 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ży
  • Odbieranie 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ży
  • Oferowanie 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ży
  • Uż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. 1

    Założenie konta

    Logują się Państwo w sklepie.

  2. 2

    Utworzenie klucza

    W sekcji "Klucze API": nazwa, rola (kupujący lub sprzedawca) i potrzebne uprawnienia. Proszę nadać ich jak najmniej.

  3. 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. 4

    Zabezpieczenie klucza

    Jest pokazywany tylko raz. Proszę przechowywać go jak hasło i wpisać do listy adresy IP swoich serwerów.

  5. 5

    Ustawienie limitu dziennego

    Suma wszystkich zamówień z jednego dnia jest ograniczona: €250 dla nowego klucza, do €5,000 do ustawienia.

  6. 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

403

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