GET /api/menages/{id}

Récupère les informations détaillées d'un ménage.

Endpoint

GET /api/menages/{id}

Paramètres d'URL

Paramètre	Type	Description
id	integer	Identifiant du ménage

Headers

Header	Valeur	Requis
Authorization	Bearer {token}	Oui

Réponse succès

Code: 200 OK

{
    "@context": "/api/contexts/Menage",
    "@id": "/api/menages/1",
    "@type": "Menage",
    "id": 1,
    "codeMenage": "MEN-2024-00001",
    "tailleMenage": 5,
    "scorePmt": "45.67",
    "statut": "actif",
    "latitude": "14.7167",
    "longitude": "-17.4677",
    "altitude": "12.5",
    "precisionGps": "5.0",
    "nbEnfants04": 1,
    "nbEnfants514": 2,
    "nbAdultes1564": 2,
    "nbPersonnes65Plus": 0,
    "nbHandicapes": 0,
    "nbActifsOccupes": 2,
    "chefMenage": {
        "@id": "/api/chef_menages/1",
        "@type": "ChefMenage",
        "id": 1,
        "nomComplet": "Mamadou Diallo",
        "sexe": "M",
        "age": 45,
        "niveauEducation": "secondaire",
        "occupationPrincipale": "commerce",
        "statutMatrimonial": "marie",
        "telephone": "771234567",
        "numeroMobileMoney": "771234567",
        "compteBancaire": null
    },
    "logement": {
        "@id": "/api/logements/1",
        "@type": "Logement",
        "typeLogement": "maison",
        "statutOccupation": "proprietaire",
        "nbPieces": 4,
        "materiauMur": "ciment",
        "materiauToit": "tole",
        "materiauSol": "ciment",
        "sourceEau": "robinet",
        "typeToilette": "wc_chasse",
        "sourceEclairage": "electricite",
        "combustibleCuisine": "gaz"
    },
    "region": {
        "@id": "/api/regions/1",
        "@type": "Region",
        "id": 1,
        "nom": "Oio",
        "code": "OIO"
    },
    "secteur": {
        "@id": "/api/secteurs/1",
        "@type": "Secteur",
        "id": 1,
        "nom": "Farim"
    },
    "localite": {
        "@id": "/api/localites/1",
        "@type": "Localite",
        "id": 1,
        "nom": "Farim Centro"
    },
    "beneficiaire": {
        "@id": "/api/beneficiaires/1",
        "@type": "Beneficiaire",
        "id": 1,
        "actif": true,
        "modePaiement": "orange_money"
    },
    "membres": [
        {
            "@id": "/api/membre_menages/1",
            "nomComplet": "Fatou Diallo",
            "lienParente": "epouse",
            "sexe": "F",
            "age": 38
        },
        {
            "@id": "/api/membre_menages/2",
            "nomComplet": "Ibrahima Diallo",
            "lienParente": "fils",
            "sexe": "M",
            "age": 15
        }
    ],
    "createdAt": "2024-01-15T10:30:00+00:00",
    "updatedAt": "2024-01-20T14:15:00+00:00",
    "createdBy": {
        "@id": "/api/users/1",
        "email": "admin@pch-sig.sn"
    }
}

Réponses erreur

404 Not Found

{
    "@context": "/api/contexts/Error",
    "@type": "hydra:Error",
    "hydra:title": "An error occurred",
    "hydra:description": "Item not found for \"/api/menages/999\""
}

403 Forbidden

{
    "@context": "/api/contexts/Error",
    "@type": "hydra:Error",
    "hydra:title": "An error occurred",
    "hydra:description": "Access Denied."
}

Exemples

cURL

curl https://sig.example.com/api/menages/1 \
  -H "Authorization: Bearer TOKEN"

JavaScript

const getMenage = async (id) => {
    const response = await fetch(
        `https://sig.example.com/api/menages/${id}`,
        {
            headers: {
                'Authorization': `Bearer ${localStorage.getItem('token')}`
            }
        }
    );

    if (response.status === 404) {
        throw new Error('Ménage non trouvé');
    }

    return response.json();
};

// Utilisation
try {
    const menage = await getMenage(1);
    console.log(`Chef: ${menage.chefMenage.nomComplet}`);
    console.log(`Taille: ${menage.tailleMenage} personnes`);
    console.log(`Score PMT: ${menage.scorePmt}`);
} catch (error) {
    console.error(error.message);
}

Python

import requests

def get_menage(token, menage_id):
    response = requests.get(
        f'https://sig.example.com/api/menages/{menage_id}',
        headers={'Authorization': f'Bearer {token}'}
    )

    if response.status_code == 404:
        raise Exception('Ménage non trouvé')

    return response.json()

# Utilisation
menage = get_menage(token, 1)
print(f"Code: {menage['codeMenage']}")
print(f"Chef: {menage['chefMenage']['nomComplet']}")
print(f"Région: {menage['region']['nom']}")

Champs de la réponse

Ménage

Champ	Type	Description
id	integer	Identifiant unique
codeMenage	string	Code unique du ménage
tailleMenage	integer	Nombre de personnes
scorePmt	string	Score PMT (decimal)
statut	string	Statut (actif, inactif, en_attente)
latitude, longitude	string	Coordonnées GPS

Chef de ménage

Champ	Type	Description
nomComplet	string	Nom complet
sexe	string	M ou F
age	integer	Âge
telephone	string	Numéro de téléphone
niveauEducation	string	Niveau d'éducation
occupationPrincipale	string	Activité principale

Logement

Champ	Type	Description
typeLogement	string	Type (maison, appartement, etc.)
nbPieces	integer	Nombre de pièces
materiauMur	string	Matériau des murs
sourceEau	string	Source d'eau

Notes

• La réponse inclut toutes les relations (chef, logement, membres, bénéficiaire)
• Les coordonnées GPS sont retournées sous forme de chaînes (decimal)
• Le champ membres contient la liste des membres du ménage hors chef

---

GET /api/menages/{id}/fiche-pdf

Génère une fiche PDF complète du ménage pour impression ou archivage.

Endpoint

GET /api/menages/{id}/fiche-pdf

Paramètres d'URL

Paramètre	Type	Description
id	UUID	Identifiant du ménage

Headers

Header	Valeur	Requis
Authorization	Bearer {token}	Oui

Réponse succès

Code: 200 OK

Le fichier PDF est retourné directement avec les headers appropriés :

Content-Type: application/pdf
Content-Disposition: attachment; filename="fiche_menage_MEN-2026-00001.pdf"

Contenu de la fiche PDF

La fiche PDF inclut les sections suivantes :

Section	Contenu
En-tête	Logos officiels (selon configuration branding)
Identification	Code ménage, date de création, statut
Chef de ménage	Nom, sexe, âge, téléphone, pièce d'identité
Localisation	Région, secteur, localité, coordonnées GPS
Composition	Taille du ménage, répartition par tranche d'âge
Logement	Type, matériaux, équipements
Membres	Tableau des membres avec nom, lien, sexe, âge
Score PMT	Score et catégorie de vulnérabilité
Historique paiements	Derniers paiements reçus (si bénéficiaire)
Pied de page	Date de génération, QR code de vérification

Exemple cURL

curl -X GET "https://api.example.com/api/menages/{id}/fiche-pdf" \
  -H "Authorization: Bearer <token>" \
  -o fiche_menage.pdf

Cas d'utilisation

• Vérification terrain : Imprimer la fiche pour les visites à domicile
• Archivage : Conserver une copie physique du dossier
• Audits : Fournir les justificatifs aux auditeurs
• Signature : Faire signer le chef de ménage pour validation

Permissions requises

Action	Permission
Générer la fiche PDF	registre.menages_view