Hoppa till innehåll
Frågor?PaperOffice AI Phone Agent 24/7+49 69 3487102-0
Academy Kontakt Översikt Översikt Nyheter Nyheter
Dela

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å tokentyper, tydliga rättigheter, dokumenterade rate-limits.

En header Ingen OAuth-flöde Återkalle när som helst
En Bearer-token. Varje slutpunkt.
cURL
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"

Första anropet

Ställ in header, välj pipeline, skicka av

Sökvägen efter /latest/job/add/ är operationsnamnet: vanligtvis i handler___command-format (till exempel paperoffice_aiocr___generate), och för strukturerade IDP den dedikerade workflow-pipelinen.

  • En header

    Authorization: Bearer po_ut_… — mer behöver en produktändpunkt inte. poai_ 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 den rekommenderade modellen. Den modell som faktiskt används returneras i svarsfältet "model" och kan skilja sig från den begärda.

Token-typer

Två token-typer, tydligt åtskilda

Båda tillhör servern. De skapas, roterar och återkallas i appen under Konto → API.

poai_ Server till server

API-nyckel

  • Rättigheter för det konto som skapar den (admin: hela kontot)
  • Aldrig levereras i browser-kod
  • Ingen Origin-header krävs
  • Låst för MCP
  • Kan begränsas till IP-adresser
Hantera API-nycklar
po_ut_ Användarrelaterad

User Token

  • Bär användarens behörigheter
  • Aldrig levereras i browser-kod
  • Ingen Origin-header krävs
  • Tillåten för MCP
Skapa användartoken

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

Vad en User Token får göra

En User Token har exakt samma behörigheter som sin användare inom dessa områden. Individuella områden kan inte tilldelas vid skapandet; för att begränsa detta används ett grupp-token (po_gt_) med behörigheterna från en användargrupp.

  • Dokument documents

    Ladda upp, ladda ner, bearbetning

  • Workspaces workspaces

    Hantera mappar och struktur

  • AI-jobb ai_jobs

    OCR, IDP, extraktion

  • Fakturering billing

    Läs användning och kontosaldo

  • Användare users

    Hantera teammedlemmar

  • Webhooks webhooks

    Ta emot händelser

  • kunskapsbas knowledge_base

    Kunskapsbank och FAQ

  • Agenter agents

    Konfigurera IDP-agenter

  • Arbetsflöden workflows

    Skapa automatiseringar

  • Efterlevnad compliance

    Revision, 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

    Förfallna token returnerar HTTP 401 BEARERTOKEN_EXPIRED, felaktiga returnerar HTTP 401 INVALID_TOKEN. Publishable Keys gäller i 180 dagar från skapandet.

  • Gränser per token

    I Free-tarifen gäller rate-limits per token. I betalda tarifer räknas kontot; så länge Credits finns tillgängliga gäller inga rate-limits där.

  • 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).

Kom igång

Skapa nyckel, ange rubrik, skicka

Nyckeln skapas i appen under Konto → API. Det första anropet beskrivs steg för steg i Första API-anropet.

PaperOffice AI · Problem Solver

Berätta för oss, vad som kostar tid varje dag.

Beskriv enkelt. Inga facktermer behövs.

Eller starta med ett exempel

Hur ska PaperOffice användas?

Dator och smartphone är anslutna: Arbetsyta på datorn, registrering på telefonen.

Var vill du börja?

Den fullständiga arbetsytan är optimerad för datorn. Mobilversionen passar bra för att registrera, granska och godkänna dokument.

Registrera gratis app.paperoffice.ai

Börja på datorn

Vi skickar din personliga åtkomstlänk till din e-postadress.