poai_ Server-zu-Server API klíč
- Oprávnění účtu, který jej vytvořil (admin: celý účet)
- Neposkytovat v prohlížeči kód
- Není potřeba Origin-hlavička
- Pro MCP uzamčeno
- Lze omezit na IP adresy
Ověřování a klíče
Bearer token. Každý koncový bod.
Každý produktový koncový bod PaperOffice-API očekává hlavičku Authorization: Bearer. Žádný OAuth flow, žádná obnova.
Dva typy tokenů, jasná práva, zdokumentované limity rychlosti.
Jedna hlavička Žádný OAuth flow Lze kdykoli odvolat
- Vlastní infrastruktura v EU Vaše data zůstávají v Evropě.
- ISO/IEC 27001 certifikováno Bezpečnost certifikována.
- Více než 24 let zkušeností Osvědčené. Stabilní. Budoucnost zajištěno.
curl -X POST "https://api.paperoffice.ai/latest/job/add/workflow" \ -H "Authorization: Bearer po_ut_YOUR_API_KEY" \ -F "file_1=@invoice.pdf" \ -F "idp_collection=invoice" \ -F "model=basic-pro-max"import requestsresponse = requests.post( "https://api.paperoffice.ai/latest/job/add/workflow", headers={"Authorization": "Bearer po_ut_YOUR_API_KEY"}, files={"file_1": open("invoice.pdf", "rb")}, data={"idp_collection": "invoice", "model": "basic-pro-max"},)print(response.json())const form = new FormData();form.append("file_1", new Blob([await readFile("invoice.pdf")]), "invoice.pdf");form.append("idp_collection", "invoice");form.append("model", "basic-pro-max");const response = await fetch("https://api.paperoffice.ai/latest/job/add/workflow", { method: "POST", headers: { Authorization: "Bearer po_ut_YOUR_API_KEY" }, body: form,});console.log(await response.json());První volání
Nastavit hlavičku, vybrat pipeline, odeslat
Cesta za /latest/job/add/ je název operace: obvykle ve formátu handler___command (například paperoffice_aiocr___generate), a pro strukturované IDP je určena pipeline workflow.
- Jedna hlavička
Authorization: Bearer po_ut_… — produktový endpoint nepotřebuje nic více. poai_ a po_ut_ neposílají Origin hlavičku.
- Pipeline v cestě
handler___command se třemi podtržítky; workflow je výjimka s vlastním slugem. Tečková notace odpoví API s HTTP 400 JOB_CONFIG_INVALID.
- Výsledek nebo job_id
client_wait je ve výchozím nastavení true: API udržuje připojení a vrací výsledek inline. Pokud časové okno nestačí, vrátí se HTTP 202 s job_id a poll_url pro GET /latest/job/get/{job_id}.
Pro idp_collection=invoice se doporučuje model basic-pro-max. Ve skutečnosti použitý model je vrácen v odpovědním poli "model" a může se lišit od požadovaného.
Typy tokenů
Dva typy tokenů, jasně oddělené
Oba patří na server. Vytvářejí se, rotují a ruší v aplikaci pod Účet → API.
po_ut_ Uživatelsky specifický User Token
- Přispívá k právům svého uživatele
- Nedodávat do prohlížečového kódu
- Žádný hlavičkový údaj Origin není vyžadován
- Povoleno pro MCP
Volání přímo z prohlížeče neprocházejí těmito dvěma tokeny, ale pomocí Publishable Key po_pk_ — vázané na původ, s omezením rozpočtu a počtu požadavků. Zobrazit Publishable Keys
Oprávnění
Co smí User Token
User Token má přesně ta práva svého uživatele v těchto oblastech. Jednotlivé oblasti nelze při vytváření přidělit; k omezení slouží skupinový token (po_gt_) s právy uživatelské skupiny.
- Dokumenty
documentsNahrát, stáhnout, zpracování
- Workspaces
workspacesSpravovat složky a strukturu
- AI úlohy
ai_jobsOCR, IDP, extrakce
- Fakturace
billingČíst využití a zůstatek účtu
- Uživatelé
usersSpráva členů týmu
- Webhooky
webhooksPřijímání událostí
- Znalostní báze
knowledge_baseDatabáze znalostí a FAQ
- Agenti
agentsKonfigurace IDP agentů
- Pracovní postupy
workflowsVytváření automatizací
- Soulad s předpisy
complianceAudit, GDPR, archivace
Omezení rychlosti
Co počítá API
Zpoplatňuje se za každý token; bez Beareru podle IP adresy. Následující hodnoty jsou zdokumentované minimální hodnoty platné v každém tarifu.
- 5
- Požadavky za sekundu
- 30
- Požadavky za minutu
- 100
- Požadavky za hodinu
- 500
- Požadavky za den
- Zbývající hodnoty jsou v hlavičce odpovědi
Hlavičky RateLimit-* a X-RateLimit-* každé odpovědi udávají, kolik je v aktuálním okně ještě k dispozici.
- Překročení: HTTP 429
API odpoví s RATE_LIMIT_EXCEEDED. Opakujte požadavek po uplynutí času z hlavičky Retry-After.
- Vyšší tarify zvyšují hodnoty
Placené tarify jsou nad těmito minimálními hodnotami. Který tarif má jaký rozsah, je uvedeno na cenové stránce.
Bezpečnost
Co chrání klíč
Šest mechanismů, které fungují v provozu — každý s ověřitelným stavovým kódem nebo místem v aplikaci.
- Rotace a zrušení
Klíče se vytvářejí, zobrazují, rotují a ruší v aplikaci pod Účet → API. Zrušený token odpoví s HTTP 401 TOKEN_NOT_FOUND.
- Platnost a expirace
Vypršené tokeny odpovídají kódem HTTP 401 BEARERTOKEN_EXPIRED, chybné kódem HTTP 401 INVALID_TOKEN. Publishable Keys platí 180 dní od vytvoření.
- Limity na token
V tarifu Free platí rate-limity na token. V placených tarifech se počítá podle účtu; dokud jsou k dispozici Credits, v těchto tarifech neplatí žádná omezení rychlosti.
- Vazba původu v prohlížeči
Publishable Keys vyžadují při každém požadavku Origin z Allowlist; jinak API odpoví 403 ORIGIN_HEADER_REQUIRED nebo DOMAIN_NOT_ALLOWED.
- Sledování využití
Každá fakturovaná odpověď obsahuje blok _billing; vyhodnocení na požadavek poskytuje GET /latest/billing/usage-detail.
- Pevná omezení
Přihlášení k účtu, správa klíčů, OAuth, partner-administrace, změna plateb a crackování hesel jsou pro prohlížečové klíče zakázány. Produkt APIs včetně čtení fakturace a webhooků je povoleno. Odstranění Workspace, vyprázdnění koše a zrušení právního zámku lze provést pouze v aplikaci (403 UI_ONLY_ENDPOINT).
Začít
Vytvořit klíč, nastavit hlavičku, odeslat
Klíč vytvoříte v aplikaci pod Účet → API. První volání je krok za krokem popsáno v Prvním API-Call.
Provoz a důvěra
Co enterprise týmy kontrolují před prvním hovorem
Smlouvy, bezpečnost, podpora a limity, vše propojeno na jednom místě.
- Bezpečnost a soulad ISO/IEC 27001 certifikováno, vlastní infrastruktura v EU.
- SLA 99,9 % Dostupnost podle kalendářního měsíce, smluvně zaručeno.
- Zpracování na základě smlouvy (DPA) Smlouva o zpracování osobních údajů podle čl. 28 GDPR.
- Žádní subzpracovatelé Jeden poskytovatel pro engine, úložiště a zpracování.
- Technická podpora Přímá cesta k týmu podpory s vytvořením ticketu.
- Omezení rychlosti a hlavičky Dokumentované minimální hodnoty na token, RateLimit-hlavičky v každé odpovědi.
- Ceny a Credits Transparentní ceny Credits na volání.
Další zastávka
Jak postupovat dále
Doporučený další krok v developer funnelu a dva odpovídající odbočky.
