Skip to content

Commit

Permalink
Merge pull request #1294 from betagouv/API-1851-api-part-france-connect
Browse files Browse the repository at this point in the history
API particulier et api ecosystème : rectif des parcours
  • Loading branch information
DorineLam authored Dec 18, 2023
2 parents 49055eb + ca66bf5 commit 75be375
Show file tree
Hide file tree
Showing 20 changed files with 344 additions and 93 deletions.
8 changes: 4 additions & 4 deletions _data/api/api-indemnisation-pole-emploi.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ access_page:
- Un demandeur d'emploi
is_eligible: -1
description: |
Vous ne pouvez pas accéder a ces informations.
L’usage de cette API est **uniquement reservé aux acteurs publics**. En tant que particulier, vous ne pouvez pas y accéder.
<Button href="/rechercher-api">Rechercher une autre API</Button>
- who:
Expand All @@ -18,9 +18,9 @@ access_page:
description: |
<NextSteps />
<QuestionTree tree='france-connected-api' question='indemnisationPe' />
<QuestionTree tree='is_bouquet_api_parteprise' question='indemnisationPe' />
- who:
- Une entreprise
- Une entreprise ou une association
is_eligible: 0
description: |
Vous pouvez accéder à l’API uniquement si vous êtes [partenaire de France Connect](https://franceconnect.gouv.fr/partenaires), et pour un cas d’usage autorisé par la loi. Vous devrez fournir le cadre juridique qui vous autorise à utiliser ces données.
Expand Down Expand Up @@ -81,7 +81,7 @@ content_intro: |
### Modalités d'accès
⚠️ Pour les administrations qui ne proposent pas la connexion via FranceConnect ou pour lesquelles les démarches en ligne sont accessibles également sans FranceConnect, les mêmes données sont **disponibles dans [l'API Particulier](/les-api/api-particulier) (à compter de décembre 2022).**
⚠️ Pour les administrations qui ne proposent pas la connexion via FranceConnect ou pour lesquelles les démarches en ligne sont accessibles également sans FranceConnect, les mêmes données sont **disponibles dans [l'API Particulier](/les-api/api-particulier) dont vous pouvez lire <External href="https://particulier.api.gouv.fr/catalogue/pole_emploi/indemnites">la documentation sur le site dédié</External>.**
Cette API à un intérêt à être mobilisée en complément de [l'API statut demandeur d'emploi, version FranceConnectée](/les-api/api-statut-demandeur-emploi).
Expand Down
18 changes: 13 additions & 5 deletions _data/api/api-scolarite-ministere-education-nationale.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,22 +9,30 @@ is_france_connected: -1
access_page:
- who:
- Un particulier
- Un étudiant
- Une entreprise
is_eligible: -1
description: |
Vous ne pouvez pas accèder à ces informations qui sont des données protégées.
L’usage de cette API est **uniquement reservé aux acteurs publics**. En tant que particulier, vous ne pouvez pas y accéder.
<Button href="/rechercher-api">Rechercher une autre API</Button>
- who:
- Une administration
is_eligible: 1
description: |
En tant que collectivité territoriale ou administration, vous êtes éligible à utiliser cette API selon votre cadre juridique. Vous pouvez déposer une demande d'habilitation :
<Button href="https://datapass.api.gouv.fr/api-scolarite">Demander un accès</Button>
<NextSteps />
<QuestionTree tree='is_bouquet_api_parteprise' question='scolariteEleve' />
- who:
- Une entreprise ou une association
is_eligible: -1
description: |
L’usage de cette API est **uniquement reservé aux acteurs publics**.
<Button href="/rechercher-api">Rechercher une autre API</Button>
# rate_limiting_resume: 10 appels / minute / IP # 📍 Volumétrie maximale de votre API.
# rate_limiting_description: | L'API est disponible à hauteur de 10 appels par minute.
# Phrase descriptive de la volumétrie
partners:
- dinum
themes:
- Particulier
- Education
Expand Down
7 changes: 4 additions & 3 deletions _data/api/api-statut-demandeur-emploi.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ access_page:
- Un demandeur d'emploi
is_eligible: -1
description: |
Ces informations sont résevées aux administrations.
L’usage de cette API est **uniquement reservé aux acteurs publics**. En tant que particulier, vous ne pouvez pas y accéder.
<Button href="/rechercher-api">Rechercher une autre API</Button>
- who:
Expand All @@ -18,7 +18,7 @@ access_page:
description: |
<NextSteps />
<QuestionTree tree='france-connected-api' question='statutDe' />
<QuestionTree tree='is_bouquet_api_parteprise' question='statutDe' />
- who:
- Une entreprise
is_eligible: 0
Expand Down Expand Up @@ -69,7 +69,8 @@ content_intro: |
### Modalités d'accès
⚠️ Pour les administrations qui ne proposent pas la connexion via FranceConnect ou pour lesquelles les démarches en ligne sont accessibles également sans FranceConnect, les mêmes données sont **disponibles dans [l'API Particulier](/les-api/api-particulier)**
⚠️ Pour les administrations qui ne proposent pas la connexion via FranceConnect ou pour lesquelles les démarches en ligne sont accessibles également sans FranceConnect, les mêmes données sont **disponibles dans [l'API Particulier](/les-api/api-particulier) dont vous pouvez lire <External href="https://particulier.api.gouv.fr/catalogue/pole_emploi/situation">la documentation sur le site dédié</External>.**
### Quel est le périmètre de l'API ?
Expand Down
6 changes: 3 additions & 3 deletions _data/api/api-statut-etudiant-boursier.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ access_page:
- Un étudiant
is_eligible: -1
description: |
Vous ne pouvez pas accèder a ces informations.
L’usage de cette API est **uniquement reservé aux acteurs publics**. En tant que particulier, vous ne pouvez pas y accéder.
<Button href="/rechercher-api">Rechercher une autre API</Button>
- who:
Expand All @@ -17,9 +17,9 @@ access_page:
description: |
<NextSteps />
<QuestionTree tree='france-connected-api' question='statutEtudiantBoursier' />
<QuestionTree tree='is_bouquet_api_parteprise' question='statutEtudiantBoursier' />
- who:
- Une entreprise
- Une entreprise ou une association
is_eligible: 0
description: |
Vous pouvez accéder à l’API uniquement si vous êtes [partenaire de France Connect](https://franceconnect.gouv.fr/partenaires), et pour un cas d’usage autorisé par la loi. Vous devrez fournir le cadre juridique qui vous autorise à utiliser ces données.
Expand Down
6 changes: 3 additions & 3 deletions _data/api/api-statut-etudiant.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ access_page:
- Un étudiant
is_eligible: -1
description: |
Vous ne pouvez pas accèder a ces informations.
L’usage de cette API est **uniquement reservé aux acteurs publics**. En tant que particulier, vous ne pouvez pas y accéder.
<Button href="/rechercher-api">Rechercher une autre API</Button>
- who:
Expand All @@ -17,9 +17,9 @@ access_page:
description: |
<NextSteps />
<QuestionTree tree='france-connected-api' question='statutEtudiant' />
<QuestionTree tree='is_bouquet_api_parteprise' question='statutEtudiant' />
- who:
- Une entreprise
- Une entreprise ou une association
is_eligible: 0
description: |
Vous pouvez accéder à l’API uniquement si vous êtes [partenaire de France Connect](https://franceconnect.gouv.fr/partenaires), et pour un cas d’usage autorisé par la loi. Vous devrez fournir le cadre juridique qui vous autorise à utiliser ces données.
Expand Down
89 changes: 89 additions & 0 deletions _data/api/api_complementaire_sante_solidaire.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,89 @@
---
title: API Complémentaire santé solidaire # 📍 Nom commercial de l'API, privilégier un nom court.
tagline: Entités administratives, simplifiez les démarches des bénéficiaires de la complémentaire santé solidaire en vérifiant leur statut # 📍 Une phrase pour résumer le service rendu par l'API. Si votre API est uniquement accessible à certaines organisation, spécifiez-le dès maintenant.
producer: securite_sociale # 📍 Identifiant du fournisseur de la donnée trouvable ou ajoutable dans le dossier `api_gouv/_data/producteurs`, pour en savoir plus consulter le read.me.
contact_link: [email protected] # 📍 Adresse e-mail que les usagers peuvent utiliser pour vous contacter.
partners:
- dinum
is_open: -1 # 📍 -1 si l'API est fermée, accessible à un public restreint sous habilitation ; 0 si un compte est nécessaire pour utiliser l'API mais qu'il n'y a pas de conditions pour se créer un compte.
datapass_link: https://datapass.api.gouv.fr/api-particulier # URL vers le formulaire d'habilitation Datapass (uniquement API en accès restreint). ATTENTION : retirer ce champ si vous utilisez le champ ci-dessus "account_link".
is_france_connected: 1 # 📍 -1 L'API n'est pas FranceConnectée ; 1 L'API est FranceConnectée.
access_page:
- who:
- Un particulier
is_eligible: -1
description: |
L’usage de l’API Particulier est **uniquement reservé aux acteurs publics** : les administrations, les collectivités, leurs opérateurs, les acteurs de santé, etc.
<Button href="/rechercher-api">Rechercher une autre API</Button>
- who:
- Une collectivité ou une administration
is_eligible: 1
description: |
L’API Particulier donne accès à l'API complémentaire santé solidaire et plus généralement aux données administratives des particuliers pour faciliter leurs démarches (cantines, titres de transport, aides sociales, démarches famille, etc...)<br/> Pour vérifier que l’API Particulier vous permet d’accéder aux données dont vous avez besoin, consultez le <External href="https://particulier.api.gouv.fr/catalogue">catalogue des API</External> et nos différents <External href="https://api.gouv.fr/les-api/api-particulier#exemples-d%E2%80%99application">cas d'usages</External>.
<p style="margin-left: 1rem; margin-right: 1rem;font-size: 0.9rem; line-height: 1.5rem;">Conformément aux dispositions de <External href="https://www.legifrance.gouv.fr/affichCodeArticle.do?cidTexte=LEGITEXT000031366350&idArticle=LEGIARTI000031367412&dateTexte=&categorieLien=cid">l'article L114-8 du Code des relations entre le public et l'administration</External> vous ne pourrez accéder qu'aux seules informations ou données strictement nécessaires pour traiter une démarche du particulier concerné.</p>
<NextSteps />
<p style="margin-top: 0rem; font-size: 0.9rem; line-height: 1.5rem;"> <External href="https://particulier.api.gouv.fr/faq#quelles-informations-me-seront-demandees">En savoir plus sur les informations demandées</External></p>
<QuestionTree tree='api-particulier' question='apipart'/>
- who:
- Une entreprise ou une association
is_eligible: -1
description: |
L’usage de l’API Particulier est **uniquement reservé aux acteurs publics** : les administrations, les collectivités, leurs opérateurs, les acteurs de santé, etc.
<Button href="/rechercher-api">Rechercher une autre API</Button>
Si vous êtes **éditeur de logiciels pour des acteurs publics, c'est à vos utilisateurs collectivité ou administration de faire une demande d'habilitation.** En revanche, vous pouvez nous demander de vous référencer sur un cas d'usage afin de proposer des formulaires pré-remplis et ainsi simplifier l'expérience de vos clients publics.
<External href="https://form.typeform.com/to/GU90FCIE">Demander à être référencé</External>
- who:
- Un éditeur de logiciel
is_eligible: -1
description: |
Si vous êtes **éditeur de logiciels pour des acteurs publics, c'est à vos utilisateurs collectivité ou administration de faire une demande d'habilitation.**
En revanche, vous pouvez nous demander de vous référencer sur un cas d'usage afin de proposer des formulaires pré-remplis et ainsi simplifier l'expérience de vos clients publics :
<Button href="https://form.typeform.com/to/GU90FCIE">Demander à être référencé</Button>
Pour toute autre demande, consultez notre page <External href="https://particulier.api.gouv.fr/faq">FAQ & contact</External>.
rate_limiting_resume: 20 appels / seconde / jeton # 📍 Volumétrie maximale de votre API.
rate_limiting_description: |
L'API est disponible à hauteur de 20 appels par secondes et par jeton d'accès.
# Phrase descriptive de la volumétrie
doc_tech_link: https://particulier.api.gouv.fr/api/open-api.yml # 📍 URL qui donne accès au swagger de votre API, sur la page API.gouv suivante : https://api.gouv.fr/documentation, accessible depuis le bouton "Tester l'API" sur la fiche de l'API. Pour en savoir plus, consulter le read.me.
doc_tech_external: https://particulier.api.gouv.fr/developpeurs/openapi#tag/Complementaire-sante-solidaire/paths/~1api~1v2~1complementaire-sante-solidaire/get # 📍 URL vers la documentation technique de l'API
monitoring_link: https://status.particulier.api.gouv.fr/
stats_detail_resume: Les statistiques sont disponibles sur 2 mois
stats_detail_description: |
Accédez au suivi des consommations de l'API
stats_detail_link: https://particulier.api.gouv.fr/stats
uptime: 98.011
themes:
- Administration
- Administration & législation
- Particulier
- Santé
- Transport
keywords:
- particulier
- complementaire
- sante
- solidaire
- C2S
- assuré
- assurance maladie
- mutuelle
last_update: 15/12/2023
content_intro: |
L'<External href="https://particulier.api.gouv.fr/catalogue/cnaf_msa/complementaire_sante_solidaire">API Complémentaire santé solidaire</External> permet de savoir si un particulier est bénéficiaire de la complémentaire santé solidaire (C2S). Elle fait partie du bouquet <External href="https://particulier.api.gouv.fr/catalogue">API Particulier</External>.
<Button href="https://particulier.api.gouv.fr/catalogue/cnaf_msa/complementaire_sante_solidaire">Consulter la documentation</Button>
---

86 changes: 86 additions & 0 deletions _data/api/api_quotient_familial_msa_caf.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,86 @@
---
title: API Quotient familial MSA & CAF # 📍 Nom commercial de l'API, privilégier un nom court.
tagline: Entités administratives, simplifiez les démarches des particuliers en récupérant pour eux leur quotient familial # 📍 Une phrase pour résumer le service rendu par l'API. Si votre API est uniquement accessible à certaines organisation, spécifiez-le dès maintenant.
producer: cnaf-msa # 📍 Identifiant du fournisseur de la donnée trouvable ou ajoutable dans le dossier `api_gouv/_data/producteurs`, pour en savoir plus consulter le read.me.
contact_link: [email protected] # 📍 Adresse e-mail que les usagers peuvent utiliser pour vous contacter.
partners:
- dinum
is_open: -1 # 📍 -1 si l'API est fermée, accessible à un public restreint sous habilitation ; 0 si un compte est nécessaire pour utiliser l'API mais qu'il n'y a pas de conditions pour se créer un compte.
datapass_link: https://datapass.api.gouv.fr/api-particulier # URL vers le formulaire d'habilitation Datapass (uniquement API en accès restreint). ATTENTION : retirer ce champ si vous utilisez le champ ci-dessus "account_link".
is_france_connected: 1 # 📍 -1 L'API n'est pas FranceConnectée ; 1 L'API est FranceConnectée.
access_page:
- who:
- Un particulier
is_eligible: -1
description: |
L’usage de l’API Particulier est **uniquement reservé aux acteurs publics** : les administrations, les collectivités, leurs opérateurs, les acteurs de santé, etc.
<Button href="/rechercher-api">Rechercher une autre API</Button>
- who:
- Une collectivité ou une administration
is_eligible: 1
description: |
L’API Particulier donne accès à l'API Quotient familial CAF & MSA et plus généralement aux données administratives des particuliers pour faciliter leurs démarches (cantines, titres de transport, aides sociales, démarches famille, etc...).<br/> Pour vérifier que l’API Particulier vous permet d’accéder aux données dont vous avez besoin, consultez le <External href="https://particulier.api.gouv.fr/catalogue">catalogue des API</External> et nos différents <External href="https://api.gouv.fr/les-api/api-particulier#exemples-d%E2%80%99application">cas d'usages</External>.
<p style="margin-left: 1rem; margin-right: 1rem;font-size: 0.9rem; line-height: 1.5rem;">Conformément aux dispositions de <External href="https://www.legifrance.gouv.fr/affichCodeArticle.do?cidTexte=LEGITEXT000031366350&idArticle=LEGIARTI000031367412&dateTexte=&categorieLien=cid">l'article L114-8 du Code des relations entre le public et l'administration</External> vous ne pourrez accéder qu'aux seules informations ou données strictement nécessaires pour traiter une démarche du particulier concerné.</p>
<NextSteps />
<p style="margin-top: 0rem; font-size: 0.9rem; line-height: 1.5rem;"> <External href="https://particulier.api.gouv.fr/faq#quelles-informations-me-seront-demandees">En savoir plus sur les informations demandées</External></p>
<QuestionTree tree='api-particulier' question='apipart'/>
- who:
- Une entreprise ou une association
is_eligible: -1
description: |
L’usage de l’API Particulier est **uniquement reservé aux acteurs publics** : les administrations, les collectivités, leurs opérateurs, les acteurs de santé, etc.
<Button href="/rechercher-api">Rechercher une autre API</Button>
Si vous êtes **éditeur de logiciels pour des acteurs publics, c'est à vos utilisateurs collectivité ou administration de faire une demande d'habilitation.** En revanche, vous pouvez nous demander de vous référencer sur un cas d'usage afin de proposer des formulaires pré-remplis et ainsi simplifier l'expérience de vos clients publics.
<External href="https://form.typeform.com/to/GU90FCIE">Demander à être référencé</External>
- who:
- Un éditeur de logiciel
is_eligible: -1
description: |
Si vous êtes **éditeur de logiciels pour des acteurs publics, c'est à vos utilisateurs collectivité ou administration de faire une demande d'habilitation.**
En revanche, vous pouvez nous demander de vous référencer sur un cas d'usage afin de proposer des formulaires pré-remplis et ainsi simplifier l'expérience de vos clients publics :
<Button href="https://form.typeform.com/to/GU90FCIE">Demander à être référencé</Button>
Pour toute autre demande, consultez notre page <External href="https://particulier.api.gouv.fr/faq">FAQ & contact</External>.
rate_limiting_resume: 20 appels / seconde / jeton # 📍 Volumétrie maximale de votre API.
rate_limiting_description: |
L'API est disponible à hauteur de 20 appels par secondes et par jeton d'accès.
# Phrase descriptive de la volumétrie
doc_tech_link: https://particulier.api.gouv.fr/api/open-api.yml # 📍 URL qui donne accès au swagger de votre API, sur la page API.gouv suivante : https://api.gouv.fr/documentation, accessible depuis le bouton "Tester l'API" sur la fiche de l'API. Pour en savoir plus, consulter le read.me.
doc_tech_external: https://particulier.api.gouv.fr/developpeurs/openapi#tag/Quotient-familial/paths/~1api~1v2~1composition-familiale-v2/get # 📍 URL vers la documentation technique de l'API
monitoring_link: https://status.particulier.api.gouv.fr/
stats_detail_resume: Les statistiques sont disponibles sur 2 mois
stats_detail_description: |
Accédez au suivi des consommations de l'API
stats_detail_link: https://particulier.api.gouv.fr/stats
uptime: 98.011
themes:
- Administration
- Administration & législation
- Particulier
keywords:
- composition
- quotient
- famille
- familial
- allocataire
- enfant
- adresse
last_update: 15/12/2023
content_intro: |
L'<External href="https://particulier.api.gouv.fr/catalogue/cnaf-msa/quotient_familial_v2">API Quotient familial MSA & CAF</External> permet de récupérer directement le quotient familial d'un particulier du régime général ou agricole. Elle fait partie du bouquet <External href="https://particulier.api.gouv.fr/catalogue">API Particulier</External>.
<Button href="https://particulier.api.gouv.fr/catalogue/cnaf-msa/quotient_familial_v2">Consulter la documentation</Button>
---

Loading

0 comments on commit 75be375

Please sign in to comment.