Autenticazione

Tutte le richieste API richiedono una chiave API valida passata come token Bearer.

Token Bearer

Autenticati includendo la tua chiave API nell'header Authorization di ogni richiesta:

http

Authorization: Bearer YOUR_API_KEY

La tua chiave API è una stringa lunga che inizia con ev_. Ad esempio:

http

Authorization: Bearer ev_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Dove trovare la tua chiave API

Accedi al tuo account su verimails.com/dashboard
Vai su Impostazioni → Chiavi API
Copia la tua chiave

⚠️

Tieni segreta la tua chiave API. Non inserirla mai in JavaScript lato client o in repository pubblici, e non condividerla con soggetti non affidabili. Se viene compromessa, rigenerala subito dalla dashboard.

Esempio di richiesta autenticata

bash

curl -X POST https://verimails.com/api/verify/single \
  -H "Authorization: Bearer ev_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"email": "test@example.com"}'

Errori di autenticazione

Se la chiave manca o non è valida, riceverai una risposta 401 Unauthorized :

json

{
  "error": "Unauthorized",
  "message": "Invalid or missing API key",
  "status_code": 401
}

ℹ️

Ti servono più chiavi API per ambienti o applicazioni diversi? Puoi generare chiavi aggiuntive dalla dashboard.