API de données contextuelles et de validation téléphoniques

Catégorie Sécurité

Points de terminaison 2

Fonctionnalités clés 7

Foire aux questions 6

Signaux de confiance avant intégration

Une documentation transparente, des requêtes authentifiées et des détails de fiabilité visibles facilitent l’évaluation de DomScan avant mise en production.

En direct État du service

Vérifiez l’état du service en direct et les réponses d’échec documentées avant de procéder à l’intégration.

OpenAPI Artefacts API

OpenAPI, Swagger, Postman, CLI, SDK et liens MCP sont accessibles en un clic.

Clés API Accès protégé

Les endpoints authentifiés utilisent des clés API avec des coûts en crédits clairs avant l’appel.

10,000 Quota gratuit

Commencez avec 10 000 crédits mensuels et passez à l’offre supérieure seulement quand l’usage augmente.

Ce que cette API vous aide à livrer

Utilisez cette page comme brief de production : endpoints, exemples, structure de réponse et éléments de workflow pour intégrer DomScan à votre produit.

Workflows produit

Intégrez vérifications de domaines, intelligence DNS, signaux de risque ou enrichissement dans l’onboarding, la recherche et les outils internes.

Automatisation analyste

Remplacez les recherches manuelles répétées par des tâches planifiées, des alertes et des étapes d’enquête reproductibles.

Données JSON propres

Utilisez des champs prévisibles, des codes d’état documentés et des coûts en crédits au lieu de scraper des pages fournisseur.

IA et opérations

Alimentez agents, tableaux de bord, playbooks SOAR et CRMs via OpenAPI, SDK, Postman ou MCP.

Flux d’intégration

Un parcours simple de la première requête à un usage répétable en production.

Authentifier une fois

Envoyez votre clé API avec l’en-tête documenté et gardez des requêtes cohérentes entre services.

Interroger avec les exemples

Commencez par les exemples curl et HTTP, puis mappez les paramètres dans le code de votre application.

Exploiter et surveiller

Utilisez codes d’état, coûts en crédits et champs de réponse pour construire retries, logs et alertes.

Kit développeur

Passez de cette page aux docs lisibles par machine, collections de requêtes, SDKs ou outils d’agents.

Schéma OpenAPI

Générez des clients ou inspectez chaque forme de requête et de réponse.

Collection Postman

Importez des requêtes prêtes pour les tests manuels et le transfert à l’équipe.

SDKs et CLI

Utilisez des packages maintenus et des workflows en ligne de commande au lieu d’écrire du boilerplate.

Intégration MCP

Exposez l’intelligence de domaines aux agents IA et aux assistants internes.

Carte des paramètres et réponses

Parcourez les entrées, champs de sortie et codes d’état avant de connecter l’endpoint à votre client.

Paramètres de requête

Paramètre

phonedefault_countryexpected_countrydialing_from_countrylanguagephones

Champs de réponse

Exemple de Réponse

inputnormalized_inputkindvalidpossiblestatusrecommendationvalidation_levelreasonwarningsnumbernumber.e164

Couverture des statuts

Codes de Statut HTTP

200400401402429500502503504

Points de terminaison

POST /v1/phone/validate

Crédits: 1Authentification: Authentification requise

phonedefault_countryexpected_countrydialing_from_countrylanguage

POST /v1/phone/validate/bulk

Crédits: 1Authentification: Authentification requise

phonesdefault_countryexpected_countrydialing_from_countrylanguage

Signaux de confiance avant intégration

Une documentation transparente, des requêtes authentifiées et des détails de fiabilité visibles facilitent l’évaluation de DomScan avant mise en production.

État du service Artefacts API

OpenAPI, Swagger, Postman, CLI, SDK et liens MCP sont accessibles en un clic.

Clés API Accès protégé

Les endpoints authentifiés utilisent des clés API avec des coûts en crédits clairs avant l’appel.

Quota gratuit Inscrivez-vous Gratuitement

Commencez avec 10 000 crédits mensuels et passez à l’offre supérieure seulement quand l’usage augmente.

Actif Exemple de Requête

Commencez par les exemples curl et HTTP, puis mappez les paramètres dans le code de votre application.

Fonctionnalités clés

Validation stricte du plan de numérotation

Vérifiez la longueur et la structure des chiffres à partir des métadonnées complètes du plan de numérotation, pas seulement la longueur.

Formats normalisés

Obtenez les formats E.164, international, national et RFC 3966, y compris les postes analysés.

Possible ou valide

Distinguez les numéros dont la longueur est plausible des plages reconnues par le plan de numérotation.

Type de numéro et informations sur le préfixe

Identifiez le type de numéro, la localisation selon le plan de numérotation, les fuseaux horaires possibles, l’opérateur attributaire initial du préfixe et la prise en charge de la portabilité lorsque les métadonnées le permettent.

Numérotation et numéros courts selon le pays

Analysez les numéros nationaux avec un pays, générez les formats de numérotation propres au pays d’origine et reconnaissez les numéros courts régionaux et les numéros d’urgence.

Validation groupée

Validez jusqu’à 100 numéros par requête avec un résultat individuel pour chaque entrée.

Sources hors ligne et attributions officielles

Utilisez des métadonnées hors ligne et des instantanés publics de régulateurs sur l’infrastructure de DomScan. Les résultats correspondants indiquent la source, la licence, la date de mise à jour et le contexte de l’attribution initiale.

Exemple de Requête

POST /v1/phone/validate bash

curl -X POST https://domscan.net/v1/phone/validate \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"phone":"+34 612 345 678","expected_country":"ES","dialing_from_country":"US","language":"en"}'

Exemple de Réponse

200 OK json

{
  "input": "+34 612 345 678",
  "normalized_input": "+34 612 345 678",
  "kind": "phone_number",
  "valid": true,
  "possible": true,
  "status": "valid",
  "recommendation": "accept",
  "validation_level": "numbering_plan",
  "reason": null,
  "warnings": [],
  "number": {
    "e164": "+34612345678",
    "international": "+34 612 34 56 78",
    "national": "612 34 56 78",
    "rfc3966": "tel:+34612345678",
    "national_number": "612345678",
    "extension": null,
    "country": "ES",
    "country_name": "Spain",
    "country_calling_code": "34",
    "possible_countries": ["ES"],
    "country_match": true,
    "type": "mobile",
    "non_geographic": false
  },
  "intelligence": {
    "status": "available",
    "kind": "phone_number",
    "coverage": {
      "country": "ES",
      "level": "official_allocation_match",
      "global_numbering_metadata": true,
      "official_snapshot_available": true,
      "official_allocation_match": true,
      "official_source_ids": ["cnmc"],
      "matching_source_ids": ["cnmc"],
      "current_carrier_lookup": false
    },
    "location": {
      "country_name": "Spain",
      "country": "ES",
      "granularity": "country",
      "current_physical_location": false
    },
    "possible_time_zones": {
      "values": ["Europe/Madrid"],
      "current_location": false,
      "inference": "number_prefix"
    },
    "original_prefix_carrier": {
      "name": "FOOTBALLERISTA MOBILE SPAIN, S.A. UNIPERSONAL",
      "source_id": "cnmc",
      "evidence": "official_allocation_record",
      "current_carrier": false,
      "portability_may_change_carrier": true
    },
    "portability": {
      "region_supported": true,
      "current_port_checked": false
    },
    "dialing": {
      "from_country": "US",
      "international": "011 34 612 34 56 78",
      "internationally_diallable": true
    },
    "regulator_allocations": [{
      "authority": "CNMC",
      "category": "mobile",
      "status": "assigned",
      "original_assignee": "FOOTBALLERISTA MOBILE SPAIN, S.A. UNIPERSONAL",
      "assigned_on": "2023-11-03",
      "current_operator": false,
      "individual_number_assignment_checked": false
    }],
    "sources": [{
      "id": "google_libphonenumber",
      "name": "Google libphonenumber metadata",
      "license": "Apache-2.0"
    }, {
      "id": "cnmc",
      "name": "Comisión Nacional de los Mercados y la Competencia (CNMC)",
      "type": "official_regulator_snapshot"
    }]
  },
  "live_checks": {
    "assignment": "not_checked",
    "reachability": "not_checked",
    "current_carrier": "not_checked",
    "subscriber_identity": "not_checked",
    "porting": "not_checked"
  },
  "privacy": {
    "upstream_requests": 0,
    "telecom_provider_queried": false,
    "persisted": false,
    "domscan_edge_relay_used": true,
    "third_party_requests": 0
  },
  "limitations": [
    "NUMBERING_PLAN_ONLY",
    "DOES_NOT_PROVE_ASSIGNMENT",
    "NO_LIVE_TELECOM_CHECKS"
  ],
  "credits_used": 1
}

Foire aux questions

Que signifie un numéro de téléphone valide ?

Valide signifie que le numéro correspond à la longueur et à la structure de chiffres documentées d’une plage reconnue du plan de numérotation. Cela ne signifie pas que le numéro est attribué à un abonné.

La validation prouve-t-elle que le numéro est actif ou joignable ?

Non. La validation du plan de numérotation ne peut pas confirmer qu’un numéro est attribué, actif, joignable ou capable de recevoir des appels ou des SMS.

L’API renvoie-t-elle l’opérateur actuel ou le propriétaire du téléphone ?

L’API peut renvoyer l’opérateur attributaire initial du préfixe ou le titulaire de l’attribution du régulateur. Aucun de ces champs n’indique l’opérateur actuel après une portabilité et aucun n’identifie l’abonné ou le propriétaire du téléphone.

Les numéros de téléphone nationaux nécessitent-ils un pays ?

Oui. Indiquez un pays ou une région par défaut lorsque le numéro ne commence pas par un indicatif téléphonique international. Un pays est également nécessaire pour interpréter les numéros courts régionaux et les numéros d’urgence.

D’où proviennent les données contextuelles ?

Les métadonnées mondiales proviennent de Google libphonenumber. Les données officielles sur les tranches et les préfixes peuvent aussi provenir d’instantanés publics publiés par CNMC, ARCEP, Bundesnetzagentur, MIC Japon, RTR Autriche, Nkom, UKE Pologne, MODA Taïwan, NANPA pour les États-Unis et CNA/CNAC pour le Canada. Les données américaines et canadiennes décrivent le statut des codes de central téléphonique NPA-NXX et leurs attributaires d’origine, et non l’opérateur actuel d’un numéro porté. Chaque résultat indique ses sources, les dates des instantanés et le niveau de couverture. La localisation et les fuseaux horaires décrivent le préfixe du plan de numérotation, pas la position actuelle du téléphone.

Puis-je valider des numéros de téléphone par lot ?

Oui. Le point de terminaison groupé accepte jusqu’à 100 numéros et renvoie les résultats dans l’ordre de saisie. Si l’enrichissement hors ligne est indisponible, la validation locale aboutit tout de même et intelligence.status signale le repli.

Outils et Ressources Connexes

Codes de Statut HTTP

Nous documentons les codes d'état HTTP que votre client doit gérer afin de distinguer les réponses réussies, les problèmes d'authentification, les crédits, les limites de débit, les données introuvables et les erreurs en amont.

OK 200

Requête réussie

Requête incorrecte 400

Paramètres invalides

Non autorisé 401

Clé API ou session manquante ou invalide.

Paiement requis 402

Crédits insuffisants pour exécuter cette requête.

Trop de requêtes 429

Limite de débit dépassée

Erreur serveur 500

Erreur interne

Mauvaise passerelle 502

Erreur RDAP en amont

Service indisponible 503

Le service amont est indisponible ou limite temporairement les requêtes.

Délai d’attente de la passerelle dépassé 504

La requête amont a expiré.

Essayez gratuitement les données contextuelles téléphoniques

Voir la documentation complète de l'API APIs

API de données contextuelles sur les numéros de téléphone

Signaux de confiance avant intégration

Ce que cette API vous aide à livrer

Flux d’intégration

Kit développeur

Carte des paramètres et réponses

Points de terminaison

Signaux de confiance avant intégration

Fonctionnalités clés

Exemple de Requête

Exemple de Réponse

Foire aux questions

Outils et Ressources Connexes

Codes de Statut HTTP