API‑tokens | Procurize.AI#

Generer, 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: Security Manager, Editor, 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 tilpassede applikationer oven på platformen.

Vigtige egenskaber:

  • Tokens arver alle rettigheder fra den bruger, der har oprettet dem
  • Tokens er organisation‑omfattende – du behøver ikke angive org i API‑kald
  • Der kan genereres et ubegrænset antal tokens
  • Tokens kan have udløbsdatoer eller sættes til at aldrig udløbe
  • Tokens kan deaktiveres og senere genaktiveres efter behov

🔒 Sikkerhedsnote: Procurize.AI gemmer ikke 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 åbnes Token‑administrationspanelet#

  1. Gå til siden DashboardAPI‑tokens.
  2. Token‑administrationspanelet viser dine personlige tokens, der er knyttet til den aktuelle organisation.

API‑tokens side

Påkrævet rettighed: Kun brugere med rollerne Security Manager, Editor, Admin eller Maintainer kan få adgang til dette panel. For detaljerede rolleaddefinitioner, se Permissions Overview .

Oprettelse af et nyt token#

  1. Indtast et Navn for at identificere tokenets 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å “Generate”.

Vigtigt – Kopier tokenet med det samme#

Efter generering vises token‑værdien é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 oprette 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 / Genaktivere et token#

  • Deaktivere – deaktiverer tokenet midlertidigt. Du kan genaktivere det senere, når det er nødvendigt.
  • Genaktivere – bringer et tidligere deaktiveret token tilbage til aktiv status.

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

Tilbagekalde et token#

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

Brug af et API‑token#

Base‑URL & Autentifikation#

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

Eksempel‑anmodning (cURL)#

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

🧠 Ingen organisations‑ID nødvendig – tokenet er bundet til din organisation, så API’et automatisk løser konteksten.

Vigtige sikkerheds‑ og brugsregler#

RegelForklaring
Token‑rettighederTokenet har præcis de samme rettigheder som brugeren, der oprettede det. Hvis brugerens rolle ændres, opdateres tokenets rettigheder tilsvarende.
OrganisationsbindingTokens er knyttet til den organisation, 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 med det samme. Procurize.AI gemmer kun en hash.
Udløbne tokensUdløbne tokens deaktiveres automatisk og kan ikke bruges. Opret 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 rolleændringTokenets rettigheder opdateres til at matche brugerens aktuelle rolle. Hvis brugeren mistede rettigheder, mister tokenet dem også.
Mistet tokenTilbagekald det mistede token og opret et nyt.
Rate limitingAPI‑rate‑limits gælder i henhold til din plan. Tjek X-RateLimit-*‑headere i svaret.

Relaterede emner#

til toppen
Vælg sprog