API Tokenid | Procurize.AI#
Loo, halda ja kasuta API tokenid turvalise programmeerimise juurdepääsu jaoks oma Procurize.AI tööruumis.
Kohaldub: Procurize.AI Töölaud → Seaded → Tokenid
Saadaval on: Business & Enterprise plaanid
Nõutav roll: Admin või Maintainer
Ülevaade#
API tokenid võimaldavad turvalist programmeerimist juurdepääsu Procurize.AI platvormile. Saad kasutada tokenid integratsioonide loomiseks oma sisemiste süsteemidega, töövoogude automatiseerimiseks või kohandatud rakenduste ehitamiseks platvormil põhinevalt.
Peamised omadused:
- Tokenid pärivad kõik õigused kasutajalt, kes need on loonud
- Tokenid on organisatsiooniulatus – pole vaja API päringutes
orgmäärata - Lõpmatu arv tokeneid saab genereerida
- Tokenitel võib olla aegumiskuupäev või need võivad olla määramata ajaliselt kehtivad
- Tokenid võivad olla deaktiveeritud ja vajadusel reaktiveeritud
🔒 Turvalisuse märkus: Procurize.AI ei salvesta tokeni väärtust – ainult selle räsi. Pead tokeni kohe genereerimisel kopeerima ja turvaliselt salvestama. See ei kuvata enam kordagi.
Tokenite Halduse Paneeli Avamine#
- Navigeeri Töölaud → Seaded → Tokenid vahekaardile.
- Tokenite halduse paneel näitab sinu isiklikke tokenid, mis on seotud praeguse organisatsiooniga.

Nõutav õigus: Ainult kasutajad, kellel on Admin või Maintainer roll, saavad sellele paneelile ligi. Täpsema rollide kirjelduse leiad lehelt Õiguste Ülevaade .
Uue Tokeni Loo#
Sisesta Nimi, et määrata tokeni otstarve.
Vali aegumisperiood:
- 1 kuu
- 3 kuud
- 1 aasta
- Pole aegumiskuupäeva (piiramatu kehtivus)
Klõpsa “Loo”.
Oluline – Kopeeri Token Koheselt#
Pärast genereerimist kuvatakse tokeni väärtust ainult üks kord – kopeeri see ja salvesta turvaliselt (nt paroolihalduris või keskkonnamuutujas).

⚠️ Sa ei saa tokeni väärtust enam kunagi vaadata. Procurize.AI salvestab ainult turvalise räsi kontrollimise eesmärgil. Kui kaotad tokeni, pead selle tühistama ja looma uue.
Olemasolevate Tokenite Halduse#
Tokenite paneel näitab loendit kõigist genereeritud tokenitest, mis sisaldavad:
- Nimi
- Lõpp
- Loomise kuupäev
- Aegumiskuupäev (või “-”)
- Staatus: Aktiivne või Mitteaktiivne
Deaktiveerimine / Reaktiveerimine#
- Deaktiveeri – ajutiselt keelab tokeni. Vajadusel saab selle hiljem taasaktiveerida.
- Reaktiveeri – taastab varem deaktiveeritud tokeni aktiivseks.
💡 Deaktiveerimine on kasulik integratsioonide ajutiseks peatamiseks ilma tokenit kustutamata.
Tokeni Tühistamine#
- Tühista – kustutab tokeni püsivalt. Selle tegevust ei saa tagasi võtta.
- Kui kaotad tokeni, tühista see kohe ja loo uus.
API Tokeni Kasutamine#
Baas-URL ja Autentimine#
| Parameeter | Väärtus |
|---|---|
| Baas-URL | https://api.procurize.com |
| Autentimise meetod | API key via header |
| Päis | X-API-Key: <YOUR_API_TOKEN> |
Näide Päringust (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 sinu organisatsiooniga, seega API tuvastab konteksti automaatselt.
Olulised Turvalisus- ja Kasutusreeglid#
| Reegel | Selgitus |
|---|---|
| Tokeni õigused | Tokenil on täpselt samad õigused, mis kasutajal, kes selle lõi. Kui kasutaja roll muutub, uuenevad tokeni õigused automaatselt. |
| Organisatsiooni sidumine | Tokenid on seotud loojate organisatsiooniga. Sa ei saa tokenit kasutada erinevate organisatsioonide vahel. |
| Tokeni nähtavus | Tokeni väärtust näidatakse ainult üks kord. Salvesta see kohe. Procurize.AI salvestab ainult räsi. |
| Aegunud tokenid | Aegunud tokenid des aktiveeritakse automaatselt ja neid ei saa kasutada. Vajadusel loo uus token. |
Probleemide Lahendamine#
| Probleem | Lahendus |
|---|---|
| “Invalid API key” viga | Kontrolli, et token on õigesti kopeeritud (ilma lisasõnadeta). Veendu, et token on endiselt aktiivne ja pole aegunud. |
| Token ei tööta pärast rolli muutmist | Tokeni õigused uuendatakse vastavalt kasutaja praegusele rollile. Kui kasutaja kaotas õigused, kaotab token ka need. |
| Kaotatud token | Tühista kaotatud token ja loo uus. |
| Kiiruse piirang | API kiiruse piiranguid kehtib vastavalt sinu plaanile. Kontrolli vastuses X-RateLimit-* päiseid. |
Seotud Teemad#
- Õiguste Ülevaade – detailne rollide kirjeldus
- Hinnaplaanid – millised plaanid sisaldavad API juurdepääsu
- REST API Viide – üksikasjalik endpointide dokumentatsioon
