referenceData_geography countries

Service qui permet de consulter la liste des pays, disponibles en 4 langues (FR, NL, DE, EN).

  • Service
  • Smals

Description

Le service REST referenceData_geography offre, pour la ressource 'countries', les fonctionnalités suivantes:

  • Obtenir les données d'un pays sur base du code INS de ce pays
  • Obtenir la liste des pays ou une sélection de ceux-ci basée sur des critères de recherche

Pour chaque pays, on peut avoir les informations suivantes:

  • Code INS du pays
  • Nom du pays en 4 langues (FR, NL, DE, EN)
  • Code du pays en 2 lettres (norme ISO-3166-1), conseillé pour spécifier une adresse
  • Code du pays en 3 lettres (norme ISO-3166-1), conseillé pour spécifier une nationalité
  • Code du pays en 3 chiffres maximum (norme ISO-3166-1), utile pour identifier les pays n'utilisant pas l'alphabet latin
  • Statut: actif ou pas (selon que la date de fin de validité est supérieure ou inférieure à la date du jour)
  • Nom des habitants en 4 langues (FR, NL, DE, EN)
  • Date de début de validité
  • Date de fin de validité

Ce service REST referenceData_geography, pour la ressource 'countries', étant basé sur les codes INS des pays, certains territoires, bien qu’ils aient un code ISO, ne sont pas repris dans ce service car ils n’ont pas de code INS de pays
Exemples: Iles Feroé, Jersey, Mayotte…

D’autre part, nous remarquerons que

  • certains codes INS n'ont pas de code ISO correspondant:
    Tchécoslovaquie, Kosovo, Jerusalem, OTAN, SHAPE, Apatride…
  • certains pays n’ont pas de code ISO propre mais ont celui du pays auquel ils sont l’entité:
    Iles Canaries (ESP), Madère (P)...
  • certaines entités ont un code ISO propre, différent du pays principal:
    La Guadeloupe (GP) et La Martinique (MQ) n'ont pas le code ISO de la France (FR)
  • le nom des habitants d’un pays est donné au masculin singulier:
    Français, Espagnol, Belge, Guadeloupéen, Groenlandais…
  • le nom des habitants d’un pays ne correspond pas à leur nationalité, cette dernière n'est pas fournie par ce service
    Un Guadeloupéen a la nationalité française, un Groenlandais a la nationalité danoise
  • certains codes INS ont été créés pour satisfaire des besoins business:
    'Apatride', 'Pas encore définitivement établi', 'Rayé pour l'étranger', 'En mer', 'Indéterminé', 'd'origine', 'Réfugié', 'Indéterminé', 'SHAPE' et 'OTAN'

Groupes d'utilisateurs

Toute application qui traite des adresses internationales et qui nécessite un code INS, un code pays selon la norme ISO-3166-1 et/ou des dates de validité des pays.

Remarque:  Il existe une source authentique des codes pays, sous la tutelle du SPF Affaires étrangères, cogérée par le SPF Économie et BOSA DT, et disposant d'un comité d’utilisateurs, d'une structure de gouvernance et de procédures de gouvernance.

Le SPF Stratégie et Appui (Bosa) offre les services SOAP pour consulter cette source authentique des codes pays.

Dans ce cas, il faut prendre contact directement avec eux via le site Statbel.

Conditions d'intégration

Le service n’étant pas sécurisé, il n’y a pas de conditions d’intégration particulières.

Cependant pour les applications Angular il faudra transmettre l'URN de l'application afin de configurer son accès au service.

Contact: TransversalTeam@smals.be

Documentation

Certains des liens ci-dessous pourraient ne pas fonctionner en raison de restrictions de sécurité.

Si vous voulez obtenir ces informations, prenez contact avec l’équipe responsable via l’adresse email spécifiée dans le paragraphe ci-dessus consacré aux conditions d’intégration.

Comment participer ?

Enrichir le catalogue

Vous avez un composant réutilisable qui pourrait intéresser d’autres institutions ? 

Proposez-le-nous !

Participer à nos évènements

Vous aimeriez échanger au sujet de la réutilisation ? Des évènements sont régulièrement organisés.

Inscrivez-vous ici !

Recevoir la newsletter

Inscrivez-vous à la newsletter pour suivre l’actualité autour de la réutilisation.

Inscrivez-vous ici !

Partager votre expérience

Réutiliser un composant vous a aidé à transformer un projet en réussite ?

Faites-nous part de votre expérience !

Vers le haut