Kuidas luua ventic-i API-võti?

Integreerimine ventic-i platvormiga nõuab päringute autentimiseks API-võtit. Need võtmed on teie organisatsiooni jaoks unikaalsed ja pakuvad turvalist juurdepääsu teie tootekataloogile ja kaubandusteenustele.

Kuidas API-võtmeid hallata:

1. Minge arendajate paneelile (Developer Dashboard)

Logige sisse oma ventic-i kontole ja navigeerige jaotisesse Seaded > Arendajad (Settings > Developers). Sealt leiate vahekaardi "API Keys".

2. Looge uus võti

Uue võtme loomiseks tehke järgmist:

1. Klõpsake nupul "Create API Key".
2. Andke võtmele kirjeldav nimi (nt "Tootmine - peakauplus" või "Testimine - Matti Maakas").
3. Valige õiguste ulatus (Scopes). Soovitame anda võtmetele ainult vajalikud õigused (vähimate õiguste põhimõte).
4. Klõpsake nupul "Generate".

3. Võtme turvaline hoiustamine

Pärast võtme loomist kuvatakse see teile ainult üks kord.

• Tähtis: Kopeerige võti ja hoidke seda turvalises kohas (nt paroolihalduris või oma organisatsiooni turvalises key vaultis).
• Märkus: Turvakaalutlustel ventic pärast akna sulgemist kogu võtit uuesti ei näita.

4. Võtme kasutamine päringutes

Kõik ventic-i API-le tehtavad päringud peavad sisaldama API-võtit HTTP-päises X-API-Key.

cURL-i näide:

curl -X GET "https://api.ventic.ai/v1/products" \
     -H "X-API-Key: teie_api_võti_siia" \
     -H "Accept: application/json"

5. Võtmete uuendamine ja kustutamine

Kui kahtlustate, at võti on lekkinud, tuleb see kohe tühistada.

• Valige paneelilt kustutatav võti ja klõpsake nupul "Revoke" (Tühista).
• Pärast tühistamist lükatakse kõik selle võtmega tehtud päringud tagasi.
• Looge uus võti ja uuendage oma integratsiooni andmeid.

Parimad turvatavad

• Mitte kunagi ärge avaldage API-võtmeid lähtekoodis (nt GitHubis). Kasutage keskkonnamuutujaid.
• Kasutage eraldi võtmeid testimis- ja tootmiskeskkondades.
• Kontrollige regulaarselt aktiivsete võtmete loendit ja eemaldage need, mida enam ei vajata.

Kui vajate abi integreerimisel, võtke ühendust meie tehnilise toega aadressil support@ventic.ai.