Kā izveidot ventic API atslēgu?

Integrācija ar ventic platformu prasa API atslēgu pieprasījumu autentifikācijai. Šīs atslēgas ir unikālas jūsu organizācijai un nodrošina drošu piekļuvi jūsu produktu katalogam un tirdzniecības pakalpojumiem.

Kā pārvaldīt API atslēgas:

1. Dodieties uz izstrādātāju paneli (Developer Dashboard)

Piesakieties savā ventic kontā un dodieties uz sadaļu Iestatījumi > Izstrādātāji (Settings > Developers). Tur atradīsiet cilni "API Keys".

2. Izveidojiet jaunu atslēgu

Lai izveidotu jaunu atslēgu:

1. Noklikšķiniet uz pogas "Create API Key".
2. Piešķiriet atslēgai aprakstošu nosaukumu (piemēram, "Ražošana - galvenais veikals" vai "Testēšana - Jānis Bērziņš").
3. Izvēlieties piekļuves tiesības (Scopes). Mēs iesakām piešķirt atslēgām tikai nepieciešamās tiesības (minimālo privilēģiju princips).
4. Noklikšķiniet uz pogas "Generate".

3. Atslēgas droša glabāšana

Pēc atslēgas izveides tā tiks parādīta jums tikai vienu reizi.

• Svarīgi: Nokopējiet atslēgu un glabājiet to drošā vietā (piemēram, paroļu pārvaldniekā vai savas organizācijas drošā key vault).
• Piezīme: Drošības apsvērumu dēļ ventic pēc loga aizvēršanas visu atslēgu vairs nerādīs.

4. Atslēgas izmantošana pieprasījumos

Visiem ventic API veiktajiem pieprasījumiem ir jāsatur API atslēga HTTP galvenē X-API-Key.

cURL piemērs:

curl -X GET "https://api.ventic.ai/v1/products" \
     -H "X-API-Key: jūsu_api_atslēga_šeit" \
     -H "Accept: application/json"

5. Atslēgu atjaunināšana un dzēšana

Ja jums ir aizdomas, ka atslēga ir noplūdusi, tā ir nekavējoties jāatceļ.

• Panelī izvēlieties dzēšamo atslēgu un noklikšķiniet uz pogas "Revoke" (Atcelt).
• Pēc atcelšanas visi ar šo atslēgu veiktie pieprasījumi tiks noraidīti.
• Izveidojiet jaunu atslēgu un atjauniniet integrācijas datus.

Labākā drošības prakse

• Nekad nepubliskojiet API atslēgas pirmkodā (piemēram, GitHub). Izmantojiet vides mainīgos.
• Izmantojiet atsevišķas atslēgas testēšanas un ražošanas vidēm.
• Regulāri pārbaudiet aktīvo atslēgu sarakstu un noņemiet tās, kuras vairs nav nepieciešamas.

Ja jums nepieciešama palīdzība integrācijā, sazinieties ar mūsu tehnisko atbalstu support@ventic.ai.