poai_ Server la server Cheie API
- Drepturile contului care o creează (admin: întregul cont)
- Nu se livrează niciodată în codul browserului
- Nu este necesar antetul Origin
- Blocat pentru MCP
- Poate fi limitată la adrese IP
Autentificare și chei
Un token Bearer. Fiecare endpoint.
Fiecare endpoint al produsului PaperOffice-API așteaptă antetul Authorization: Bearer. Fără flux OAuth, fără reîmprospătare.
Două tipuri de tokenuri, drepturi clare, limite de rată documentate.
Un antet Fără flux OAuth Revocabili în orice moment
- Infrastructură proprie UE Datele dumneavoastră rămân în Europa.
- ISO/IEC 27001 certificat Securitate certificată.
- Peste 24 de ani de experiență Dovedită. Stabilă. Pregătită pentru viitor.
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());Primul apel
Setați antetul, alegeți pipeline-ul, trimiteți
Calea de după /latest/job/add/ este numele operației: de obicei sub forma handler___command (de exemplu paperoffice_aiocr___generate), iar pentru IDP structurat, pipeline-ul de flux de lucru dedicat.
- Un antet
Authorization: Bearer po_ut_… — un punct final de produs nu are nevoie de mai mult. poai_ și po_ut_ nu trimit un antet Origin.
- Pipeline în cale
handler___command cu trei underscore-uri; workflow este excepția, cu propriul slug. Notația cu puncte primește ca răspuns HTTP 400 JOB_CONFIG_INVALID.
- Rezultat sau job_id
client_wait este true implicit: API menține conexiunea și returnează rezultatul inline. Dacă fereastra de timp nu este suficientă, se primește HTTP 202 cu job_id și poll_url pentru GET /latest/job/get/{job_id}.
Pentru idp_collection=invoice, modelul recomandat este basic-pro-max. Modelul efectiv folosit este returnat în câmpul model din răspuns și poate diferi de cel solicitat.
Tipuri de token-uri
Două tipuri de token-uri, clar separate
Ambele trebuie păstrate pe server. Le creați, rotiți și revocați în aplicație, la Cont → API.
po_ut_ Legat de utilizator User Token
- Încorporează drepturile utilizatorului său
- Nu se livrează niciodată în codul browserului
- Nu este necesar un antet Origin
- Autorizat pentru MCP
Cererea directă din browser nu trece prin cele două token-uri, ci prin cheia publicabilă po_pk_ — legată de origine, cu buget și limitare de rate. Vizualizare Publishable Keys
Permisiuni
Ce poate face un User Token
Un User Token are exact drepturile utilizatorului său în aceste domenii. Domeniile individuale nu pot fi alocate la creare; pentru limitare se utilizează un token de grup (po_gt_) cu drepturile unui grup de utilizatori.
- Documente
documentsÎncărcare, descărcare, procesare
- Workspaces
workspacesGestionarea dosarelor și structurii
- Job-uri AI
ai_jobsOCR, IDP, extragere
- Facturare
billingCitirea utilizării și soldului contului
- Utilizatori
usersGestionați membrii echipei
- Webhook-uri
webhooksPrimiți evenimente
- Bază de cunoștințe
knowledge_baseBază de cunoștințe și FAQ
- Agenți
agentsConfigurați agenții IDP
- Fluxuri de lucru
workflowsCreați automatizări
- Conformitate
complianceAudit, GDPR, arhivare
Limite de rată
Ce numără API
Numărarea se face pe token; fără bearer, pe adresă IP. Valorile de mai jos sunt minimele documentate care se aplică în fiecare tarif.
- 5
- Cereri pe secundă
- 30
- Cereri pe minut
- 100
- Cereri pe oră
- 500
- Cereri pe zi
- Valorile rămase se află în antetul răspunsului
Anteturile RateLimit-* și X-RateLimit-* ale fiecărui răspuns indică cât mai este disponibil în fereastra curentă.
- Depășire: HTTP 429
API răspunde cu RATE_LIMIT_EXCEEDED. Repetați apelul după timpul indicat în antetul Retry-After.
- Tarifele superioare cresc valorile
Tarife plătite se află peste aceste valori minime. Detaliile privind volumul fiecărui tarif sunt disponibile pe pagina de prețuri.
Siguranță
Ce protejează o cheie (key)
Șase mecanisme care intră în funcțiune în timpul operațiunilor — fiecare având un cod de stare verificabil sau o locație în aplicație.
- Rotare și revocare
Cheile sunt create, listate, rotite și revocate în aplicație la Cont → API. Un token revocat răspunde cu HTTP 401 TOKEN_NOT_FOUND.
- Expirare și valabilitate
Token-urile expirate răspund cu HTTP 401 BEARERTOKEN_EXPIRED, cele eronate cu HTTP 401 INVALID_TOKEN. Publishable Keys sunt valabile 180 de zile de la creare.
- Limite per token
Pe tariful Free se aplică limite de rată per token. În tarifele plătite, acestea se numără per cont, iar atâta timp cât există Credits, nu se aplică limite de rată acolo.
- Legarea la origine în browser
Cheile publicabile cer un Origin din Allowlist la fiecare cerere; altfel, API-ul răspunde cu 403 ORIGIN_HEADER_REQUIRED sau DOMAIN_NOT_ALLOWED.
- Urmărirea utilizării
Fiecare răspuns facturat conține un bloc _billing; defalcarea pe apel se obține prin GET /latest/billing/usage-detail.
- Blocări stricte
Autentificarea contului, gestionarea cheilor, OAuth, administrarea partenerilor, modificarea metodei de plată și spargerea parolei sunt blocate pentru cheile browser-ului. API-urile de produs, inclusiv citirea facturării și webhook-urile, sunt permise. Ștergerea Workspace-ului, golirea coșului de gunoi și eliberarea Legal-Hold funcționează doar în aplicație (403 UI_ONLY_ENDPOINT).
Start acum
Creați cheia, setați antetul, trimiteți
În aplicație, creați cheia la Cont → API. Primul apel este descris pas cu pas în Primul apel API.
Operațiuni și încredere
Ce verifică echipele enterprise înainte de primul apel
Contracte, securitate, suport și limite, toate link-urile într-un singur loc.
- Securitate și conformitate ISO/IEC 27001 certificat, infrastructură proprie în UE.
- SLA 99,9% Disponibilitate pe fiecare lună calendaristică, garantată contractual.
- Procesare a datelor în numele titularului (DPA) Contract privind procesarea datelor în numele titularului, în temeiul art. 28 din RGPD.
- Fără subprocesatori Un singur furnizor pentru motor, stocare și procesare.
- Suport tehnic Cale directă către echipa de suport, cu ticket.
- Limite de rată și anteturi Valori minime documentate per token, anteturi RateLimit în fiecare răspuns.
- Prețuri și Credits Prețuri transparente pentru Credits per apel.
Următoarea stație
Iată cum continuăm
Următorul pas recomandat în funnel-ul dezvoltatorilor și două ramificații potrivite.
