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, deset opsega dozvola, dokumentovani limiti brzine.

Kreiranje API ključa Pokretanje prvog API poziva

Jedno zaglavlje Nema OAuth toka Bilo kada moguće opozvati

app.paperoffice.ai/account/api

Zahtev 200 OK Token je važeći

Authorization zaglavlje

Authorization: Bearer po_ut_YOUR_API_KEY

Dozvole

ocr:read
documents:write
jobs:read

Odgovor

{
  "status": "success",
  "job_id": "8f2c1a…",
  "result": { "pages": 3 }
}

Vlastična EU-infrastruktura Vaši podaci ostaju u Evropi.
ISO 27001 aktivno Sertifikovana bezbednost.
SOC 2 Tip II aktiv Međunarodni standardi za reviziju.
Preko 24 godine iskustva Provereno. Stabilno. Budućnost sigurno.

cURL

1curl -X POST "https://api.paperoffice.ai/latest/job/add/workflow" \2  -H "Authorization: Bearer po_ut_YOUR_API_KEY" \3  -F "[email protected]" \4  -F "idp_collection=invoice" \5  -F "model=basic-pro-max"

1import requests23response = requests.post(4    "https://api.paperoffice.ai/latest/job/add/workflow",5    headers={"Authorization": "Bearer po_ut_YOUR_API_KEY"},6    files={"file_1": open("invoice.pdf", "rb")},7    data={"idp_collection": "invoice", "model": "basic-pro-max"},8)9print(response.json())

1const form = new FormData();2form.append("file_1", new Blob([await readFile("invoice.pdf")]), "invoice.pdf");3form.append("idp_collection", "invoice");4form.append("model", "basic-pro-max");56const response = await fetch("https://api.paperoffice.ai/latest/job/add/workflow", {7  method: "POST",8  headers: { Authorization: "Bearer po_ut_YOUR_API_KEY" },9  body: form,10});11console.log(await response.json());

Prvi poziv

Postavite zaglavlje, odaberite cevovod, pošaljite

Putanja do /latest/job/add/ je ime redčnog zadatka: obično u formatu handler___command (npr. paperoffice_aiocr___generate), za strukturirani IDP to je sopstveni radni tok cevovoda.

Jedno zaglavlje
Authorization: Bearer po_ut_… — više nije potrebno za krajnju tačku proizvoda. po_sk_ 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}.

Pogledajte API katalog llms-full.txt za vaš IDE

Za idp_collection=invoice preporučeni model je basic-pro-max: OCR-first ograničava štampane kolekcije sa pozicijama uvek na basic-pro-max; poslati model=premium vraća se kao model: basic-pro-max.

Vrste tokena

Dve vrste tokena, jasno odvojene

Oba pripadaju serveru. Kreiraju se, rotiraju i opozivaju u aplikaciji pod Account → API.

po_sk_ Server do Servera

Tajni ključ

Puni pristup u okviru naloga
Nikada ne isporučivati u browser kodu
Nije potreban Origin zaglavlje
Blokirano za MCP

Upravljanje tajnim ključem

po_ut_ Povezano sa korisnikom

User Token

Može se ograničiti na pojedinačne delove
Nikada ne isporučivati u browser kodu
Nije potreban Origin zaglavlje
Dozvoljeno za MCP

Kreiranje korisničkog tokena

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

Deset oblasti po korisničkom tokenu

Korisnički token nosi tačno one oblasti koje mu dodelite prilikom kreiranja. Ako nedostaje oblast, API odgovara sa HTTP 403.

Dokumenti dokumenti
Otpremanje, preuzimanje, obrada
Workspaces radni_prostori
Upravljanje folderima i strukturom
AI poslovi ai_jobs
OCR, IDP, ekstrakcija
Naplaćivanje naplata
Čitanje upotrebe i stanja računa
Korisnici korisnici
Upravljanje članovima tima
Webhookovi webhookovi
Prijem događaja
Baza znanja baza_znanja
Baza znanja i FAQ
Agenti agenti
Konfigurišite IDP agente
Tečni rada radni tokovi
Kreirajte automatizacije
Komplajans compliance
Audit, 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.

Pregled tarifa i obima

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 ili neispravni tokeni vraćaju se kao HTTP 401 INVALID_TOKEN. Publishable Keys ističu najkasnije nakon 365 dana.
Limiti po tokenu
Rate-limiti se računaju po token-u, a ne po nalogu. Kompromitovani ključ ne opterećuje ceo operativni sistem.
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).

Video

Autentifikacija u praksi

Pogledajte kako izgleda poziv sa Bearer-tokenom u praksi — u videu.

Dalje čitanje

Šta je pored toga navedeno

Stranice koje pokrivaju operativni sistem oko autentifikacije.

Publishable Keys Pozivi direktno iz pregledača sa po_pk_. Webhookovi Primanje događaja umesto polovanja. Postman-Kolekcija Sve krajnje tačke za pretraživanje. API-katalog Koja krajnja tačka koju posao obavlja. llms-full.txt Cela dokumentacija za vaš IDE. Tarife Koji obim nosi koji tarifni paket.

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.

Kreiranje API ključa Pokretanje prvog API poziva

Operacije i poverenje

Šta entitim timovi proveravaju pre prvog poziva

Ugovori, bezbednost, podrška i limiti, sve povezano na jednom mestu.

Sledeća stanica

Kako nastaviti

Preporučeni sledeći korak u funilu za programere i dve odgovarajuće diverzije.

Webhooks & EventsDogađaji u realnom vremenu, HMAC Prvi API pozivDobavi ključ, pošalji zahtev, proveri odgovor Postman CollectionUvoz, testiranje i ispravljanje u Postmanu

Nazad na početak za programere

Razumite PaperOffice AI za 14 minuta.

Kako želite da koristite PaperOffice?