Données, exports CSV / JSON et API
Version, licence et périmètre
| Identifiant | indicatifs-com-pays-e164 |
| Version | 2026-08-26-v23 |
| Licence de réutilisation | Réutilisation autorisée avec attribution « Indicatifs.com », lien vers cette page et conservation de la version. |
| Accès | Gratuit, sans compte, en HTML, JSON et CSV. |
| Limite | Les formats n’établissent ni l’existence d’une ligne, ni son titulaire, ni sa position actuelle. |
Pour citer le jeu, utilisez l’URL canonique https://www.indicatifs.com/donnees/, la version ci-dessus et la date de consultation. Les corrections documentées sont propagées dans les exports, le moteur et les fiches concernées.
Les données d’Indicatifs.com sont publiées dans des formats simples pour faciliter la vérification, la réutilisation et l’intégration dans des outils.
Exports disponibles
| Fichier | Contenu |
|---|---|
| data/indicatifs-pays.json | JSON complet pays + indicatifs |
| data/indicatifs-pays.csv | CSV pays + indicatifs |
| data/indicatifs-e164.json | JSON compact E.164 |
| data/indicatifs-afrique.csv | CSV indicatifs Afrique |
| data/indicatifs-europe.csv | CSV indicatifs Europe |
| data/numerotation-france.csv | CSV numérotation France |
| api/lookup?code=212 | Lookup indicatif JSON statique |
| api/format/ | Formatage : documentation et exports |
| donnees/changelog/ | Journal des mises à jour des données et templates |
| widget Indicatifs.com | Widget intégrable avec lien vers le moteur d’identification |
Exemple API
GET /api/lookup?code=212{ "query": "212", "results": [{ "name_fr": "Maroc", "calling_code": "212" }] }Le lookup est servi sans PHP : l'URL peut renvoyer un JSON statique quand la réécriture serveur est active, et les exports restent toujours disponibles.
Licence et limites
Les données sont fournies pour consultation et intégration avec attribution. Les indicatifs pays sont rattachés aux sources E.164 ; les exemples de formatage proviennent de métadonnées publiques. Pour un usage critique, vérifiez les règles auprès des autorités ou opérateurs concernés.
Aucune donnée nominative d’abonné n’est publiée.
Widget intégrable
Un widget léger permet d’ajouter un champ de recherche d’indicatif sur un autre site, avec un lien de crédit vers Indicatifs.com.
<script src="https://www.indicatifs.com/widget.js"></script>Suivi des mises à jour
Les changements importants des données et des templates sont publiés dans le changelog.
Choisir le bon niveau de donnée
Le CSV convient à une analyse dans un tableur ; le JSON conserve les tableaux, les statuts et les objets d’exemple ; les fichiers lookup servent à une réponse ciblée par code. Une intégration ne doit pas reconstruire les URL à partir du nom du pays : utilisez le champ canonique fourni.
Les longueurs possibles représentent une cohérence de plan, pas une validation en temps réel. Les ressources peuvent être réservées, non attribuées ou modifiées entre deux versions. Pour un contrôle critique, croisez la date du jeu avec la publication de l’autorité nationale.
Traçabilité
Le fichier principal expose sa version, ses sources, sa dernière vérification, ses limites et le responsable éditorial. Les corrections affectant une attribution sont reportées dans le journal afin qu’une application puisse expliquer la provenance du changement.
Contrôle avant mise en production
Testez au minimum un code unique, un code partagé, un territoire du plan +1, un service mondial et un code absent. Vérifiez aussi que votre application respecte les accents des noms français et ne transforme pas une longueur possible en affirmation d’existence.
Lors d’une mise à jour, conservez la version précédente le temps de comparer les résultats et d’identifier les changements inattendus.
Ce que les données ne permettent pas
Les exports ne contiennent ni titulaire, ni état en temps réel, ni opérateur actuel. Une longueur plausible ne prouve pas qu’un numéro est attribué.
| Usage adapté | Aide à la saisie, documentation, routage éditorial. |
| À confirmer | Tarification, accessibilité, règle d’opérateur. |
| Exclu | Identifier une personne ou certifier un appel sûr. |
Version, date et URL canoniques rendent chaque export auditable.
Contrôles avant d’importer les exports
Vérifiez la version, l’encodage UTF-8, les en-têtes CSV et les champs de limites avant l’import. Une application doit conserver les zones NANP complètes et les tableaux de destinations partagées.
Une mise à jour ne doit pas écraser silencieusement l’historique d’un résultat.
Ressources complémentaires
Parcours technique : vue d’ensemble de l’API, lookup JSON par code, méthode de formatage, widget intégrable et moteur destiné aux internautes.
Sources complémentaires : Métadonnées techniques libphonenumber. Ces références sont utilisées selon leur périmètre respectif.
Référence officielle : liste officielle UIT des indicatifs E.164, pour l’attribution des codes internationaux. Consultation éditoriale : 26 août 2026.
Clés stables et mises à jour explicables
Pour relier une fiche à un système interne, utilisez le slug ou le code documenté, mais ne supposez pas qu’un code est toujours unique. Les plans partagés exigent une liste de destinations et, pour +1, une zone complémentaire.
| Champ | Usage recommandé |
|---|---|
| calling_code | Code E.164, potentiellement partagé |
| nanp_area_codes | Zones nécessaires après +1 |
| possible_lengths | Contrôle de plausibilité, pas preuve d’existence |
| version | Reproduire un résultat et gérer les écarts |
Lors d’une mise à jour, comparez les clés plutôt que l’ordre des lignes. Une destination ajoutée à un code partagé ne doit pas écraser celles déjà présentes.