Náhled: Capydra brzy otevírá. Objednávat zatím nelze.

Capydra
Plus Nápověda Košík
Nabídka týdne

API

Katalog, objednávky a klíče přes rozhraní

Přeneste náš katalog do svého systému, spouštějte objednávky a vyzvedávejte klíče. Tato stránka ukazuje cestu v šesti krocích. Limity, testovací prostředí a omezení jsou v dokumentaci.

Brzy otevřenoK dokumentaci

To bude fungovat, jakmile se obchod otevře. Do té doby si vše můžete v klidu přečíst.

Stránka pro vývojáře

OpenAPI

Každé volání je popsáno v souboru OpenAPI 3.1. Každé číslo na stránkách je číslo, které kód vynucuje.

Připraveno, otevře se se zahájením prodeje

API je postaveno a otestováno, dokumentace je online. Klíče lze vytvářet, jakmile se obchod otevře. Zatím neexistuje a je jen plánováno: hotový softwarový kit, předplacený zůstatek.

Co s tím můžete dělat

  • Synchronizovat katalog

    Celý seznam načtete jednou, poté jen to, co se změnilo od vaší poslední synchronizace. Lehký pohled ukazuje jen stav zásob.

    Připraveno, otevře se se zahájením prodeje
  • Spouštět objednávky

    Jedna objednávka na volání, s cenovým stropem, vaším vlastním číslem a klíčem proti dvojímu nákupu.

    Připraveno, otevře se se zahájením prodeje
  • Vyzvedávat klíče

    S vlastním právem, počítané a zaznamenávané. První vyzvednutí ukončí právo na odstoupení u této objednávky.

    Připraveno, otevře se se zahájením prodeje
  • Přijímat webhooky

    Podepsaná volání na váš server, když se změní objednávka nebo produkt. Až 3 adres.

    Připraveno, otevře se se zahájením prodeje
  • Nabízet jako prodejce

    Spravujte nabídky, ceny a zásoby ze svého skladového systému. Předpokladem je, že prodej na Capydra je otevřen.

    Připraveno, otevře se se zahájením prodeje
  • Používat s AI asistenty

    Stejný účet funguje přes náš server MCP. Pravidla a limity jsou stejné.

    Připraveno, otevře se se zahájením prodeje

V šesti krocích k prvnímu volání

  1. 1

    Založte účet

    Přihlásíte se v obchodě.

  2. 2

    Vytvořte klíč

    V části „Klíče API“: název, role (kupující nebo prodejce) a práva, která potřebujete. Dejte co nejméně.

  3. 3

    Potvrďte prohlášení o vzdání se práva

    Dvě věty o odstoupení od smlouvy, jednou. Každá objednávka s klíčem na ně odkazuje.

  4. 4

    Zabezpečte klíč

    Zobrazí se jen jednou. Uložte ho jako heslo a zapište IP adresy svých serverů do seznamu.

  5. 5

    Nastavte denní limit

    Součet všech objednávek za den je omezen: €250 u nového klíče, nastavitelný až do €5,000.

  6. 6

    Odešlete první volání

    S klíčem v hlavičce „Authorization“. Příklad níže načte první produkty.

První volání

Klíč začíná omk_live_. Vkládá se do každého volání jako hodnota bearer. Peníze jsou uvedeny v celých centech a zahrnují poplatek za služby.

curl "https://capydra.com/api/v1/catalog/products?page=1" \
  -H "Authorization: Bearer omk_live_YOUR_KEY"

# jen to, co se změnilo od vaší poslední synchronizace
curl "https://capydra.com/api/v1/catalog/products?updatedSince=2026-11-17T00:00:00Z" \
  -H "Authorization: Bearer omk_live_YOUR_KEY"

Pokračujte v dokumentaci

403

Obchod ještě není otevřen: volání, která něco mění, odpovídají 403 showcase_mode a odpovědi neobsahují ceny.

Časté dotazy

Kolik API stojí?

Přístup je zdarma. Platíte objednávky, které spustíte. Základní poplatek neexistuje.

Existuje softwarový kit?

Zatím ne. Dokumentace má příklady s curl a soubor OpenAPI lze načíst do běžných nástrojů.

Jak získám vyšší limity?

Napište nám svůj záměr a objem. Limity zvyšujeme partnerům, u nichž vidíme potřebu.

Co když mi klíč někdo ukradne?

Zablokujte ho na stránce klíčů a vytvořte nový. Do té doby škodu omezují denní limit a seznam IP. Nápadná volání klíč sama zablokují.

Kde nahlásím chybu v API?

Přes kontaktní formulář s tématem API. Uveďte volání a čas.

Připraveni na první volání?

Přečtěte si stránku pro vývojáře a poté vytvořte klíč.

Odeslat dotaz