API RSU - Registre Social Unifie
Cette section documente les endpoints API du module RSU (Registre Social Unifie).
Vue d'ensemble
Le RSU permet de consolider les donnees de plusieurs organisations dans un registre social commun. L'API expose les fonctionnalites suivantes :
| Fonctionnalite | Description |
|---|---|
| Organisations | Gestion des organisations participantes |
| Accords de partage | Conventions de partage de donnees |
| Menages collectes | Staging des donnees avant integration |
| Recherche unifiee | Recherche cross-organisations |
Authentification
Tous les endpoints RSU necessitent une authentification JWT.
Authorization: Bearer <token>
Les permissions requises dependent de l'organisation de l'utilisateur et des accords de partage actifs.
Base URL
/api/rsu
Endpoints principaux
Organisations
| Methode | Endpoint | Description |
|---|---|---|
| GET | /organisations | Liste des organisations |
| GET | /organisations/{id} | Detail d'une organisation |
| POST | /organisations | Creer une organisation |
| PATCH | /organisations/{id} | Modifier une organisation |
Accords de partage
| Methode | Endpoint | Description |
|---|---|---|
| GET | /data-sharing-agreements | Liste des accords |
| GET | /data-sharing-agreements/{id} | Detail d'un accord |
| POST | /data-sharing-agreements | Creer un accord |
| PATCH | /data-sharing-agreements/{id} | Modifier un accord |
| POST | /data-sharing-agreements/{id}/activate | Activer un accord |
| POST | /data-sharing-agreements/{id}/suspend | Suspendre un accord |
Menages collectes
| Methode | Endpoint | Description |
|---|---|---|
| GET | /menages-collectes | Liste des menages en staging |
| GET | /menages-collectes/{id} | Detail d'un menage collecte |
| POST | /menages-collectes/{id}/integrate | Integrer dans le RSU |
| POST | /menages-collectes/bulk-integrate | Integration en masse |
| DELETE | /menages-collectes/{id} | Supprimer un menage collecte |
Recherche
| Methode | Endpoint | Description |
|---|---|---|
| GET | /search | Recherche unifiee dans le RSU |
| GET | /search/duplicates | Detection de doublons |
Format des identifiants
Les identifiants RSU suivent un format standardise :
{PAYS}-{AAAAMMJJ}-{XXXXXX}
Exemple: GW-20260715-000001
| Partie | Description |
|---|---|
| PAYS | Code pays ISO 2 lettres |
| AAAAMMJJ | Date de creation |
| XXXXXX | Sequence numerique |
Isolation des donnees
L'API applique automatiquement l'isolation des donnees selon :
- Organisation de l'utilisateur : Acces aux donnees de son organisation
- Accords actifs : Acces aux donnees partagees via accords
- Permissions : Filtrage selon les permissions RSU
Codes de reponse
| Code | Signification |
|---|---|
| 200 | Succes |
| 201 | Cree avec succes |
| 400 | Requete invalide |
| 401 | Non authentifie |
| 403 | Acces refuse (pas d'accord de partage) |
| 404 | Ressource non trouvee |
| 409 | Conflit (doublon detecte) |
Permissions RSU
| Permission | Description |
|---|---|
rsu.view | Consulter les donnees RSU |
rsu.edit | Modifier les donnees RSU |
rsu.integrate | Integrer des menages collectes |
rsu.agreements | Gerer les accords de partage |
rsu.admin | Administration complete |