API DNS · X402 · PROTOTYPE TESTNET

Le DNS,
prêt pour
vos scripts.

Une réponse JSON pour les enregistrements DNS et la présence des politiques email d’un domaine. Un paiement x402 par analyse.

Faire un premier appel Voir la réponse

0,01 USDC de test par analyse · Base Sepolia uniquement

UNE REQUÊTE. UN DIAGNOSTIC.01 / 03

AMXTXTAAAANSCAA

example.com→ application/json

PARCOURS X402

402Paiement demandé

200Diagnostic retourné

01 — LE PÉRIMÈTRE

Les signaux utiles.
Dans un format simple.

Pour intégrer un premier diagnostic à un script, un outil interne ou un agent. Les données restent explicites : pas de score opaque.

Enregistrements DNS

Interrogation des résolveurs publics, sans connexion au serveur du domaine analysé.

AAAAAMXNSCAATXT

Présence SPF et DMARC

Politiques présentes, absentes ou multiples. Les erreurs de résolution restent distinctes d’une absence d’enregistrement.

Des constats, sans score.

Une réponse JSON

Domaine normalisé, horodatage, résultats DNS, TTL disponibles, état du cache et limites de l’analyse.

GET /v1/domain/check

02 — LA RÉPONSE

Lisible pour vous.
Exploitable par
votre code.

Une structure qui sépare les résultats DNS, les constats email et les limites du diagnostic.

Extrait illustratif, données fictives.
Cette page n’exécute pas d’analyse et ne déclenche aucun paiement.

Explorer le schéma complet

response.json · extrait

{
  "domain": "example.com",
  "status": "complete",
  "cached": false,
  "email": {
    "spf": {
      "status": "present",
      "records": ["v=spf1 -all"]
    },
    "dmarc": {
      "status": "absent",
      "records": []
    }
  }
}

Exemple de structure · réponse abrégée

DES LIMITES EXPLICITES

Un diagnostic DNS.
Un périmètre précis.

La présence SPF et DMARC est détectée ; leur validité complète et la délivrabilité email ne sont pas évaluées.

DMARC est recherché au domaine exact, sans recherche au domaine organisationnel.

Le service ne vérifie ni TLS, ni réputation, ni sécurité globale du domaine. Une erreur DNS est signalée comme telle.

03 — À VOUS DE TESTER

Du premier appel
au premier paiement.

0,01 USDC

de test / analyse
Base Sepolia · chain ID 84532

Voir le challenge

Sans paiement, la route d’analyse renvoie HTTP 402 avec les conditions dans l’en-tête PAYMENT-REQUIRED.

curl -i \
  'https://api.x4-02.fr/v1/domain/check?domain=example.com'

Vérifier uniquement le service : /health ↗ (gratuit).

Préparer le client Python

Téléchargez le client et installez le SDK x402. Sa vérification initiale ne demande aucune clé et ne paie rien.

python3 -m venv .venv
source .venv/bin/activate
pip install 'x402[evm]==2.26.0' web3
python client.py

Télécharger client.py Guide GitHub

Payer en testnet

Approvisionnez un portefeuille dédié en USDC de test sur Base Sepolia via le faucet Circle ↗. Lancez ensuite :

python client.py --pay

Le client demande la clé privée sans l’afficher ni l’enregistrer. Utilisez exclusivement un portefeuille de test.

Une signature encadrée.

Le client vérifie le réseau, le contrat USDC, le destinataire et le montant avant de signer. Il contrôle le règlement on-chain et le refus de réutilisation. En cas d’erreur, aucun nouvel essai de paiement automatique.

LES DÉTAILS QUI COMPTENT

Avant de
brancher votre code.

Est-ce prêt pour des paiements réels ?

Non. Le service accepte uniquement Base Sepolia (eip155:84532) et des USDC de test. Le parcours complet de paiement et le refus de réutilisation ont été testés, mais cela ne constitue pas une garantie de disponibilité ou un audit de sécurité.

Une clé API est-elle nécessaire ?

Aucune clé API n’est nécessaire. L’analyse est protégée par x402. Une autorisation de paiement est nécessaire pour obtenir le diagnostic ; la route /health reste gratuite.

Quels sont les quotas du prototype ?

Avant paiement : 60 requêtes par minute et par IP, avec 16 requêtes actives au maximum. Après validation x402 : 30 requêtes par minute et par IP, avec huit analyses simultanées au maximum. Les limites sont en mémoire, sur un seul processus, et repartent à zéro au redémarrage. Les clients derrière une même IP publique partagent leur quota.

Les réponses peuvent-elles venir du cache ?

Oui. Les résultats complets peuvent être conservés au plus 60 secondes, sans dépasser le plus petit TTL DNS positif. Le champ cached l’indique. Une réponse issue du cache reste soumise au paiement par appel.

Ce site collecte-t-il ma clé privée ?

Non. Cette page ne connecte aucun portefeuille et ne demande aucun secret. Le client Python s’exécute sur votre machine et demande une clé uniquement avec --pay. Ne partagez jamais votre clé avec un site ou dans un message.

Le DNS,prêt pourvos scripts.

Les signaux utiles.Dans un format simple.