API‑tokens | Procurize.AI#

Generér, administrer og brug API‑tokens for sikker programmatisk adgang til din Procurize.AI‑arbejdsplads.

Gælder for: Procurize.AI‑dashboard → Indstillinger → Tokens
Tilgængelig på: Business‑ og Enterprise‑planerne
Påkrævet rolle: Admin eller Maintainer

Oversigt#

API‑tokens muliggør sikker, programmatisk adgang til Procurize.AI‑platformen. Du kan bruge tokens til at integrere Procurize.AI med dine interne systemer, automatisere arbejdsgange eller bygge brugerdefinerede applikationer oven på platformen.

Vigtige karakteristika:

  • Tokens arver alle tilladelser fra brugeren, der oprettede dem
  • Tokens er organisations‑omfattende – der er ingen grund til at angive org i API‑kald
  • Ubegrænset antal tokens kan genereres
  • Tokens kan have udløbsdatoer eller indstilles til aldrig at udløbe
  • Tokens kan deaktiveres og senere reactiveres, efter behov

🔒 Sikkerhedsnote: Procurize.AI gemmer ikke selve token‑værdien – kun dens hash. Du skal kopiere og gemme tokenet med det samme efter generering. Det vil ikke blive vist igen.

Sådan får du adgang til token‑administrationspanelet#

  1. Gå til DashboardIndstillingerTokens‑fanen.
  2. Token‑administrationspanelet viser dine personlige tokens, som er knyttet til den aktuelle organisation.

API‑tokens panel

Krævet tilladelse: Kun brugere med Admin‑ eller Maintainer‑roller kan få adgang til dette panel. For detaljerede rolletdefinitioner, se Rettighedsoversigt .

Generering af en ny token#

  1. Indtast et Navn for at identificere tokenens formål.

  2. Vælg en udløbsperiode:

    • 1 måned
    • 3 måneder
    • 1 år
    • Ingen udløb (ubegrænset gyldighed)
  3. Klik på “Generer”.

Vigtigt – kopiér tokenet med det samme#

Efter generering vises token‑værdien kun én gang – kopier den og gem den sikkert (fx i en password‑manager eller som en miljøvariabel).

Ny API‑token

⚠️ Du kan ikke se token‑værdien igen. Procurize.AI gemmer kun en sikker hash til verifikation. Hvis du mister tokenet, skal du tilbagekalde det og generere et nyt.

Administration af eksisterende tokens#

Tokens‑panelet viser en liste over alle genererede tokens med deres:

  • Navn
  • Suffix
  • Oprettelsesdato
  • Udløbsdato (eller “-”)
  • Status: Aktiv eller Inaktiv

Deaktivere / Reactivere en token#

  • Deaktiver – deaktiverer tokenet midlertidigt. Du kan reaktivere det senere, hvis det er nødvendigt.
  • Reaktivér – genaktiverer et tidligere deaktiveret token.

💡 Deaktivering er nyttigt, når du midlertidigt vil suspendere integrationer uden at slette tokenet.

Tilbagekalde en token#

  • Tilbagekald – sletter tokenet permanent. Handlingen kan ikke fortrydes.
  • Hvis du mister et token, skal du tilbagekalde det med det samme og generere et nyt.

Brug af en API‑token#

Basis‑URL & autentifikation#

ParameterVærdi
Basis‑URLhttps://api.procurize.com
AutentifikationsmetodeAPI‑nøgle via header
HeaderX-API-Key: <DIN_API_TOKEN>

Eksempel‑anmodning (cURL)#

curl -X GET "https://api.procurize.com/v1/documents" \
  -H "X-API-Key: DIN_API_TOKEN"

🧠 Ingen organisations‑ID påkrævet – tokenet er bundet til din organisation, så API’et automatisk bruger den rette kontekst.

Vigtige sikkerheds‑ og brugsregler#

RegelForklaring
Token‑tilladelserTokenet har præcis de samme tilladelser som brugeren, der oprettede det. Hvis brugerens rolle ændres, opdateres tokenets tilladelser tilsvarende.
OrganisationsbindingTokens er knyttet til den organisations‑kontekst, som skaberen tilhører. Du kan ikke bruge et token på tværs af flere organisationer.
Token‑synlighedToken‑værdien vises kun én gang. Gem den straks. Procurize.AI gemmer kun en hash.
Udløbne tokensUdløbne tokens deaktiveres automatisk og kan ikke bruges. Generér et nyt token, hvis det er nødvendigt.

Fejlfinding#

ProblemLøsning
“Invalid API key”-fejlKontroller, at tokenet er kopieret korrekt (ingen ekstra mellemrum). Bekræft, at tokenet stadig er aktivt og ikke er udløbet.
Token virker ikke efter rollead ændringTokenets tilladelser opdateres, så de matcher brugerens aktuelle rolle. Hvis brugeren har mistet tilladelser, mister tokenet dem også.
Tabt tokenTilbagekald det tabte token og generér et nyt.
Rate‑limitingAPI‑rate‑begrænsninger gælder i henhold til din plan. Tjek X-RateLimit-*‑headere i svaret.

Relaterede emner#

til toppen
Vælg sprog