• Guide métier

  • Définition

  • API

  • API FranceConnectées

Les API FranceConnectées

Les API FranceConnectées donnent accès à diverses données administratives des particuliers en proposant FranceConnect comme modalité d'appel. Elles permettent de simplifier les démarches d'un particulier utilisant FranceConnect en récupérant automatiquement d'autres informations administratives le concernant.

Cet article s'adresse principalement à : DSI · MOA · Éditeur de logiciels

Définition

Dans l'administration, on parle d'« API FranceConnectée » :

Lorsqu'une API est interrogée via le bouton FranceConnect ...

Les API FranceConnectées permettent d'utiliser l'identité pivot fournie par FranceConnect comme modalité d'appel.

... et lorsqu'elle délivre des données administratives des particuliers.

Elles permettent de transmettre des données administratives personnelles du citoyen.

Selon le cadre d'utilisation, elles proposent également de récupérer l'identité pivot utilisée et fournie par FranceConnect.

Les acteurs des API FranceConnectées

FranceConnect et les fournisseurs d'identité :

Lors de l'intégration d'une API FranceConnectée dans votre service, il est pré-requis d'intégrer la solution FranceConnect car le bouton "FranceConnect" sera la modalité d'appel utilisée par l'API pour renvoyer les données à l'usager.

En proposant le bouton FranceConnect sur votre service, vous permettez à vos usagers d'utiliser le fournisseur d'identité qu'il souhaitent pour s'authentifier (impots.gouv.fr, ameli.fr, l'Identité Numérique La Poste, etc.).

FranceConnect, votre interlocuteur pour l'ajout du bouton FranceConnect :
FranceConnect est votre interlocuteur pour intégrer le bouton FranceConnect, de l'habilitation à l'homologation, en passant par l'intégration. Par contre FranceConnect n'est pas en mesure de répondre à vos questions sur les données distribuées via les API FranceConnectées.

Les fournisseurs d'identité, par défaut proposés à vos usagers :
Les fournisseurs d'identité ne seront jamais vos interlocuteurs. En intégrant FranceConnect, tous les fournisseurs d'identité seront proposés à vos usagers quand ils cliqueront sur le bouton FranceConnect.

FranceConnect

FranceConnect est une solution d’identification et d’authentification numérique des particuliers. Il s'agit d'un pont entre un bouton de connexion, le bouton FranceConnect, et la partie authentifiée de votre service.

Solution publique | DINUM

Les fournisseurs de données, vos interlocuteurs pour l'accès aux données :

Différentes administrations mettent à disposition, après habilitation et via des API FranceConnectées, les données administratives des particuliers dont elles ont la charge. Dans l'univers des API FranceConnectées, ces administrations sont nommées fournisseurs de données.

En voici la liste : Caisse nationale des allocations familiales (CNAF), Direction de la Sécurité sociale, Direction générale des finances publiques (DGFIP), France Travail, Ministère de l'Enseignement supérieur et de la Recherche, Ministère de l'Éducation nationale et Cnous.

💬 Rôle des fournisseurs de données :
Les fournisseurs de données sont vos interlocuteurs concernant la délivrance des accès, l'intégration et la maintenance des API FranceConnectées. C'est eux qui sont en mesure de répondre à vos questions concernant les données distribuées et le fonctionnement des API qu'ils opèrent.
Si vous utilisez l'API Particulier, ce service sera votre interlocuteur unique.

Afin de simplifier l'intégration des API FranceConnectées, la solution API Particulier regroupe dans un même bouquet d'API une grande partie des API FranceConnectées.

API Particulier, un seul interlocuteur pour les données de différents fournisseurs :
Si vous accédez aux API FranceConnectées via ce bouquet d'API, API Particulier est votre interlocuteur unique pour l'habilitation, l'intégration et la maintenance des API FranceConnectées du bouquet. API Particulier est en mesure de répondre à vos questions concernant les données distribuées et le fonctionnement des API qu'il propose. En cas de difficulté, API Particulier se charge des échanges avec les fournisseurs de données.

Bouquet API Particulier

API distribuant les données des particuliers détenues par différentes administrations.

Solution publique | DINUM

Possibilités de simplification

Voici un comparatif entre une API appelée via une modalité d'appel classique identifiant ou état civil et une API appelée en mode "FranceConnectée", c'est-à-dire via l'identité pivot FranceConnect :

Modalité d'appel
Identité pivot ou Identifiant		 Modalité d'appel
FranceConnect
Étapes du parcours de l'usager
  1. L'usager se connecte via son compte personnel authentifié ou via FranceConnect ;
  2. Au cours de sa démarche, il recherche les informations nécessaires pour permettre l'appel aux API ne proposant pas la modalité d'appel FranceConnect ; comme par exemple son numéro fiscal, son état civil ou son identifiant FranceTravail ;
  3. Il saisit ces informations ;
  4. Sa démarche est complétée des données récupérées via les API.
  1. L'usager se connecte via FranceConnect ;
  2. La démarche est déjà pré-remplie des informations récupérées via les API.
Authentification de l'usager ❌ À vérifier par vos agents ✅ Comprise avec la connexion
Délivrance instantanée de données administratives complémentaires issues des API FranceConnectées ❌ Uniquement après vérification de l'identité de l'internaute par vos agents ✅ Oui
Moins de données personnelles dans votre système d'information ❌ Les données personnelles renseignées par l'usager pour appeler l'API transitent par votre système d'information ✅ Il est possible de choisir que l'identité pivot ne transite pas par votre système d'information
Périmètre des usagers couverts ✅ La totalité ⚠️ Seulement les usagers ayant FranceConnect

Liste des API FranceConnectées

Voici la liste des API pouvant être requêtées via un token FranceConnect :

Sont mentionnés dans cet article :

  • FranceConnect

    Pour simplifier les démarches des Particuliers

    Solution publique | DINUM

  • Bouquet API Particulier

    Pour simplifier les démarches des Particuliers

    Solution publique | DINUM