Changelog

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]