From 2668dd8a599368b2f05cb287b1f025dff5d351f8 Mon Sep 17 00:00:00 2001 From: Miryad Ali <59559301+Miryad3108@users.noreply.github.com> Date: Tue, 11 Feb 2025 00:29:56 +0100 Subject: [PATCH 1/6] Create dsnj_service_national --- .../api_particulier/dsnj_service_national | 127 ++++++++++++++++++ 1 file changed, 127 insertions(+) create mode 100644 config/endpoints/api_particulier/dsnj_service_national diff --git a/config/endpoints/api_particulier/dsnj_service_national b/config/endpoints/api_particulier/dsnj_service_national new file mode 100644 index 000000000..76cac77d0 --- /dev/null +++ b/config/endpoints/api_particulier/dsnj_service_national @@ -0,0 +1,127 @@ +-- + - uid: 'dsnj/service_national' + opening: protected + new_version: true + path: '/api/v3/service-national' + ping_url: 'https://particulier.api.gouv.fr/api/dsnj_service_national' + position: + perimeter: + entity_type_description: |+ + **Cette API concerne les jeunes** : + - ✅ de nationalité Française ; + - ✅ âgés entre 16 et 25 ans; + + + **Ne sont pas concernés par cette API** : + - ❌ les jeunes de nationalité étrangère ; + - ❌ Les personnes de moins de 16 et de plus de 25 ans car elles sont exemptées du service national ; + + + + + geographical_scope_description: |+ + - ✅ France métropolitaine ; + - DROM COM ; + - les Français à l'étranger résidant dans un pays où il y a un consulat français. + updating_rules_description: |+ + Les données sont **mises à jour [ A COMPLETER]*. cette API est opérée par la Direction du Service National et de la Jeunesse (DSNJ) et est reliée au système d'information [du Ministère des Armées : A CONFIRMER]. + + + ⚠️ **Les informations obtenues sont représentatives de la situation connue par le Ministère des Armées au moment de l'appel**. + data: + description: |+ + **Cette API délivre** : + - **la situation d'un jeune vis à vis du service national** [en savoir plus](#faq_entry_answer_1_api_particulier_endpoint_ministere_des_armees_service_national) ; + - **le numéro identifiant défense dans certains cas ;** + + + {:.fr-highlight} + > Il n'y a que les jeunes entre 16 et 25 ans qui peuvent apparaître comme étant en règle ou non dans cette API, [en savoir plus](#faq_entry_answer_2_api_particulier_endpoint_dsnj_service_national). + + + + + parameters_details: + description: |+ + **L'API est uniquement appelable avec les informations de l'allocataire**. +
+ Deux modalités d'appel sont possibles : +

![Cette API est FranceConnectée](<%= image_path('api_particulier/cas_usages/pictos/modalite_appel_france_connect.svg') %>){:width="20px"} FranceConnect

+ **Avec la [modalité d'appel FranceConnect](<%= cas_usage_path('modalite_appel_france_connect') %>)**. + + +

Identité pivot

+
+

+ +

+
+
+
    +
  • Nom de naissance*, nom d'usage, prénoms1, sexe*, date de naissance de l'allocataire** ;
    • +
  • Lieu de naissance : +
      +
    • + Si le lieu de naissance est en France, la commune de naissance est obligatoire, elle peut être saisie de deux façons différentes : +
        +
      • + Option 1 : Code COG de la commune de naissance*. En savoir plus ; +
        • +
      • + Option 2 : Nom de la commune de naissance* et code du département de naissance*. Pour cette option, la date de naissance est obligatoire. En savoir plus. +
        • +
      + Pour chacune des deux options ci-dessus, le code COG de la France 99100* doit également être renseigné en paramètre d'appel. Vous n'avez pas besoin de le demander à l'usager, il peut être déduit de la commune de naissance. +
      • +
    • + Si le lieu de naissance est à l'étranger : code COG du pays de naissance*. +
      • +
    +
    • +
+
+ + * Obligatoire | ** Obligatoire pour l'option 2 du lieu de naissance. + + + 1 Fournir plusieurs prénoms permet de limiter les risques d'homonymie mais un seul prénom peut fonctionner. Attention, l'usager doit compléter chaque prénom dans un champ distinct. + +
+ ⚠️ Message API Particulier du 04.06.2024 : Nous avons constaté que les appels effectués sans nom de naissance et avec le nom d'usage ne fonctionnent pas dans une très grande partie des cas. API Particulier a donc décidé de passer le paramètre "Nom de naissance" en obligatoire. +
+
+
+ + + provider_uids: + - 'dsnj' + call_id: + - Identité pivot + - FranceConnect + parameters: + - Identité pivot + - FranceConnect + keywords: + - service national + - numero identifiant defense + + + faq: + - q: Qu'est ce que le service national ? + a: |+ + **Le service national est composé du rencensement et de la participation à la journée défense et citoyenneté. Un jeune qui est en règle vis à vis du service national a donc effectué son recensement dès l'âge de 16 ans et a participé à la journée défense et citoyenneté** + + + - q: Quelles sont les personnes concernées par le service national ? + a: |+ + **Les Français entre 16 et 25 ans doivent être en règle vis à vis du service national pour passer certains examens et concours.** Avant 16 ans et après 25 ans, le service national n'est pas requis. Dans ces cas là, l'API renvoie "Non concerné". + + + - q: Pourquoi être en règle vis à vis du service national ? + a: |+ + **Un jeune entre 16 et 25 ans doit être en règle vis à vis du service national si il souhaite : + - passer des examens soumis sous contrôle de l'autorité publique comme le permis de conduire ; + - passer des concours sous contrôle de l'autorité publique ; + - postuler à un un emploi de la fonction pubique qui demande d’être en règle vis à vis du service national. + [Plus d'informations](https://api.gouv.fr/guides/api-service-national#pour-quelles-demarches-peut-on-utiliser-l%E2%80%99api-service-national-?) + From 507cfab2444df7a1c2662310d805fc6acacb6f86 Mon Sep 17 00:00:00 2001 From: Miryad Ali <59559301+Miryad3108@users.noreply.github.com> Date: Fri, 21 Feb 2025 11:09:33 +0100 Subject: [PATCH 2/6] Update config/endpoints/api_particulier/dsnj_service_national Co-authored-by: DorineLam <46896006+DorineLam@users.noreply.github.com> --- config/endpoints/api_particulier/dsnj_service_national | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/config/endpoints/api_particulier/dsnj_service_national b/config/endpoints/api_particulier/dsnj_service_national index 76cac77d0..b623357f3 100644 --- a/config/endpoints/api_particulier/dsnj_service_national +++ b/config/endpoints/api_particulier/dsnj_service_national @@ -7,7 +7,7 @@ position: perimeter: entity_type_description: |+ - **Cette API concerne les jeunes** : + **Cette API concerne les jeunes de 16 à 25 ans, de nationalité française**. - ✅ de nationalité Française ; - ✅ âgés entre 16 et 25 ans; From 9b41a9ae3a7d99be0cc9aa10ca60a30919d7b5b1 Mon Sep 17 00:00:00 2001 From: Miryad Ali <59559301+Miryad3108@users.noreply.github.com> Date: Fri, 21 Feb 2025 11:09:41 +0100 Subject: [PATCH 3/6] Update config/endpoints/api_particulier/dsnj_service_national Co-authored-by: DorineLam <46896006+DorineLam@users.noreply.github.com> --- config/endpoints/api_particulier/dsnj_service_national | 1 - 1 file changed, 1 deletion(-) diff --git a/config/endpoints/api_particulier/dsnj_service_national b/config/endpoints/api_particulier/dsnj_service_national index b623357f3..23e298a5c 100644 --- a/config/endpoints/api_particulier/dsnj_service_national +++ b/config/endpoints/api_particulier/dsnj_service_national @@ -8,7 +8,6 @@ perimeter: entity_type_description: |+ **Cette API concerne les jeunes de 16 à 25 ans, de nationalité française**. - - ✅ de nationalité Française ; - ✅ âgés entre 16 et 25 ans; From c5450220b56adc0b6d79e6eeea95cd0e96e12a43 Mon Sep 17 00:00:00 2001 From: Miryad Ali <59559301+Miryad3108@users.noreply.github.com> Date: Fri, 21 Feb 2025 11:09:50 +0100 Subject: [PATCH 4/6] Update config/endpoints/api_particulier/dsnj_service_national Co-authored-by: DorineLam <46896006+DorineLam@users.noreply.github.com> --- config/endpoints/api_particulier/dsnj_service_national | 1 - 1 file changed, 1 deletion(-) diff --git a/config/endpoints/api_particulier/dsnj_service_national b/config/endpoints/api_particulier/dsnj_service_national index 23e298a5c..b49bdc957 100644 --- a/config/endpoints/api_particulier/dsnj_service_national +++ b/config/endpoints/api_particulier/dsnj_service_national @@ -8,7 +8,6 @@ perimeter: entity_type_description: |+ **Cette API concerne les jeunes de 16 à 25 ans, de nationalité française**. - - ✅ âgés entre 16 et 25 ans; **Ne sont pas concernés par cette API** : From df76f4fa5185555369bea4be7df9c71699388691 Mon Sep 17 00:00:00 2001 From: Miryad Ali <59559301+Miryad3108@users.noreply.github.com> Date: Fri, 21 Feb 2025 11:10:02 +0100 Subject: [PATCH 5/6] Update config/endpoints/api_particulier/dsnj_service_national Co-authored-by: DorineLam <46896006+DorineLam@users.noreply.github.com> --- config/endpoints/api_particulier/dsnj_service_national | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/config/endpoints/api_particulier/dsnj_service_national b/config/endpoints/api_particulier/dsnj_service_national index b49bdc957..68f01a3fb 100644 --- a/config/endpoints/api_particulier/dsnj_service_national +++ b/config/endpoints/api_particulier/dsnj_service_national @@ -20,7 +20,7 @@ geographical_scope_description: |+ - ✅ France métropolitaine ; - DROM COM ; - - les Français à l'étranger résidant dans un pays où il y a un consulat français. + - les français à l'étranger résidant dans un pays où il y a un consulat français. updating_rules_description: |+ Les données sont **mises à jour [ A COMPLETER]*. cette API est opérée par la Direction du Service National et de la Jeunesse (DSNJ) et est reliée au système d'information [du Ministère des Armées : A CONFIRMER]. From fba7bfe7f61a0e3d850db35df3d9ac373b6b63e0 Mon Sep 17 00:00:00 2001 From: Miryad Ali <59559301+Miryad3108@users.noreply.github.com> Date: Fri, 21 Feb 2025 11:10:17 +0100 Subject: [PATCH 6/6] Update config/endpoints/api_particulier/dsnj_service_national Co-authored-by: DorineLam <46896006+DorineLam@users.noreply.github.com> --- config/endpoints/api_particulier/dsnj_service_national | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/config/endpoints/api_particulier/dsnj_service_national b/config/endpoints/api_particulier/dsnj_service_national index 68f01a3fb..d8f249a09 100644 --- a/config/endpoints/api_particulier/dsnj_service_national +++ b/config/endpoints/api_particulier/dsnj_service_national @@ -22,7 +22,7 @@ - DROM COM ; - les français à l'étranger résidant dans un pays où il y a un consulat français. updating_rules_description: |+ - Les données sont **mises à jour [ A COMPLETER]*. cette API est opérée par la Direction du Service National et de la Jeunesse (DSNJ) et est reliée au système d'information [du Ministère des Armées : A CONFIRMER]. + Les données sont **mises à jour [ A COMPLETER]*. cette API est opérée par la direction du service national et de la jeunesse (DSNJ) et est reliée au système d'information [du ministère des Armées : A CONFIRMER]. ⚠️ **Les informations obtenues sont représentatives de la situation connue par le Ministère des Armées au moment de l'appel**.