po_sk_ Server till server Hemlig nyckel
- Full åtkomst inom ramen för kontot
- Aldrig levereras i browser-kod
- Ingen Origin-header krävs
- Låst för MCP
Autentisering och nycklar
En Bearer-token. Varje slutpunkt.
Varje produkt-slutpunkt för PaperOffice-API förväntar sig headern Authorization: Bearer. Ingen OAuth-flöde, ingen refresh.
Två token-typer, tio behörighetsområden, dokumenterade rate-limits.
En header Ingen OAuth-flöde Återkalle när som helst
- Egen EU-infrastruktur Dina data stannar i Europa.
- ISO 27001 aktiv Säkerhet certifierad.
- SOC 2 Typ II aktiv Internationella revisionsstandarder.
- 24+ års erfarenhet Beprövad. Stabil. Framtidssäker.
curl -X POST "https://api.paperoffice.ai/latest/job/add/workflow" \ -H "Authorization: Bearer po_ut_YOUR_API_KEY" \ -F "[email protected]" \ -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örsta anropet
Ställ in header, välj pipeline, skicka av
Sökvägen till /latest/job/add/ är köjobbnamnet: oftast i formatet handler___command (t.ex. paperoffice_aiocr___generate), för strukturerad IDP är det din egen pipeline workflow.
- En header
Authorization: Bearer po_ut_… — mer behöver en produktändpunkt inte. po_sk_ och po_ut_ skickar ingen Origin-header.
- Pipeline i sökvägen
handler___command med tre understreck; workflow är undantaget med egen slug. Punktskrift svarar på API med HTTP 400 JOB_CONFIG_INVALID.
- Resultat eller job_id
client_wait är standardmässigt true: API håller anslutningen och levererar resultatet inline. Om tidsfönstret inte räcker till returneras HTTP 202 med job_id och poll_url för GET /latest/job/get/{job_id}.
För idp_collection=invoice är basic-pro-max det rekommenderade modell: OCR-first begränsar tryckta samlingar med positioner redan till basic-pro-max; en skickad model=premium returneras som model: basic-pro-max.
Token-typer
Två token-typer, tydligt åtskilda
Båda tillhör servern. De skapas, roterar och återkallas i appen under Konto → API.
po_ut_ Användarrelaterad User Token
- Kan begränsas till enskilda områden
- Aldrig levereras i browser-kod
- Ingen Origin-header krävs
- Tillåten för MCP
Anrop direkt från webbläsaren går inte via dessa två token, utan via Publishable Key po_pk_ — härkomstkopplat, med budget- och ratgräns. Se Publishable Keys
Behörigheter
Tio områden per användartoken
En användartoken innehåller exakt de områden du anger vid skapandet. Saknas området returnerar API med HTTP 403.
- Dokument
dokumentLadda upp, ladda ner, bearbetning
- Workspaces
arbetsområdenHantera mappar och struktur
- AI-jobb
ai_jobsOCR, IDP, extraktion
- Fakturering
fakturaLäs användning och kontosaldo
- Användare
användareHantera teammedlemmar
- Webhooks
webhooksTa emot händelser
- kunskapsbas
kunskapsbasKunskapsbank och FAQ
- Agenter
agenterKonfigurera IDP-agenter
- Arbetsflöden
arbetsflödenSkapa automatiseringar
- Efterlevnad
complianceRevision, GDPR, arkivering
Rate-limits
Vad API räknar
Begräknas per token; utan Bearer per IP-adress. Följande värden är de dokumenterade minimivärdena som gäller i varje tariff.
- 5
- Förfrågningar per sekund
- 30
- Förfrågningar per minut
- 100
- Förfrågningar per timme
- 500
- Förfrågningar per dag
- Restvärden finns i svarshuvudet
Huvudena RateLimit-* och X-RateLimit-* i varje svar anger hur mycket som återstår under det pågående fönstret.
- Överskridning: HTTP 429
API svarar med RATE_LIMIT_EXCEEDED. Upprepa anropet efter tiden angiven i Retry-After-huvudet.
- Högre tariffer höjer värdena
Betalda tariffer ligger över dessa minimivärden. Vilken omfattning respektive tariff har framgår på prissidan.
Säkerhet
Vad som skyddar en nyckel
Sex mekanismer som aktiveras i drift — var och en med ett verifierbart statuskod eller en plats i appen.
- Rotation och återkallelse
Nycklar skapas, listas, roterades och återkallas i appen under Konto → API. En återkallad token svarar med HTTP 401 TOKEN_NOT_FOUND.
- Utgångsdatum och giltighet
Utgångna eller felaktiga tokens returneras som HTTP 401 INVALID_TOKEN. Publishable Keys går ut senast efter 365 dagar.
- Gränser per token
Ratebegränsningar räknas per token, inte per konto. En komprometterad nyckel belastar därmed inte hela verksamheten.
- Ursprungsbindning i webbläsaren
Publishable keys kräver ett ursprung från allowlistan vid varje begäran; annars svarar API med 403 ORIGIN_HEADER_REQUIRED eller DOMAIN_NOT_ALLOWED.
- Spåra användningen
Varje fakturerat svar innehåller en _billing-block; utvärdering per anrop ger GET /latest/billing/usage-detail.
- Hårda spärrar
Konto-inloggning, nyckelhantering, OAuth, partneradministratör, betalningsändring och lösenordsknäckning är blockerade för webbläsarnycklar. Produkt-APIs inklusive faktureringsläsning och webhooks är tillåtna. Workspace raderas, papperskorgen töms och legal hold-frihet går endast i appen (403 UI_ONLY_ENDPOINT).
Video
Autentisering i användning
Se hur ett anrop med bearer-token fungerar i praktiken — i videon.
Vidaregående
Vad som står bredvid
Sidorna som täcker driften kring autentisering.
Publishable Keys Samtal direkt från webbläsaren med po_pk_. Webhooks Ta emot händelser istället för att polla. Postman-Samling Alla slutpunkter att bläddra igenom. API-katalog Vilken slutpunkt som gör vad. llms-full.txt Hela dokumentationen för din IDE. Tariffer Vilken omfattning som varje tariff bär.
Kom igång
Skapa nyckel, ange rubrik, skicka
Du skapar nyckeln i appen under Konto → API. Det första anropet beskrivs steg för steg i Första API-anropet.
Drift och förtroende
Vad enterprise-team kontrollerar före det första samtalet
Kontrakt, säkerhet, support och gränser, allt länkat på ett ställe.
- Säkerhet och efterlevnad ISO 27001, SOC 2 Typ II, egen EU-infrastruktur.
- SLA 99,9 % Tillgänglighet per kalendermånad, avtalsenligt garanterad.
- Uppdragsgivarbehandling (DPA) GDPR-kontrakt för uppgiftsbehandling.
- Lista över underleverantörer Alla underleverantörer, transparent listade.
- Teknisk support Direkt väg till supportteamet, med ärendesystem.
- Tak för frekvens och rubriker Dokumenterade minimivärden per token, RateLimit-rubrik i varje svar.
- Priser och Credits Transparenta Credit-priser per anrop.
Nästa station
Så här går det vidare
Det rekommenderade nästa steget i developer-funneln och två passande avdelningar.