poai_ Server til server API-nøgle
- Rettigheder for den konto, der opretter den (administrator: hele kontoen)
- Aldrig leveret i browser-kode
- Ingen Origin-header påkrævet
- Blokeret for MCP
- Kan begrænses til IP-adresser
Autentificering og nøgler
En Bearer-token. Hver endpoint.
Hver produkt-endpoint for PaperOffice-API forventer headeren Authorization: Bearer. Ingen OAuth-flow, ingen refresh.
To token-typer, klare rettigheder, dokumenterede rate-limits.
En header Ingen OAuth-flow Tilbagekaldelig til enhver tid
- Eget EU-infrastruktur Dine data forbliver i Europa.
- ISO/IEC 27001 certificeret Sikkerhed certificeret.
- 24+ års erfaring Prøvet. Stabil. Fremtidssikret.
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());Første opkald
Indstil header, vælg pipeline, afsend
Stien efter /latest/job/add/ er operationsnavnet: normalt i handler___command format (for eksempel paperoffice_aiocr___generate), og for strukturerede IDP'er dedikeret workflow pipeline.
- En header
Authorization: Bearer po_ut_… — mere behøver et produkt-endepunkt ikke. poai_ og po_ut_ sender ingen Origin-header.
- Pipeline i stien
handler___command med tre understreger; workflow er undtagelsen med egen slug. Punktnotation svarer på API med HTTP 400 JOB_CONFIG_INVALID.
- Resultat eller job_id
client_wait er standard true: API holder forbindelsen åben og leverer resultatet inline. Hvis tidsvinduet ikke er tilstrækkeligt, returneres HTTP 202 med job_id og poll_url til GET /latest/job/get/{job_id}.
For idp_collection=invoice er basic-pro-max det anbefalede model. Den faktisk anvendte model returneres i svarfeltet 'model' og kan afvige fra den anmodede.
Token-typer
To token-typer, klart adskilt
Begge skal sendes til serveren. De oprettes, roteres og inddrives i appen under Konto → API.
po_ut_ Brugerrelateret User Token
- Bærer sin brugers rettigheder
- Aldrig leveret i browser-kode
- Ingen Origin-header påkrævet
- Godkendt til MCP
Anrop direkte fra browseren kører ikke gennem disse to tokens, men via Publishable Key po_pk_ — oprindelsesbaseret, med budget- og ratebegrænsning. Publishable Keys
Tilladelser
Hvad en User Token må
En User Token har præcis de rettigheder, som dens bruger har i disse områder. Individuelle områder kan ikke tildeles under oprettelse; afgrænsning sker via et gruppetoken (po_gt_) med rettighederne fra en brugerguppe.
- Dokumenter
documentsUpload, Download, behandling
- Workspaces
workspacesAdministrere mapper og struktur
- AI-job
ai_jobsOCR, IDP, udtrækning
- Fakturering
billingLæse forbrug og kontostand
- Brugere
usersAdministrer teammedlemmer
- Webhooks
webhooksModtag begivenheder
- Vidensbase
knowledge_baseVidensbase og FAQ
- Agenter
agentsKonfigurer IDP-agenter
- Arbejdsgange
workflowsOpret automatiseringer
- Overholdelse
complianceRevision, GDPR, arkivering
Rate-begrænsninger
Hvad API tæller
Der beregnes pr. token; uden Bearer pr. IP-adresse. Følgende værdier er de dokumenterede minimumsværdier, der gælder for hver tarif.
- 5
- Forespørgsler pr. sekund
- 30
- Forespørgsler pr. minut
- 100
- Forespørgsler pr. time
- 500
- Forespørgsler pr. dag
- Restværdier findes i svarhovedet
Headerne RateLimit-* og X-RateLimit-* i hvert svar angiver, hvor meget der stadig er åbent i det aktuelle vindue.
- Overskridelse: HTTP 429
API svarer med RATE_LIMIT_EXCEEDED. Gentag anmodningen efter tiden angivet i Retry-After-headeren.
- Højere tarifer hæver værdierne
Betalt tariffer ligger over disse minimumsværdier. Hvilken tarif hvilket omfang har, står på prissiden.
Sikkerhed
Hvad der sikrer en nøgle
Seks mekanismer, der træder i kraft under drift — hver med en verificerbar statuskode eller et sted i appen.
- Rotation og tilbagetrækning
Nøgler oprettes, vises, roteres og tilbagetrækkes i appen under Konto → API. En tilbagetrukket token svarer med HTTP 401 TOKEN_NOT_FOUND.
- Udløb og gyldighed
Udløbne tokens svarer med HTTP 401 BEARERTOKEN_EXPIRED, ugyldige med HTTP 401 INVALID_TOKEN. Publishable Keys gælder i 180 dage fra oprettelse.
- Grænser pr. token
I Free-tariffen gælder rate-begrænsninger pr. token. I betalte tariffer tæller kontoen; så længe der er Credits tilgængelige, gælder der ingen rate-begrænsninger.
- Oprindelsesbinding i browser
Publishable keys kræver en oprindelse fra allowlisten ved hvert anrop; ellers returneres API med 403 ORIGIN_HEADER_REQUIRED eller DOMAIN_NOT_ALLOWED.
- Spor brug
Hver faktureret svar indeholder en _billing-blok; evaluering pr. anrop giver GET /latest/billing/usage-detail.
- Hårde blokeringer
Konto-login, nøglehåndtering, OAuth, partner-administrering, betalingsmutation og adgangskodeknækning er blokeret for browser-nøgler. Produkt-APIs inklusive faktureringslæsning og webhooks er tilladt. Workspace slettes, papirkurv tømmes og legal hold-frigivelse sker kun i appen (403 UI_ONLY_ENDPOINT).
Øjeblikkelig start
Opret nøgle, indstil header, send
Du opretter nøglen i appen under Konto → API. Det første kald beskrives trin for trin i 'Første API-kald'.
Drift og tillid
Hvad enterprise-teams tjekker før det første opkald
Kontrakter, sikkerhed, support og grænser, alle linket ét sted.
- Sikkerhed og overholdelse ISO/IEC 27001 certificeret, eget EU-infrastruktur.
- SLA på 99,9 % Tilgængelighed pr. kalendermåned, kontraktmæssigt garanteret.
- Behandling på vegne af anden (DPA) Kontrakt om behandling på vegne af anden efter art. 28 i GDPR.
- Ingen underbehandlere En udbyder til engine, lagring og behandling.
- Teknisk support Direkte vej til supportteamet, med ticket.
- Rate-begrænsninger og headers Dokumenterede minimumsværdier pr. token, RateLimit-header i hvert svar.
- Priser og Credits Gennemsigtige Credit-priser pr. anmodning.
Næste station
Sådan går det videre
Det anbefalede næste skridt i developer-funnelen og to passende sideveje.
