Changelog

Publikace agentem přes API · říjen 2026

Bloger, jehož web obsluhuje vlastní systém (agent) napojený na API, může články dodané inzerentem vydávat sám a inzerent u jeho nabídky vidí okamžitou publikaci stejně jako u WordPress pluginu nebo webu ze šablony.

• PATCH /v1/blogs/{id}: agent_publish (true zapne, false vypne; nejde vedle pluginu nebo GitHubu, odpověď 409) a categories [{id, name, default?}], rubriky, ze kterých inzerent při objednávce vybírá (nejvýš 50, id si číslujete sami).
• GET /v1/blogs: nové pole publishing (mode manual | wordpress | github | agent, instant_publish, categories, deadline_minutes).
• Webhook deal.accepted: deal.published_by (agent | placla | bloger), deal.category_id (rubrika zvolená inzerentem) a deal.publish_deadline (do kdy má agent odevzdat URL, 60 minut).
• GET /v1/deals/{id}/text: published_by a category_id. Při agent vezměte text a fotky, článek vydejte a odevzdejte URL přes POST /v1/deals/{id}/article; bez odevzdání do lhůty dostane bloger výzvu k ručnímu vydání.
• MCP: nástroje text_obchodu (text, fotky, published_by, category_id) a nastav_publikaci_agentem (zapnout, rubriky); moje_blogy vrací publishing.

Podklady k publikaci a okamžitá publikace · září 2026

• POST /v1/offers/{id}/accept: u poptávky pouze publikace lze poslat photos ([{n, data}], n = 0 titulní fotografie, 1 až 5 fotky na místa značek [fotoN] v article_text, data = JPG v base64) a category_id (rubrika webu). Web s okamžitou publikací (WordPress plugin 0.3.2 a novější, nebo web ze šablony) článek vydá automaticky do několika sekund; odpověď nese instant_publish.
• GET /v1/demands/{id}/offers: u pouze publikace každá nabídka nese instant_publish a u něj categories k výběru rubriky.
• POST /v1/demands: podklady už u poptávky: shared_text + article_text (jeden článek pro všechny weby), title_photo (bloger | shared | each), photos. GET /v1/demands/{id} je vrací v materials; soubory na /v1/demands/{id}/photos/{n}.
• GET /v1/deals/{id}/text pro blogera: photos (titulní a fotky ke značkám, soubory na /v1/deals/{id}/photos/{n}) a instant_publish.
• MCP: akceptuj_nabidku má fotky a id_rubriky, zaloz_poptavku má text_clanku, spolecny_text, titulni_fotografie a fotky.
• Webhook deal.accepted: deal.instant_publish (článek vydá PlaCla sama, bloger nic nepublikuje).

Zadání článku všude, kde ho bloger potřebuje · září 2026

• Webhook demand.created a GET /v1/blogs/{id}/demands nově nesou description, tedy zadání článku. Dosud tam bylo jen expectation (cíl inzerenta, např. „Zlepšení ve vyhledávačích“), což si AI klienti pletli se zadáním.
• Webhook deal.accepted: deal.demand obsahuje kromě id a názvu i url, keywords, description, expectation, ns a publication.
• GET /v1/demands/{id} pro blogery: plné zadání aktivní poptávky (VIP jen s vazbou na váš blog) nebo poptávky, na kterou máte obchod, i před nabídkou.
• MCP: nový nástroj detail_poptavky; vhodne_poptavky u blogera vyžaduje id_blogu a vrací poptávky pro daný blog (dřív pro blogera skončil chybou). Popisy nástrojů a skill blogera vysvětlují rozdíl description × expectation.

Zastaralá návštěvnost webu · září 2026

• Seznam webů (GET /v1/blogs) vrací monthly_visitors_stale: true, když je návštěvnost starší než měsíc. Takový web se u poptávek nenabízí, dokud bloger návštěvnost neaktualizuje (PATCH /v1/blogs/{id} s monthly_visitors). Dřív se to dalo poznat jen z data monthly_visitors_updated nebo z chyby blog_neuplny při nabídce.
• MCP: nástroj aktualizuj_navstevnost (id blogu, návštěvnost) zapíše měsíční návštěvnost; totéž co PATCH /v1/blogs/{id} s monthly_visitors.

Hodnocení a klíčová slova obchodu podle nové struktury · září 2026

• Nové očekávání od článku: expectation u založení poptávky přijímá i kód 4 = „Dostat se do odpovědí AI (ChatGPT, Gemini, Perplexity)“. Stejná volba je ve formuláři na webu.
• Známka článku (POST /v1/deals/{id}/rating, volitelně i při payout) se ukládá do jednotné zpětné vazby; pole rating v detailu obchodu se z ní i čte. U payout přibylo rating (1–5); starší ratings se čtyřmi známkami se dál přijímá a uloží se jejich průměr.
• Odmítnutí nabídky: rating je kód důvodu (1 netematický web, 2 nekvalitní web, 3 jiný důvod, 4 drahá nabídka), reason volný text; obojí se ukládá do zpětné vazby a správce je vidí u webu.
• Detail obchodu: demand.keyword_urls vrací klíčová slova a odkazy upřesněné pro tento obchod, pokud je inzerent zadal; jinak zadání poptávky (jako web).

Výpisy přesně podle webu · srpen 2026

• Seznam obchodů bez filtru state vrací jen stavy, které role vidí na webu (nabídky, běžící, ke schválení, arbitráž, proplacené); odmítnuté, zrušené a archivované jen přes explicitní ?state=. Inzerentovi se proplacené ukazují 2 roky od proplacení; výpis k jedné poptávce (demand_id) limit nemá — jako web.
• Pokladní deník a historie účtu vrací posledních 100 záznamů (jako web), starší se nevydávají ani stránkováním.
• Seznam poptávek: neaktivní se ukazují jen s pohybem za posledních 60 dní (jako přehled na webu).
• Poptávky pro blog: během dovolené se nezobrazují (422 dovolena); pozastavený blog nevidí ani VIP poptávky.
• Proplacení GET /v1/payouts: nové pole arbitration — články v arbitráži zvlášť (web je má v samostatné sekci); pending nese jen články ke schválení. Hromadné proplacení all: true přeskočí obchody s reklamací (jako web) — proplatíte je jednotlivě přes ids nebo /deals/{id}/payout.
• Komunikace u otevřeného problému proplaceného obchodu je ke čtení (jako na webu u připomínky); psát se dál nedá — odpovědi patří do reklamace.
• Akceptace za nižší cenu jen u blogerů, kteří ji povolují — nabídky nesou příznak lower_price_allowed, jinak 422 nizsi_cena_nepovolena (web tlačítko ostatním vůbec neukazuje).
• Odmítnutou nabídku nelze odmítnout podruhé ani odložit (dřív šlo — přepsalo by hodnocení a zdvojilo záznam); starý zápis reklamace přes /claim nyní používá stejnou logiku jako /claims (správné události v historii).

Komunikace a reklamace jen aktuální · srpen 2026

• Komunikace uzavřeného obchodu (proplacený, zrušený, archivovaný) se přes API nevrací — GET /deals/{id}/messages vrátí 409 obchod_uzavren, stejně jako ji neukazuje web.
• Reklamace se oběma rolím zobrazuje jen aktuální — u odevzdaného článku, arbitráže nebo otevřeného problému; jinak 409 obchod_uzavren.
• Zápis do reklamace: inzerent jen u aktuálního obchodu — výjimkou je otevření „problému“ u článku proplaceného před méně než 2 lety (starší už reklamovat nelze, jako na webu). Bloger beze změny (ke_schvaleni/arbitráž/problém).

Drobné opravy a upřesnění · srpen 2026

• Akceptace za nižší cenu se počítá z nabídnuté ceny (dřív z ceny poptávky) — u vyšší nabídky teď minimum správně odpovídá 75 % nabídky.
• OAuth tokeny mají klouzavou platnost (aktivní připojení nevyprší, opuštěné po 90 dnech); odpověď tokenu nese expires_in. Re-autorizace téhož klienta nahradí jeho starý klíč, aktivní připojení z jiného zařízení neruší.
• OAuth rozsah (scope): konektor může požádat jen o read (pak nic nemění ani neutrácí); souhlasná stránka podle toho ukáže, co povoluje. Bez uvedení scope zůstává read write jako dosud.
• Idempotency-Key je vázán na konkrétní požadavek (stejný klíč pro jiný požadavek vrátí 422); odmítnuté (4xx) operace se neuchovávají, takže po nápravě vstupu jde volání zopakovat se stejným klíčem. Souběžné opakování zápisu neprovede akci dvakrát.
• Výpis zpráv a reklamací vrací nejnovějších 500 (dřív omylem nejstarších) s příznakem orezano.
• Meze vstupů: horní strop dobití kreditu, maximum velikosti dávky u hromadného proplacení, hodnocení všude 1–5; založení poptávky vyžaduje dostatečný kredit (stejně jako aktivace).
• Webhooky míří jen na veřejné https adresy bez přesměrování (platí i pro IPv6); openapi.yaml opraven (GET i POST u /blogs a /demands).

Reklamace přes API a ochrana komunikace · srpen 2026

• Zápis do reklamací POST /v1/deals/{id}/claims — obě role; příspěvek se propíše do vlákna reklamace (dosud šel jediný zápis do komunikace). Volitelné "arbitration": true (jen ke_schvaleni, min. 50 znaků) předá spor arbitrovi. Dosavadní POST /deals/{id}/claim zůstává jako alias.
• Serverová ochrana obsahu — zprávy i reklamace se kontrolují na prvky, které do komunikace přes PlaClu nepatří (cizí e-maily, podpisy, vyjednávání o ceně, u blogera odkazy na vlastní blog). Nález vrátí 422 podezrely_obsah s radami; vědomé odeslání beze změny je možné zopakováním volání s "presto_odeslat": true.
• MCP: nový nástroj odpovez_na_reklamaci, rozšířené popisy napis_zpravu a reklamuj_clanek.

MCP server pro AI asistenty · srpen 2026

• Povolení jedním kliknutím (OAuth) — PlaClu lze do claude.ai a dalších asistentů přidat vložením adresy https://api.placla.cz/mcp a kliknutím na Povolit; vzniklý přístup je běžný API klíč, který lze kdykoli zrušit v nastavení účtu.
• MCP server na https://api.placla.cz/mcp — PlaClu lze připojit do Claude, ChatGPT a dalších AI asistentů; přihlášení stávajícím API klíčem, nástroje podle role (bloger / inzerent), zápisy idempotentní. Viz MCP pro AI asistenty.
• Skilly pro asistenty — skill-bloger.md a skill-inzerent.md s pravidly a pracovními postupy PlaCly.

Zápisy pro inzerenty · srpen 2026

• Akceptace nabídky POST /v1/offers/{id}/accept — včetně nižší ceny (min. 75 %), extra služeb, klíčových slov, poznámky a dodání hotového textu.
• Proplacení POST /v1/deals/{id}/payout (+ hromadné POST /v1/deals/payout) — v transakci, idempotentní (opakování = 409 jiz_proplaceno).
• Storno akceptace /cancel, odmítnutí /decline, odložení /defer+/restore, blokace blogu /block, reklamace /claim, hodnocení /rating, aktivace poptávky /activate+/deactivate.
• Idempotency-Key — hlavička pro bezpečné opakování všech zápisů; odpovědi se uchovávají 7 dní.
• Založení poptávky POST /v1/demands — čtyři druhy (standard, vip, publication, writing) se stejnými pravidly a minimy cen jako formulář na webu; vzniká rovnou aktivní.
• Založení blogu POST /v1/blogs — jako formulář webu včetně načtení Moz metrik; čeká na schválení redakcí. Sociální profily (FB/Twitter) API záměrně nepodporuje.
• Zápis zpráv POST /v1/deals/{id}/messages — obě role; protistrana dostane mail i webhook.
• Kredit a účetnictví: GET /v1/credit/transactions (pokladní deník), GET /v1/logs (historie účtu), GET /v1/spend (útrata inzerenta po měsících), GET /v1/invoices (faktury a proformy s odkazy), POST /v1/credit/top-up (dobití převodem — proforma + platební údaje).
• Webhooky pro inzerenta — registrace webhooku už není jen blogerská; inzerentovi chodí offer.created (nová nabídka k poptávce) a claim.created / message.created od protistrany.

Spuštění API v1 a první rozšíření · srpen 2026

• Webhook události životního cyklu: kromě demand.created nově chodí deal.accepted (inzerent objednal), deal.paid (článek proplacen), claim.created (nová připomínka/reklamace) a message.created (nová zpráva k obchodu). Bez registrace nové verze — chodí automaticky všem registrovaným webhookům; neznámé události ignorujte.
• Volitelná expirace klíčů a evidence poslední IP u klíče.
• GET /v1/deals/{id} — detail obchodu s plným zadáním poptávky i po akceptaci.
• GET /v1/deals?zmeneno_od= a pole changed_at — přírůstková synchronizace.
• GET /v1/deals/{id}/messages a GET /v1/deals/{id}/claims — obsah komunikace a reklamací.
• Pole web_url u obchodů — hotový odkaz na detail na webu.
• POST /v1/webhook/test, GET /v1/webhook/deliveries, POST /v1/webhook/rotate-secret — ladění a správa webhooku.
• Hlavičky X-RateLimit-Limit / -Remaining / -Reset na každé odpovědi.
• Spuštění API v1: čtení pro blogery i inzerenty, zápisy blogera (nabídky, odevzdání článku, správa blogu a služeb), webhook demand.created, API klíče v nastavení účtu, dokumentace a návody.

PlaCla API v1 · dokumentace · [email protected]