Skip to main content
API v1

Documentazione API

Riferimento completo per le API REST di VerifyDest

API Validazione IBAN
Valida codici IBAN (International Bank Account Number) con ricerca banca e valutazione rischio
POST /api/v1/iban
API Validazione Wallet
Valida indirizzi wallet crypto con rilevamento chain e punteggio rischio
POST /api/v1/wallet
Autenticazione
Tutti gli endpoint API richiedono autenticazione tramite API key. Puoi creare e gestire le tue API key nella dashboard.

Metodi di Autenticazione

1. Bearer Token (Consigliato)
Authorization: Bearer vd_xxx...
2. Header X-API-Key
X-API-Key: vd_xxx...
Ottieni la tua API key
URL Base
https://verifydest.io/api/v1
Esempi
curl -X POST https://verifydest.io/api/v1/iban \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"iban": "IT60X0542811101000000123456"}'
Limiti di Utilizzo
I limiti API si basano sul tuo piano di abbonamento. I limiti si resettano giornalmente o mensilmente a seconda del tier.
TierAPI AccessLimit
Free
No
-
Basic
Yes
100/day
Pro
Yes
500/day
Business
Yes
2,500/day
Enterprise
Yes
Unlimited

Header Risposta

X-RateLimit-Limit: Il tuo limite massimo
X-RateLimit-Remaining: Richieste rimanenti nella finestra corrente
X-RateLimit-Reset: Timestamp Unix di reset del limite
Codici Errore
Codice ErroreStato HTTPDescrizione
MISSING_KEY
401
No API key provided
INVALID_KEY
401
Invalid or revoked API key
EXPIRED_KEY
401
API key has expired
BLOCKED_KEY
403
Too many failed attempts
IP_NOT_ALLOWED
403
IP not in whitelist
RATE_LIMITED
429
Rate limit exceeded
NO_API_ACCESS
403
Plan doesn't include API
PERMISSION_DENIED
403
Key lacks permission