VerifNow

Docs

Documentation

Intégrez VerifNow à votre application en quelques minutes.

Commencez gratuitement — sans carte bancaireContact

Démarrage rapide

Intégrez VerifNow à votre application en quelques minutes.

  • Obtenez une clé API et authentifiez-vous avec l'en-tête X-API-KEY.
  • Envoyez des payloads JSON via HTTPS ; les réponses incluent des données normalisées.
  • Utilisez le tableau de bord client pour suivre les statistiques des validations (utilisation, erreurs, latence).

Référence API

Consultez la documentation complète de l'API avec tous les endpoints, paramètres et exemples de réponses.

Voir la documentation API →

SDK Java (Spring)

Utilisez notre SDK Java pour intégrer facilement VerifNow dans vos applications Spring Boot.

Voir sur GitHub →

Validation e-mail avancée

Augmentez les conversions et protégez votre réputation d'envoi grâce à des signaux de délivrabilité fiables.

Payload de réponse (validation e-mail)

Le bloc emailDetails met en avant des vérifications à fort impact pour accepter les bons emails et bloquer les risques.

{
  "valid": true,
  "message": "Valid email address",
  "normalizedValue": "jerome@verifnow.io",
  "originalValue": "jerome@verifnow.io",
  "validationLevel": "ADVANCED",
  "emailDetails": {
    "signals": {
      "syntax_valid": true,
      "mx_valid": true,
      "typo_detected": false,
      "disposable": false,
      "role_based": false,
      "free_provider": false,
      "mx_provider": "custom",
      "mx_quality_score": 0.7
    },
    "risk_score": 0.0,
    "deliverability": "DELIVERABLE",
    "applied_level": "ADVANCED"
  }
}

Signaux qui guident vos décisions

  • syntax_valid et mx_valid confirment qu'un email peut recevoir du courrier.
  • typo_detected et disposable réduisent les rebonds et les faux comptes.
  • role_based et free_provider qualifient vos leads B2B.
  • mx_provider et mx_quality_score évaluent la fiabilité du fournisseur.
  • risk_score et deliverability donnent un signal décisionnel immédiat.
  • validationLevel et applied_level montrent les contrôles demandés et appliqués.

cURL

cURL
curl -X POST https://api.verifnow.io/v1/validate/email \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: sk_test_your_key" \
  -d '{"value":"hello@example.com"}'

Testez l'API directement avec cURL. L'authentification se fait via l'en-tête X-API-KEY.

Java (Spring)

SDK Java (Spring)

Installation

<!-- Maven -->
<dependency>
  <groupId>io.verifnow</groupId>
  <artifactId>verifnow-spring-boot-starter</artifactId>
  <version>2.0.1</version>
</dependency>

// Gradle (Kotlin DSL)
dependencies {
  implementation("io.verifnow:verifnow-spring-boot-starter:2.0.1")
}

// Gradle (Groovy)
// implementation 'io.verifnow:verifnow-spring-boot-starter:2.0.1'

Exemple d'utilisation

@Entity
public class User {

   @VerifNowEmail
   private String email;

   @VerifNowPhone
   private String phone;

   // getters and setters
}

Configuration

Définissez votre clé API (obligatoire) et l'URL de base optionnelle dans application.properties (verifnow.api.apiKey, verifnow.api.baseUrl) ou via la variable VERIFNOW_API_KEY :

# application.properties
verifnow.api.apiKey={VERIFNOW_API_KEY{'}'}
verifnow.api.baseUrl=https://api.verifnow.io
# application.yml
verifnow:
  api:
    apiKey: {VERIFNOW_API_KEY{'}'}
    baseUrl: https://api.verifnow.io

Le starter lit la variable d'environnement VERIFNOW_API_KEY ou la propriété verifnow.api.apiKey. Seule la apiKey est requise ; baseUrl est optionnelle. Ne commitez pas les secrets dans le dépôt.

Voir les exemples et la documentation complète sur GitHub.

verifnowio/verifnow-spring →

Suivi d'utilisation dans le dashboard client

Suivez les validations dans le temps, filtrez par endpoint ou environnement, et détectez rapidement les problèmes d'intégration après vos déploiements.

Comment ça marche

  1. Utilisez votre clé API côté backend (ne l'exposez jamais dans le navigateur).
  2. Envoyez vos requêtes de validation à VerifNow (email, téléphone, adresse, champs custom).
  3. Consultez l'usage, les erreurs et la latence dans le dashboard pour garder le contrôle sur les quotas et la fiabilité.

Exemples

Gestion des clés API

Créez, faites tourner et révoquez vos clés API depuis le dashboard client.

Toucher pour agrandir

Statistiques d'utilisation

Suivez les requêtes, les tendances et les métriques clés dans le temps.

Toucher pour agrandir

Performance & Fiabilité

99%+

Précision

Détection de formats invalides, normalisation et signaux anti-fraude pour réduire les faux positifs.

99.9%

Disponibilité

Pensé pour la production : monitoring, alertes et déploiements sans interruption.

< 50 ms

Latence

Temps de réponse typique (p50) sur la majorité des validations.

Les métriques sont indicatives et peuvent varier selon l'endpoint, la région et la qualité des données envoyées.

Documentation — VerifNow | VerifNow API