Cum se generează o cheie API ventic?

O cheie API este necesară pentru a autentifica cererile de integrare cu platforma ventic. Aceste chei sunt unice pentru organizația dumneavoastră și oferă acces securizat la catalogul de produse și serviciile comerciale.

Iată cum să vă gestionați cheia API:

1. Accesați tabloul de bord pentru dezvoltatori

Conectați-vă la contul dumneavoastră ventic și navigați la secțiunea Settings > Developers. Acolo veți găsi o filă numită „API Keys”.

2. Creați o cheie nouă

Pentru a genera o cheie nouă:

1. Faceți clic pe butonul “Create API Key”.
2. Dați cheii un nume descriptiv (de exemplu, „Production - Main Store” sau „Testing - Andrei”).
3. Selectați sfera de permisiuni (Scopes). Vă recomandăm să acordați cheilor doar permisiunile necesare (principiul privilegiului minim).
4. Faceți clic pe “Generate”.

3. Salvați cheia în siguranță

După creare, cheia vă va fi afișată o singură dată.

• Important: Copiați cheia și salvați-o într-un loc sigur (de exemplu, un manager de parole sau un depozit securizat de chei din sistemul dumneavoastră).
• Notă: Din motive de securitate, ventic nu va mai afișa cheia completă după închiderea ferestrei.

4. Utilizarea cheii în cereri

Toate cererile trimise către interfața API ventic trebuie să includă cheia API în antetul HTTP X-API-Key.

Exemplu de utilizare cu cURL:

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

5. Rotirea și revocarea cheii

Dacă bănuiți că o cheie a fost compromisă, ar trebui să o revocați imediat.

• În panoul de control, selectați cheia pe care doriți să o eliminați și faceți clic pe “Revoke” (Revocare).
• După revocare, orice cerere care utilizează acea cheie va fi respinsă.
• Generați o cheie nouă și actualizați configurația sistemului dumneavoastră.

Recomandări de securitate

• Nu publicați niciodată cheile API în codul sursă (de exemplu, pe GitHub). Utilizați variabile de mediu (environment variables).
• Utilizați chei separate pentru mediile de testare (testing) și producție (production).
• Revizuiți periodic lista cheilor active și eliminați-le pe cele care nu mai sunt utilizate.

Dacă aveți nevoie de ajutor pentru integrare, contactați echipa noastră tehnică la support@ventic.ai.