simulation api

Civil Registry API

Une API REST bilingue (français / arabe) destinée aux tests et démonstrations. Obtenez des profils citoyens fictifs conformes aux normes mauritaniennes pour vos prototypes de services numériques.

Consulter la documentation API Propulsé par NEOTIC

Fonctionnalités principales

Dataset réaliste

100 fiches citoyennes équilibrées avec des noms, adresses et répartitions démographiques représentatifs de la Mauritanie.

Bilingue & localisé

Chaque champ textuel est fourni en français et en arabe, avec la possibilité de choisir une langue ou les deux.

Réponses structurées

Design API robuste : codes d’erreur normalisés, métadonnées et disclaimers inclus systématiquement.

Prêt pour l’intégration

Base Symfony moderne, tests automatisés et fixtures déterministes pour reproduire facilement les scénarios.

Point d’accès

GET /api/v1/check-nni/{nni}

Effectuez une requête HTTP avec un NNI mauritanien à 10 chiffres et le paramètre optionnel lang (fr, ar, both). La réponse contient les informations citoyennes simulées ainsi qu’un rappel de non-affiliation gouvernementale.

Requête

# Récupération en français
curl "https://registry.neotic.dev/api/v1/check-nni/1200000000?lang=fr"

# Réponse bilingue
curl "https://registry.neotic.dev/api/v1/check-nni/1200000002?lang=both"

Réponse (fr)

{
  "data": {
    "nni": "1200000000",
    "first_name": "Sidi",
    "last_name": "Ould Ahmed",
    "gender": "Masculin",
    "date_of_birth": "1990-04-01",
    "place_of_birth": "Nouakchott",
    "marital_status": "Marié(e)",
    "nationality": "Mauritanienne",
    "address": "Quartier Teyarett, Nouakchott, Mauritanie"
  },
  "meta": {
    "language": "fr",
    "retrieved_at": "2025-11-12T16:45:00+00:00",
    "source": "Civil Registry API Simulation – Not an official government service",
    "disclaimer": {
      "fr": "Données fictives fournies uniquement à des fins de test et de prototypage.",
      "ar": "البيانات الواردة وهمية ومخصصة للاختبار والنمذجة فقط."
    }
  }
}

Réponse (both)

{
  "data": {
    "nni": "1200000002",
    "first_name": {
      "fr": "Ahmed",
      "ar": "أحمد"
    },
    "last_name": {
      "fr": "Ould Cheikh",
      "ar": "ولد الشيخ"
    },
    "gender": {
      "fr": "Masculin",
      "ar": "ذكر"
    },
    "date_of_birth": "1985-02-14",
    "place_of_birth": {
      "fr": "Kaédi",
      "ar": "كيدي"
    },
    "marital_status": {
      "fr": "Célibataire",
      "ar": "أعزب/عزباء"
    },
    "nationality": {
      "fr": "Mauritanienne",
      "ar": "موريتانية"
    },
    "address": {
      "fr": "Quartier Tevragh-Zeina, Kaédi, Mauritanie",
      "ar": "حي تفرغ زينة، كيدي، موريتانيا"
    }
  },
  "meta": {
    "language": "both",
    "retrieved_at": "2025-11-12T16:45:00+00:00",
    "source": "Civil Registry API Simulation – Not an official government service",
    "disclaimer": {
      "fr": "Données fictives fournies uniquement à des fins de test et de prototypage.",
      "ar": "البيانات الواردة وهمية ومخصصة للاختبار والنمذجة فقط."
    }
  }
}