Environnements & Configuration

Endpoints disponibles

Environnement	URL	Description
Production	https://api.yeswecheck.fr/v2	Données réelles, crédits consommés
Local	http://localhost:3000/v2	Votre instance locale

Pas d'environnement sandbox

YesWeCheck n'a pas d'environnement sandbox séparé. Pour tester sans consommer de crédits, n'activez pas le paramètre smtp: true — les checks syntaxe/DNS/disposable sont gratuits.

Configuration recommandée

Node.js / TypeScript

// config/yeswecheck.ts
export const YWC_CONFIG = {
  baseUrl: process.env.YESWECHECK_API_URL ?? 'https://api.yeswecheck.fr/v2',
  apiKey: process.env.YESWECHECK_API_KEY!,
  timeout: 10_000, // 10s
};

Python

# config.py
import os

YWC_BASE_URL = os.getenv("YESWECHECK_API_URL", "https://api.yeswecheck.fr/v2")
YWC_API_KEY = os.environ["YESWECHECK_API_KEY"]

.env

# .env (ne pas committer !)
YESWECHECK_API_URL=https://api.yeswecheck.fr/v2
YESWECHECK_API_KEY=ywc_live_xxxxx

CORS

L'API YesWeCheck accepte des requêtes de :

• https://yeswecheck.fr et sous-domaines
• http://localhost:3000 et :3001, :5173

Le endpoint /v2/email/validate accepte toutes les origines (pour les widgets), mais applique la restriction allowedDomains de l'API Key au niveau applicatif.

Timeouts recommandés

Endpoint	Timeout recommandé
/email/validate (sans SMTP)	5s
/email/validate (avec SMTP)	15-30s
/batch/upload	60s
/batch/{id}/status	5s
Tous les autres	10s