API‑token | Procurize.AI#

Skapa, hantera och använd API‑token för säker programmatisk åtkomst till ditt Procurize.AI‑arbetsområde.

Gäller för: Procurize.AI‑instrumentpanel → Inställningar → Token
Tillgängligt i: Business‑ och Enterprise‑planerna
Krävd roll: Säkerhetschef, Redaktör, Administratör eller Underhållare

Översikt#

API‑token möjliggör säker, programmatisk åtkomst till Procurize.AI‑plattformen. Du kan använda token för att integrera Procurize.AI med dina interna system, automatisera arbetsflöden eller bygga anpassade applikationer ovanpå plattformen.

Viktiga egenskaper:

Token ärver alla behörigheter från den användare som skapade dem
Token är organisations‑omfattande – du behöver inte ange org i API‑anrop
Obegränsat antal token kan skapas
Token kan ha utgångsdatum eller ställas in på att aldrig gå ut
Token kan deaktiveras och senare återaktiveras vid behov

🔒 Säkerhetsnotering: Procurize.AI lagrar inte token‑värdet – endast dess hash. Du måste kopiera och spara token omedelbart efter generering. Det kommer inte att visas igen.

Åtkomst till token‑hanteringspanelen#

Gå till sidan Instrumentpanel → API‑token.
Token‑hanteringspanelen visar dina personliga token som är kopplade till den aktuella organisationen.

API‑tokensida

Behörighet krävs: Endast användare med rollerna Security Manager, Editor, Admin eller Maintainer kan komma åt denna panel. För detaljerade rollbeskrivningar, se Permissions Overview .

Skapa en ny token#

Ange ett Namn för att identifiera tokenens syfte.
Välj en utgångsperiod:
- 1 månad
- 3 månader
- 1 år
- Ingen utgång (obegränsad giltighet)
Klicka på “Generera”.

Viktigt – Kopiera token omedelbart#

Efter generering visas token‑värdet en gång – kopiera det och lagra det säkert (t.ex. i en lösenordshanterare eller som en miljövariabel).

Ny API‑token

⚠️ Du kommer inte kunna se token‑värdet igen. Procurize.AI lagrar endast en säker hash för verifiering. Om du förlorar token måste du återkalla den och skapa en ny.

Hantera befintliga token#

Token‑panelen visar en lista över alla skapade token med deras:

Namn
Suffix
Skapandedatum
Utgångsdatum (eller “-”)
Status: Aktiv eller Inaktiv

Inaktivera / Återaktivera en token#

Inaktivera – inaktiverar token tillfälligt. Du kan återaktivera den senare vid behov.
Återaktivera – återställer en tidigare inaktiverad token till aktiv status.

💡 Inaktivering är användbart för att tillfälligt pausa integrationer utan att radera token.

Återkalla en token#

Återkalla – tar permanent bort token. Denna åtgärd kan inte ångras.
Om du förlorar en token, återkalla den omedelbart och skapa en ny.

Använda en API‑token#

Bas-URL & autentisering#

Parameter	Värde
Bas-URL	`https://api.procurize.com`
Autentiseringsmetod	API‑nyckel via header
Header	`X-API-Key: <YOUR_API_TOKEN>`

Exempel på förfrågan (cURL)#

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

🧠 Ingen organisations‑ID behövs – token är knuten till din organisation, så API:t löser kontexten automatiskt.

Viktiga säkerhets‑ och användningsregler#

Regel	Förklaring
Token‑behörigheter	Token har exakt samma behörigheter som den användare som skapade den. Om användarens roll ändras uppdateras token‑behörigheterna därefter.
Organisationsbindning	Token är knutna till skaparnas organisation. Du kan inte använda en token i flera organisationer.
Token‑synlighet	Token‑värdet visas endast en gång. Lagra det omedelbart. Procurize.AI lagrar endast en hash.
Utgångna token	Utgångna token inaktiveras automatiskt och kan inte användas. Skapa en ny token om det behövs.

Felsökning#

Problem	Lösning
“Invalid API key”‑fel	Kontrollera att token har kopierats korrekt (inga extra mellanslag). Verifiera att token fortfarande är aktiv och inte har gått ut.
Token fungerar inte efter rolländring	Token‑behörigheterna uppdateras för att matcha användarens nuvarande roll. Om användaren förlorade behörigheter förlorar token dem också.
Förlorad token	Återkalla den förlorade token och skapa en ny.
Rate limiting	API‑rate‑gränser gäller enligt din plan. Kontrollera `X-RateLimit-*`‑headers i svaret.

Relaterade ämnen#

Permissions Overview – detaljerade rollbeskrivningar
Pricing Plans – vilka planer som inkluderar API‑åtkomst
REST API Reference – detaljerad endpoint‑dokumentation