Appels et numéros
Formats de téléphone
Couverture: Les zones proviennent du plan de numérotation officiel du pays de chaque édition. L’Espagne indique une province pour chaque tranche de fixes ; beaucoup d’autres pays publient leurs indicatifs et leurs villes. Les numéros mobiles n’ont de zone dans aucun pays, et quelques pays ne publient pas encore de plan que nous puissions lire : nous n’y affichons que le type de ligne.
Ouvrir l’outilSur cette page
Objectif
Vérifiez si un numéro de téléphone est valide, s’il s’agit d’un mobile, d’un fixe, d’un numéro gratuit ou surtaxé, et affichez-le aux formats E.164, national et international.
Prérequis
Tout le monde peut lire ces guides, sans compte. Certains outils nécessitent Pro, comme indiqué dans chaque guide.
Saisissez le numéro complet avec son indicatif international. Pour un numéro national, vérifiez le pays de l’édition ou du sélecteur.
Mode d’emploi
Formats de téléphone
Saisissez le numéro complet avec son indicatif international. Pour un numéro national, vérifiez le pays de l’édition ou du sélecteur.
Vérifier
E.164 · Sans indicatif international · Format international
Exemple fictif
Exemple inventé, pas une recherche réelle. N’appelez pas et n’ouvrez pas ses liens.
+44 1632 960123Interpréter le résultat
C’est la norme internationale pour écrire un numéro : un signe plus, l’indicatif du pays et le numéro national, sans espaces ni zéro initial. Les applications et les systèmes téléphoniques l’utilisent pour enregistrer les numéros.
Limites
Formats et indicatifs pris en charge uniquement. Ils ne prouvent ni la localisation, ni le titulaire, ni l’activité du numéro. Certains indicatifs sont partagés.
Résoudre un problème
Si la saisie est invalide, vérifiez le format et le pays. Réessayez après une erreur de connexion ; respectez le délai si une limite est atteinte.
Numéro de téléphone invalide
Le contrôle de sécurité ou la connexion à l'API n'a pas répondu à temps. Réessayez dans quelques secondes.
Utiliser avec l’API
Nécessite une API key et des crédits. Chaque appel abouti coûte 1 crédit, même sans données. Un compte Pro actif inclut 20 crédits par mois calendaire UTC, partagés entre toutes les routes de l’API et consommés en premier ; les crédits mensuels non utilisés ne sont pas reportés. Les crédits achetés sur la page de votre compte fonctionnent sans Pro et n’expirent jamais.
Les erreurs ne sont jamais facturées : 401 invalid_api_key (clé absente ou invalide), 403 pro_required (ni crédits Pro ni crédits achetés), 422 entrée invalide, 429 quota_exceeded (plus de crédits), rate_limit_exceeded ou ai_busy (l’IA de sms-check est à pleine capacité), 503 tool_warming (les données sont encore en préparation) ou tool ou fournisseur indisponible. Après un 429 ou un 503, réessayez une fois écoulées les secondes indiquées dans l’en-tête Retry-After.
Formats E.164, national et international, indicatif, pays et validité selon le plan de numérotation. Un numéro possible mais non attribué renvoie valid=false.
Envoyez le corps JSON à la route propre au tool, ou à POST /v2/tools en ajoutant le champ tool. Les deux routes renvoient le même résultat.
POST https://api.nocall.io/v2/phone-formats
POST https://api.nocall.io/v2/tools {"tool":"phone-formats","phone":"+34912345678","country":"ES"}Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| phone | string (1–40) | Oui | Numéro de téléphone au format E.164 (+34…) ou national. |
| country | string (enum, 56) | Non (par défaut: "ES") | Code pays à deux lettres, par exemple ES ou US, utilisé pour les saisies au format national et pour les données du pays. |
REQUEST_ID="$(uuidgen)" && [ -n "$REQUEST_ID" ] &&
curl --request POST 'https://api.nocall.io/v2/phone-formats' \
--header "Authorization: Bearer $NOCALL_API_KEY" \
--header 'Content-Type: application/json' \
--header "Idempotency-Key: $REQUEST_ID" \
--data '{"phone":"+34912345678","country":"ES"}'import json
import os
import urllib.request
import uuid
api_key = os.environ.get('NOCALL_API_KEY')
if not api_key:
raise SystemExit('Set NOCALL_API_KEY')
request = urllib.request.Request(
'https://api.nocall.io/v2/phone-formats',
method='POST',
data=json.dumps({'phone': '+34912345678', 'country': 'ES'}).encode(),
headers={
'Authorization': 'Bearer ' + api_key,
'Content-Type': 'application/json',
'Idempotency-Key': str(uuid.uuid4()),
},
)
with urllib.request.urlopen(request, timeout=30) as response:
result = json.load(response)
print(result['data']['result'], result['meta']['unitsCharged'])import { randomUUID } from 'node:crypto';
const requestId = randomUUID();
const apiKey = process.env.NOCALL_API_KEY;
if (!apiKey) throw new Error('Set NOCALL_API_KEY');
const response = await fetch('https://api.nocall.io/v2/phone-formats', {
method: 'POST',
headers: {
Authorization: 'Bearer ' + apiKey,
'Content-Type': 'application/json',
'Idempotency-Key': requestId,
},
body: JSON.stringify({ phone: '+34912345678', country: 'ES' }),
});
const result = await response.json();
if (!response.ok) throw new Error(result.error?.code ?? 'request_failed');
console.log(result.data.result, result.meta.unitsCharged);Exemple de réponse (200)
Il s’agit de l’exemple documenté dans la référence de l’API. Les recherches utilisent un numéro fictif ; les agrégats et les réponses de l’IA montrent la structure du résultat, pas des données réelles.
{
"data": {
"tool": "phone-formats",
"result": {
"e164": "+34912345678",
"national": "912 34 56 78",
"international": "+34 912 34 56 78",
"callingCode": "34",
"country": "ES",
"valid": true
}
},
"meta": {
"requestId": "req_example",
"unitsCharged": 1,
"usage": {
"periodStart": "2026-10-01",
"unitLimit": 20,
"unitsUsed": 3,
"unitsRemaining": 17
}
}
}Champs du résultat (data.result)
| Champ | Type | Description |
|---|---|---|
| e164 | string | Le numéro au format E.164, ou null s’il ne peut pas être formaté. |
| national | string | Le numéro au format national de son pays. |
| international | string | Le numéro au format international. |
| callingCode | string | Indicatif du pays du numéro, ou null s’il est inconnu. |
| country | string | null | Pays du numéro (code ISO), ou null s’il ne peut pas être déterminé. |
| valid | boolean | Indique si le numéro est valide selon le plan de numérotation. false reste un résultat abouti. |
