Authenticatie en sleutels

Een Bearer-token. Elk eindpunt.

Elk product-eindpunt van de PaperOffice-API verwacht de header Authorization: Bearer. Geen OAuth-flow, geen refresh.

Twee token-typen, tien machtigingsgebieden, gedocumenteerde rate-limits.

API-sleutel aanmaken Eerste API-call starten

Een header Geen OAuth-flow Altijd herroepbaar

app.paperoffice.ai/account/api

Verzoek 200 OK Token geldig

Authorization-header

Authorization: Bearer po_ut_YOUR_API_KEY

Machtigingen

ocr:read
documents:write
jobs:read

Antwoord

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

Eigen EU-infrastructuur Uw gegevens blijven in Europa.
ISO 27001 actief Beveiliging gecertificeerd.
SOC 2 Type II actief Internationale auditnormen.
24+ jaar ervaring Bewezen. Stabiel. Toekomstbestendig.

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());

Eerste aanroep

Header instellen, pipeline kiezen, verzenden

Het pad naar /latest/job/add/ is de naam van de wachtrijtaak: meestal in de vorm handler___command (bijv. paperoffice_aiocr___generate), voor gestructureerde IDP de eigen pipeline workflow.

Eén header
Authorization: Bearer po_ut_… — meer heeft een product-eindpunt niet nodig. po_sk_ en po_ut_ sturen geen Origin-header.
Pipeline in het pad
handler___command met drie onderstrepingstekens; workflow is de uitzondering met een eigen slug. Puntnotatie beantwoordt API met HTTP 400 JOB_CONFIG_INVALID.
Resultaat of job_id
client_wait is standaard true: De API houdt de verbinding actief en levert het resultaat inline. Als het tijdskader niet toereikend is, wordt HTTP 202 geretourneerd met job_id en poll_url voor GET /latest/job/get/{job_id}.

Bekijk API-catalogus llms-full.txt voor uw IDE

Voor idp_collection=invoice is basic-pro-max het aanbevolen model: OCR-first beperkt gedrukte verzamelingen met posities sowieso tot basic-pro-max; een verzonden model=premium wordt geretourneerd als model: basic-pro-max.

Token-typen

Twee token-typen, duidelijk gescheiden

Beide behoren tot de server. Ze worden aangemaakt, geroteerd en ingetrokken in de app onder Account → API.

po_sk_ Server-tot-server

Geheime sleutel

Volle toegang binnen het account
Nooit in browsercode leveren
Geen Origin-header nodig
Geblokkeerd voor MCP

Secret Key beheren

po_ut_ Gebruikersgerelateerd

User Token

Beperkbaar tot specifieke gebieden
Nooit in browsercode leveren
Geen Origin-header vereist
Toegestaan voor MCP

Gebruikerstoken aanmaken

Aanroepen direct vanuit de browser lopen niet via deze twee tokens, maar via de Publishable Key po_pk_ — herkomstgebonden, budget- en ratebeperkt. Publishable Keys bekijken

Machtigingen

Tien gebieden per gebruikerstoken

Een gebruikerstoken bevat precies de gebieden die u bij het aanmaken toekent. Ontbreekt het gebied, dan antwoordt API met HTTP 403.

Documenten documenten
Uploaden, Downloaden, Verwerken
Workspaces werkruimtes
Mappen en structuur beheren
AI-jobs ai_jobs
OCR, IDP, extractie
Facturering facturering
Gebruik en saldo lezen
Gebruikers gebruikers
Teamleden beheren
Webhooks webhooks
Gebeurtenissen ontvangen
Kennisbank kennisbank
Kennisbank en FAQ
Agenten agenten
IDP-agents configureren
Workflow werkstromen
Automatiseringen maken
Naleving compliance
Audit, AVG, archivering

Rate-limits

Wat API telt

Er wordt per token gerekend; zonder Bearer per IP-adres. De volgende waarden zijn de gedocumenteerde minimumwaarden die in elk tarief gelden.

5: Verzoeken per seconde
30: Verzoeken per minuut
100: Verzoeken per uur
500: Verzoeken per dag

Restwaarden staan in de antwoordheaders
De headers RateLimit-* en X-RateLimit-* van elk antwoord geven aan hoeveel er in het lopende venster nog beschikbaar is.
Overschrijding: HTTP 429
API antwoordt met RATE_LIMIT_EXCEEDED. Herhaal de aanroep na de tijd uit de Retry-After-header.
Hogere tarieven verhogen de waarden
Betaalde tarieven liggen boven deze minimumwaarden. Welk tarief welke omvang heeft, staat op de prijspagina.

Tarieven en omvang bekijken

Beveiliging

Wat een key beschermt

Zes mechanismen die in bedrijf werken — elk met een controleerbare statuscode of een locatie in de app.

Rotatie en intrekking
Keys worden in de app aangemaakt, weergegeven, geroteerd en ingetrokken onder Account → API. Een ingetrokken token antwoordt met HTTP 401 TOKEN_NOT_FOUND.
Vervaldatum en geldigheid
Verlopen of foutieve tokens worden teruggegeven als HTTP 401 INVALID_TOKEN. Publishable Keys vervallen uiterlijk na 365 dagen.
Limieten per token
Rate-limits tellen per token, niet per account. Een gecompromitteerde sleutel belast hiermee niet de gehele organisatie.
Herkomstbinding in de browser
Publishable keys vereisen bij elk verzoek een origin uit de allowlist; anders wordt geantwoord met API met status 403 ORIGIN_HEADER_REQUIRED of DOMAIN_NOT_ALLOWED.
Gebruik nagaan
Elk gefactureerd antwoord bevat een _billing-blok; de evaluatie per aanroep levert GET /latest/billing/usage-detail op.
Harde blokkades
Account-login, sleutelbeheer, OAuth, partner-administratie, betalingsmutaties en wachtwoordkraken zijn geblokkeerd voor browser-sleutels. Product-APIs inclusief facturatie-lezen en webhooks zijn toegestaan. Workspace verwijderen, prullenbak legen en Legal-Hold-vrijgave gaan alleen in de app (403 UI_ONLY_ENDPOINT).

Video

Authenticatie in actie

Zie hoe een aanroep met Bearer-token in de praktijk werkt — in de video.

Verder lezen

Wat er naast staat

De pagina's die het beheer rondom authenticatie afdekken.

Publishable Keys Oproepen direct vanuit de browser met po_pk_. Webhooks Gebeurtenissen ontvangen in plaats van polleren. Postman-Collectie Alle eindpunten om door te klikken. API-Catalogus Welk eindpunt welke taak uitvoert. llms-full.txt De volledige documentatie voor uw IDE. Tarieven Welke omvang welke tarief draagt.

Aan de slag

Sleutel aanmaken, header instellen, verzenden

U maakt de sleutel in de app aan onder Account → API. De eerste aanroep wordt stap voor stap beschreven in de Eerste API-aanroep.

API-sleutel aanmaken Eerste API-call starten

Bedrijfsvoering en vertrouwen

Wat enterprise-teams controleren voor het eerste gesprek

Contracten, veiligheid, ondersteuning en limieten, allemaal op één plek gelinkt.

Volgende halte

Zo gaat het verder

De aanbevolen volgende stap in de developer-funnel en twee passende vertakkingen.

Webhooks & EventsRealtime events, HMAC-ondertekend Eerste API-aanroepSleutel halen, request sturen, antwoord controleren Postman CollectionImporteer, test en debug in Postman

Terug naar de developer-start

PaperOffice App

Werken met AI-agenten

API & MCP