Autenticazione

Tutte le richieste API richiedono autenticazione tramite Bearer token nell'header Authorization.

Ottenere una chiave API

  1. 1

    Creare un account

    Registratevi sulla nostra pagina sviluppatore. Riceverete una prova gratuita di 14 giorni con accesso completo all'API.

  2. 2

    Generare la vostra chiave API

    Nel vostro dashboard, andate su Impostazioni → Chiavi API per creare una nuova chiave.

  3. 3

    Conservate la vostra chiave in modo sicuro

    La vostra chiave API viene mostrata solo una volta. Conservatela in un luogo sicuro come una variabile d'ambiente.

Utilizzare la vostra chiave API

Includete la vostra chiave API come Bearer token nell'header Authorization di ogni richiesta:

curl -H "Authorization: Bearer YOUR_API_KEY" \
     https://grapeminds.eu/api/public/v1/wines

Esempio con diverse lingue

Usate l'header Accept-Language per ricevere le descrizioni nella vostra lingua preferita:

# German
curl -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Accept-Language: de" \
     "https://grapeminds.eu/api/public/v1/wines/9146"

# French
curl -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Accept-Language: fr" \
     "https://grapeminds.eu/api/public/v1/wines/9146"

Errori di autenticazione

401 Unauthenticated

La chiave API è mancante o non valida. Assicuratevi di includere un Bearer token valido.

{ "message": "Unauthenticated." }
403 Forbidden

La vostra chiave API non ha il permesso di accedere a questa risorsa. Gli endpoint Enterprise richiedono un abbonamento Enterprise.

Best practice di sicurezza

Non esponete mai la vostra chiave API nel codice lato client o nei repository pubblici.

Usate variabili d'ambiente per conservare la vostra chiave API.

Ruotate la vostra chiave API periodicamente. Potete farlo nel vostro dashboard sotto Impostazioni → Chiavi API.

Usate sempre HTTPS per le richieste API.

Pronti per iniziare?

Provate l'API Vini grapeminds gratuitamente per 14 giorni.

Registrati come cliente API