Qu'est-ce qu'une API ?
API est un acronyme anglais — Application Programming Interface — qui désigne un mécanisme permettant à deux systèmes informatiques de communiquer entre eux. Derrière ce terme technique se cache une idée simple : deux ordinateurs qui s'échangent des informations, automatiquement, par internet.
Une analogie : le serveur au restaurant
Imaginez un restaurant. Vous êtes assis à table, la cuisine est en arrière-salle. Vous ne pouvez pas y entrer directement. Le serveur joue le rôle d'intermédiaire : vous lui donnez votre commande, il la transmet à la cuisine, et revient avec votre plat.
Une API, c'est ce serveur — mais entre deux ordinateurs. Elle transmet une demande d'un système à un autre, récupère la réponse, et la renvoie, sans que les deux systèmes aient besoin de se connaître directement.
Un exemple concret
Lorsque vous utilisez une application météo sur votre téléphone, ce dernier ne dispose pas de capteurs pour mesurer la météo extérieure. Que fait l'application ? Elle envoie une demande, via une API, à un serveur météorologique, qui lui renvoie les données du moment. L'application affiche ensuite ces données — sans que vous ayez eu à les chercher vous-même —. Ce mécanisme de requête et d'affichage de données distantes est au cœur du fonctionnement de la majorité des applications connectées que vous utilisez au quotidien.
C'est exactement ce qui peut se passer pour les démarches administratives : par exemple, un formulaire en ligne peut être pré-rempli en interrogeant, via une API, un autre système informatique de l'État pour récupérer des informations, sans les demander à l'usager.
Les API du Dîtes-le nous une fois
L'administration française utilise de nombreuses données administratives : revenus fiscaux, quotient familial, statut d'une entreprise, attestations sociales… Ces données sont hébergées dans les systèmes informatiques des différentes administrations publiques.
Dans le cas d'une démarche qui n'est pas simplifiée par l'utilisation d'API, lorsqu'un usager effectue
la démarche, il lui est demandé de fournir lui-même ces informations sous forme de
pièces justificatives : avis d'imposition, certificat de scolarité, extrait Kbis…
C'est sur lui que repose la charge de faire transiter ces données pourtant connues de
l'administration.
Le principe du Dîtes-le nous une fois
La loi interdit désormais à une administration de demander à un usager une information qu'elle détient
déjà ou qu'une autre administration peut lui communiquer. Les API sont le principal outil technique
qui permet de mettre ce principe en pratique.
Comment cela se concrétise pour les usagers et les agents ?
Lorsqu'une démarche requiert une information sur un particulier, une entreprise ou une association, le formulaire en ligne ou le logiciel de l'agent peut interroger directement le système de l'administration détentrice de cette donnée, via une API. La réponse arrive en quelques secondes, et peut pré-remplir le formulaire pour l'usager et/ou afficher les informations dans le logiciel de l'agent.
Par exemple :- Une commune qui traite une demande de tarification sociale peut récupérer le quotient familial directement auprès de la CAF, sans demander d'attestation à la famille. Elle n'est plus contrainte à une mise à jour annuelle — souvent liée à la difficulté de collecter les justificatifs — et peut choisir de recalculer la tarification aussi souvent qu'elle le souhaite, en s'appuyant sur un quotient familial toujours à jour.
- Une entreprise qui candidate à un marché public n'a plus besoin de saisir les informations générales de sa société — dénomination, adresse, code NAF, etc. Ces données sont pré-remplies automatiquement via une API qui interroge le répertoire Sirene de l'Insee. Cet exemple est justement illustré par le démonstrateur ci-dessous.
Démonstrateur
Pour ce démonstrateur, votre ordinateur utilise internet pour demander à un autre ordinateur des informations à propos des entreprises françaises. Pour cela, il utilise l'API Sirene de l'Insee qui expose les données du répertoire Sirene.
Testez le fonctionnement de l'API en entrant le numéro de SIRET d'une entreprise ci-dessous :Par exemple, utilisez ce SIRET d'un établissement de La Poste : 35600000000048
Démonstrateur avec l'API Sirene
Interrogation de l'API en cours…
- Adresse
- Activité principale (Code NAF)
- Forme juridique (code)
- État administratif
Ces données ont été récupérées en temps réel auprès de l'API SIRENE, sans que vous ayez eu à les saisir manuellement.
Ce mécanisme — une requête automatique vers une source de données distante, un affichage instantané du résultat — est exactement ce qui se passe lorsqu'une démarche administrative est simplifiée par une API.
Données utilisées par l'API
Toute API utile pour simplifier une démarche repose sur un échange en deux temps : des données d'appel permettent d'identifier la personne ou l'entité concernée par la démarche, et des données de réponse la concernant sont renvoyées en retour.
-
Données d'appel — informations transmises à l'API pour identifier la personne ou
l'entité concernée.
Exemple avec le démonstrateur : le numéro SIRET de l'établissement est la donnée d'appel. -
Données de réponse — données renvoyées par l'API concernant l'entité ou la personne
renseignée en appel. Ces données sont celles attendues dans la démarche usager et que l'on souhaite
éviter de demander au particulier, à l'entreprise ou à l'association.
Exemple avec le démonstrateur : adresse, code NAF, forme juridique, état administratif sont les données de réponse de l'API.
D'où proviennent les données d'appel ?
Pour interroger une API, il faut disposer d'au moins une information permettant d'identifier l'entité concernée. Cette information peut provenir de deux sources :
- L'usager lui-même — par exemple, en saisissant son SIRET, en s'authentifiant via FranceConnect, ou en communiquant son numéro fiscal lors de sa démarche.
- L'agent en charge du dossier — via le système informatique de son administration (dossier existant, base de bénéficiaires…) ou, en guichet, via les informations transmises directement par l'usager.
Les données d'appel et de réponse visibles sur Simplifions.data
Sur chaque API référencée par Simplifions comme étant utile pour une démarche, vous retrouverez ces deux types d'informations sous des libellés spécifiques :
- « Informations à saisir pour récupérer la donnée » correspond aux données d'appel ;
- « Données disponibles » correspond aux données de réponse.
En résumé, avant de rechercher une API, posez-vous ces deux questions :
-
De quelles informations disposez-vous pour appeler l'API ?
Les données disponibles — côté agent ou côté usager — correspondent-elles aux paramètres d'appel acceptés par l'API ?
Par exemple, si une API n'accepte que le numéro étudiant, elle ne pourra pas être utilisée si vous ne disposez que de l'état civil. -
Quelles informations souhaitez-vous obtenir en retour ?
Les données renvoyées par l'API couvrent-elles bien ce dont vous avez besoin pour instruire la démarche ?
Les API clés pour la simplification des démarches
La mise en œuvre du Dîtes-le nous une fois reposant en grande partie sur des échanges de données, différentes administrations mettent à disposition des API dédiées à cet objectif.
La direction générale des finances publiques a également mis en œuvre deux API dédiées à la simplification des démarches des particuliers. Toutes deux délivrent les mêmes données en réponse, dont notamment le revenu fiscal de référence. C'est leurs données d'appel qui divergent : l'API Impôt particulier requiert le numéro fiscal ou une connexion via FranceConnect ; l'API SFIP requiert les données d'état civil du particulier.
L'utilisation de l'API FranceConnect permet d'utiliser en données d'appel une connexion de l'usager via FranceConnect. Les API proposant ce paramètre d'appel sont prénommées des « API FranceConnectées ».
Les API FranceConnectéesQui peut utiliser ces API ?
Ces API sont en accès restreint : seules les administrations et les organismes chargés d'une mission de service public peuvent y accéder, après habilitation. Cela garantit que les données personnelles et confidentielles ne circulent qu'entre les entités qui ont un droit légal de les consulter.
En pratique, l'accès se fait souvent de façon transparente pour les agents : c'est le logiciel métier qu'ils utilisent au quotidien qui est branché à ces API. Les agents bénéficient alors de l'accès à ces données sans même avoir connaissance de l'existence de ces API.
Simplifions.data.gouv.fr référence les logiciels métiers déjà raccordés à l'API Entreprise et à l'API Particulier. Si votre logiciel est dans la liste, vous bénéficiez peut-être déjà de ces données sans le savoir.
Logiciels éditeurs raccordés à l'API Particulier Logiciels éditeurs raccordés à l'API Entreprise
Lire plus • Bouquet d'API, API à l'unité, API FranceConnectée : identifier qui contacter selon le type d'API.
Vos interlocuteurs selon le type d'APIRécapitulatif
- Une API est un intermédiaire qui permet à deux systèmes informatiques de s'échanger des données automatiquement, par internet.
- Les API sont un outil majeur pour appliquer le principe du Dîtes-le nous une fois.
- Toute API repose sur des données d'appel (pour identifier le particulier, l'association ou l'entreprise recherchée) et des données de réponse (les informations renvoyées).
- Avant de chercher une API, vérifiez que vous disposez des données d'appel nécessaires et que les données de réponse couvrent votre besoin.
- L'API Entreprise et l'API Particulier (DINUM) centralisent de nombreuses données des entreprises, associations et particuliers auprès de multiples organismes.
- D'autres API spécialisées existent : l'API Impôt Particulier et l'API SFIP (DGFiP) pour les données fiscales, FranceConnect pour utiliser une connexion usager comme donnée d'appel et accéder aux API FranceConnectées.
Pour que les administrations n'aient pas à brancher des dizaines de connexions différentes à chaque source de données, la direction interministérielle du numérique (DINUM) a créé deux API centralisatrices, chacune spécialisée dans un type d'usager.