Co s API zvládnete
API zrcadlí web: co vidíte a smíte na webu, vidíte a smíte i přes API, se stejnými pravidly, ochranami a limity. Nic navíc, nic tajného.
- Jako inzerent: zakládat poptávky, porovnávat a přijímat nabídky, kontrolovat a proplácet odevzdané články i hromadně, řešit připomínky, stahovat faktury a přehledy útraty.
- Jako bloger: hlídat nové poptávky a hned na ně nabízet své weby, odevzdávat hotové články, stahovat texty napsané redakcí rovnou do redakčního systému, sledovat odměny a jejich proplácení.
- Obě role: komunikovat s protistranou, dostávat okamžitá upozornění webhookem a synchronizovat si data do vlastních systémů.
Kde co najdete
Všechno technické žije na jednom místě: api.placla.cz.
- Dokumentace Referenční příručka: přihlášení, endpointy, stavy obchodů, chybové kódy, limity. Začněte tady.
- Návody krok za krokem Hotové skripty ke zkopírování: hlídač poptávek, příjem webhooků, stažení textu.
- Konektor MCP pro AI asistenty Připojení PlaCly ke Claude, ChatGPT a dalším asistentům. Netechnický přehled je na naší stránce o AI asistentech.
- Changelog Co je v API nového, nejnovější nahoře.
- OpenAPI popis Strojově čitelný popis pro generátory klientů a vývojářské nástroje.
Jak začít
Klíč můžete kdykoli zneplatnit tam, kde jste ho vytvořili. Klíčů můžete mít víc, pro každý nástroj vlastní, ať víte, který přístup je který.
- Přihlaste se na PlaCle a v nastavení účtu si v sekci API klíče vytvořte klíč. Zobrazí se jen jednou, uložte si ho a zacházejte s ním jako s heslem.
- Otevřete dokumentaci nebo návody a vyzkoušejte první volání.
- Chcete místo kódu AI asistenta? Pokračujte návodem ke konektoru MCP, klíč za vás vyřídí přihlašovací dialog.
Na co se můžete spolehnout
- Stabilita. Co jednou ve verzi v1 funguje, funguje dál. Nová pole a možnosti přibývají, existující se nemění.
- Bezpečnost. Přístup je vázaný na váš účet a jeho roli, klíč jde kdykoli zrušit a citlivé operace mají stejné pojistky jako web.
- Stejná pravidla jako na webu. API neotvírá zadní vrátka. Pravidla tržiště, ochranu komunikace i limity vynucuje pro všechny klienty stejně.
Potřebujete poradit?
Napište na [email protected]. U technických dotazů přiložte support_code z chybové odpovědi, najdeme váš požadavek v logu na první dobrou.
Časté otázky
Potřebuji API, když si vystačím s webem?
Nepotřebujete. API dává smysl, až když se něco opakuje: desítky obchodů měsíčně, hlídání nových poptávek, stahování textů do redakčního systému nebo faktur do účetnictví. Do té doby je web rychlejší.
Jak se přihlašuje?
API klíčem, který si vytvoříte v nastavení účtu na PlaCle a pošlete v hlavičce požadavku. Klíčů můžete mít víc a kterýkoli z nich kdykoli zneplatnit. U konektoru MCP se místo klíče dá použít přihlašovací dialog.
Umí API upozornit na novou poptávku?
Ano, webhookem. Zaregistrujete adresu a PlaCla na ni pošle upozornění, jakmile přijde nová poptávka, nabídka, odevzdaný článek nebo zpráva. Hotový příjem webhooků ke zkopírování je v návodech.
Nedá se přes API obejít pravidla tržiště?
Ne. API běží nad stejnou logikou jako web, takže limity, ochrana komunikace i pravidla pro obchody platí pro všechny klienty shodně. Některé citlivé operace mají přes API dokonce přísnější pojistky.