API Tokendid | Procurize.AI#
Loo, halda ja kasuta API tokeneid turvaliseks programmeeritud juurdepääsuks teie Procurize.AI tööruumis.
Kehtib: Procurize.AI armatuurlaud → Seaded → Tokenid
Saadaval: Business & Enterprise plaanidel
Nõutav roll: Turvalisuse haldur, Redaktor, Administraator või Hooldaja
Ülevaade#
API tokenid võimaldavad turvalist programmeeritud juurdepääsu Procurize.AI platvormile. Saate tokenite abil integreerida Procurize.AI oma sisemiste süsteemidega, automatiseerida töövooge või luua platvormi põhjal kohandatud rakendusi.
Peamised omadused:
- Tokenid pärivad kõik õigused kasutajalt, kes need lõi
- Tokenid on organisatsiooni ulatuses – pole vaja API päringutes
org-i määrata - Piiramatu arv tokeneid saab luua
- Tokenitel võib olla aegumiskuupäev või need võivad olla määratud lõpmatuks
- Tokenid võivad olla deaktiveeritud ja vajadusel reaktiveeritud
🔒 Turvalisuse märkus: Procurize.AI ei salvesta tokeni väärtust – ainult selle räsi. Peate tokeni koopia kohe genereerimise järel kopeerima ja turvaliselt salvestama. See ei kuvata enam kunagi.
Tokenite haldamise paneeli avamine#
- Navigeerige Armatuurlauale → API Tokenite lehele.
- Tokenite haldamise paneel kuvab teie isiklikud tokenid, mis on seotud praeguse organisatsiooniga.

Nõutav luba: Ainult kasutajad, kellel on rollid Turvalisuse haldur, Redaktor, Admin või Hooldaja, saavad sellele paneelile juurde pääseda. Täpsemate rollide kirjelduste jaoks vaadake Õiguste ülevaade .
Uue tokeni loomine#
Sisestage Nimi, et tuvastada tokeni eesmärk.
Valige aegumisperiood:
- 1 kuu
- 3 kuud
- 1 aasta
- Aegumatu (piiramatu kehtivus)
Klõpsake “Loo”.
Oluline – kopeerige token kohe#
Pärast genereerimist kuvatakse tokeni väärtus ainult üks kord – kopeerige see ja salvestage turvaliselt (nt paroolihalduris või keskkonnamuutujana).

⚠️ Te ei saa tokeni väärtust enam vaadata. Procurize.AI salvestab ainult turvalise räsi verifitseerimiseks. Kui token kaotate, peate selle tühistama ja looma uue.
Olemasolevate tokenite haldamine#
Tokenite paneel kuvab loendi kõigist genereeritud tokenitest koos:
- Nimi
- Järelliide
- Loomise kuupäev
- Aegumiskuupäev (või “-”)
- Staatus: Aktiivne või Mitteaktiivne
Tokeni deaktiveerimine / reaktiveerimine#
- Deaktiveeri – keelab tokeni ajutiselt. Vajadusel saate selle hiljem reaktiveerida.
- Reaktiveeri – taastab varem deaktiveeritud tokeni aktiivseks.
💡 Deaktiveerimine on kasulik ajutise integratsioonide peatamiseks ilma tokenit kustutamata.
Tokeni tühistamine#
- Tühista – kustutab tokeni jäädavalt. Seda toimingut ei saa tagasi võtta.
- Kui token kaotate, tühistage see kohe ja looge uus.
API tokeni kasutamine#
Baas-URL ja autentimine#
| Parameeter | Väärtus |
|---|---|
| Baas-URL | https://api.procurize.com |
| Autentimismeetod | API võti päise kaudu |
| Päis | X-API-Key: <YOUR_API_TOKEN> |
Näidisrequest (cURL)#
curl -X GET "https://api.procurize.com/v1/documents" \
-H "X-API-Key: YOUR_API_TOKEN"
🧠 Organisatsiooni ID-d pole vaja – token on seotud teie organisatsiooniga, seega määrab API konteksti automaatselt.
Olulised turva‑ ja kasutusreeglid#
| Reegel | Selgitus |
|---|---|
| Tokeni õigused | Tokenil on täpselt samad õigused kui kasutajal, kes selle lõi. Kui kasutaja roll muutub, uuenevad tokeni õigused vastavalt. |
| Organisatsiooni sidumine | Tokenid on seotud loojate organisatsiooniga. Tokenit ei saa kasutada mitme organisatsiooni vahel. |
| Tokeni nähtavus | Tokeni väärtus kuvatakse ainult üks kord. Salvestage see kohe. Procurize.AI salvestab ainult räsi. |
| Aegunud tokenid | Aegunud tokenid deaktiveeritakse automaatselt ja neid ei saa kasutada. Vajadusel looge uus token. |
Veaotsing#
| Probleem | Lahendus |
|---|---|
| “Invalid API key” viga | Kontrollige, et token on õigesti kopeeritud (ilma lisatühikuteta). Veenduge, et token on endiselt aktiivne ja ei ole aegunud. |
| Token ei tööta pärast rolli muutmist | Tokeni õigused uuenevad vastavalt kasutaja praegusele rollile. Kui kasutaja kaotas õigused, kaotab token ka need. |
| Kaotatud token | Tühistage kaotatud token ja looge uus. |
| Kiiruse piirang | API kiiruse piirangud kehtivad vastavalt teie plaanile. Kontrollige vastuses X-RateLimit-* päiseid. |
Seotud teemad#
- Õiguste ülevaade – üksikasjalikud rollide kirjeldused
- Hinnaplaanid – millised plaanid sisaldavad API juurdepääsu
- REST API viide – üksikasjalik endpointide dokumentatsioon
