poai_ Server do Servera API ključ
- Prava naloga koji ga kreira (administrator: ceo nalog)
- Nikada ne isporučivati u browser kodu
- Nije potreban Origin zaglavlje
- Blokirano za MCP
- Može biti ograničen na IP adrese
Autentifikacija i ključevi
Jedan Bearer token. Svaka krajnja tačka.
Svaka produktna krajnja tačka PaperOffice-API zahteva zaglavlje Authorization: Bearer. Bez OAuth protokola, bez osvežavanja.
Dva tipa tokena, jasna prava, dokumentovani limiti učestalosti.
Jedno zaglavlje Nema OAuth toka Bilo kada moguće opozvati
- Sopstvena EU infrastruktura Vaši podaci ostaju u Evropi.
- ISO/IEC 27001 sertifikovano Sertifikovana bezbednost.
- Preko 24 godine iskustva Provereno. Stabilno. Budućnost sigurno.
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());Prvi poziv
Postavite zaglavlje, odaberite cevovod, pošaljite
Put nakon /latest/job/add/ je naziv operacije: obično u formi handler___command (na primer paperoffice_aiocr___generate), a za strukturirani IDP je to workflow.
- Jedno zaglavlje
Authorization: Bearer po_ut_… — više nije potrebno za krajnju tačku proizvoda. poai_ i po_ut_ ne šalju Origin zaglavlje.
- Cevovod u putanji
handler___command sa tri donje crte; workflow je izuzetak sa sopstvenim slugom. Tačkasti zapis odgovara na API sa HTTP 400 JOB_CONFIG_INVALID.
- Rezultat ili job_id
client_wait je podrazumevano true: API održava vezu i vraća rezultat inline. Ako vremenski okvir nije dovoljan, dolazi do HTTP 202 sa job_id i poll_url za GET /latest/job/get/{job_id}.
Za idp_collection=invoice, basic-pro-max je preporučeni model. Model koji je zapravo korišćen vraća se u odgovoru u polju model i može se razlikovati od zahtevanog.
Vrste tokena
Dve vrste tokena, jasno odvojene
Oba pripadaju serveru. Kreiraju se, rotiraju i opozivaju u aplikaciji pod Account → API.
po_ut_ Povezano sa korisnikom User Token
- Nosi prava svog korisnika
- Nikada ne isporučivati u browser kodu
- Nije potreban Origin zaglavlje
- Dozvoljeno za MCP
Pozivi direktno iz pregledača ne prolaze kroz ova dva tokena, već kroz Publishable Key po_pk_ — vezan za poreklo, ograničen budžetom i stopom. Pregled Publishable Keys
Dozvole
Šta User Token sme da radi
User Token ima tačno ona prava svog korisnika u ovim oblastima. Pojedine oblasti se ne mogu dodeliti prilikom kreiranja; za ograničavanje služi grupni token (po_gt_) sa pravima grupe korisnika.
- Dokumenti
documentsOtpremanje, preuzimanje, obrada
- Workspaces
workspacesUpravljanje folderima i strukturom
- AI poslovi
ai_jobsOCR, IDP, ekstrakcija
- Naplaćivanje
billingČitanje upotrebe i stanja računa
- Korisnici
usersUpravljanje članovima tima
- Webhookovi
webhooksPrijem događaja
- Baza znanja
knowledge_baseBaza znanja i FAQ
- Agenti
agentsKonfigurišite IDP agente
- Tečni rada
workflowsKreirajte automatizacije
- Komplajans
complianceAudit, GDPR, arhiviranje
Ograničenja stope
Šta API broji
Naplaćuje se po tokenu; bez Bearera po IP adresi. Sledeće vrednosti su dokumentovane minimalne vrednosti koje važe u svakom tarifu.
- 5
- Zahtevi po sekundi
- 30
- Zahtevi po minutu
- 100
- Zahtevi po satu
- 500
- Zahtevi po danu
- Preostale vrednosti su u odgovarajućem zaglavlju
Zaglavlja RateLimit-* i X-RateLimit-* svakog odgovora pokazuju koliko je još dostupno u trenutnom prozoru.
- Prekoračenje: HTTP 429
API odgovara sa RATE_LIMIT_EXCEEDED. Ponovite poziv nakon vremena navedenog u Retry-After zaglavlju.
- Viši tarifi podižu vrednosti
Plaćeni tarifi su iznad ovih minimalnih vrednosti. Koji tarifa koji obim ima, navedeno je na stranici sa cenama.
Bezbednost
Šta štiti ključ
Šest mehanizama koji deluju u radu — svaki sa proverljivim kodom statusa ili mestom u aplikaciji.
- Rotacija i oduzimanje
Ključevi se kreiraju, prikazuju, rotiraju i oduzimaju u aplikaciji pod Nalog → API. Oduzeti token vraća HTTP 401 TOKEN_NOT_FOUND.
- Istek i valjanost
Istekli tokeni odgovaraju sa HTTP 401 BEARERTOKEN_EXPIRED, neispravni sa HTTP 401 INVALID_TOKEN. Publishable Keys važe 180 dana od kreiranja.
- Limiti po tokenu
U tarifi Free važe ograničenja brzine zahteva po tokenu. U plaćenim tarifama računa se nalog; dokle god postoje Credits, u njima ne važe ograničenja brzine zahteva.
- Veza porekla u pregledaču
Publishable Keys zahtevaju Origin iz Allowlista pri svakom zahtevu; u suprotnom, API odgovara sa 403 ORIGIN_HEADER_REQUIRED ili DOMAIN_NOT_ALLOWED.
- Praćenje upotrebe
Svaki obračunati odgovor sadrži _billing blok; evaluacija po pozivu daje GET /latest/billing/usage-detail.
- Stroge zabrane
Prijava na konto, upravljanje ključevima, OAuth, administracija partnera, promene plaćanja i lomljenje lozinke su zaključani za browser ključeve. Proizvod APIs uključujući čitanje fakturisanja i webhooks su dozvoljeni. Brisanje Workspace, pražnjenje korpe i oslobađanje pravnog zadržavanja mogu se izvršiti samo u aplikaciji (403 UI_ONLY_ENDPOINT).
Započeti sada
Kreirajte ključ, postavite zaglavlje, pošaljite
Ključ kreirate u aplikaciji pod Nalog → API. Prvi poziv je korak po korak opisan u prvom API-pozivu.
Operacije i poverenje
Šta entitim timovi proveravaju pre prvog poziva
Ugovori, bezbednost, podrška i limiti, sve povezano na jednom mestu.
- Bezbednost i usklađenost ISO/IEC 27001 sertifikovano, sopstvena infrastruktura u EU.
- SLA 99,9% Dostupnost po kalendarskom mesecu, ugovorno garantovana.
- Ugovor o obradi podataka (DPA) Ugovor o obradi podataka prema članu 28 GDPR-a.
- Bez podprocesora Jedan pružalac za engine, skladištenje i obradu.
- Tehnička podrška Direktan put do tima za podršku, sa tiketom.
- Ograničenja učestalosti i zaglavlja Dokumentovane minimalne vrednosti po tokenu, RateLimit zaglavlje u svakom odgovoru.
- Cene i Credits Transparentne cene Credits po pozivu.
Sledeća stanica
Kako nastaviti
Preporučeni sledeći korak u funilu za programere i dve odgovarajuće diverzije.
