Aller au contenu

Formations Thème

Formateur API REST

Concevoir une API que d'autres peuvent consommer, et la documenter pour qu'ils le fassent sans vous.

Demander une interventionVoir les programmes

Transfert de lanceur · archive du domaine public

Construire l’API, puis la rendre utilisable

Une API se juge à l’usage qu’en font ceux qui ne l’ont pas écrite. Les formations réunies ici tiennent les deux bouts : la conception et le développement d’une part, la documentation d’autre part — deux compétences que l’on suppose liées et qui, dans les faits, ne sont presque jamais portées par la même personne.

Le développement d’API REST en Python avec FastAPI traite le cheminement complet : modélisation des ressources, validation des entrées, codes de retour, authentification, versionnement. La documentation technique prend le relais sur OpenAPI et Swagger, et sur ce qui distingue une référence générée d’une documentation qu’on peut suivre. Les tests avancés et la qualité logicielle ferment la boucle : une API sans tests de contrat casse ses clients sans le savoir.

Le vrai sujet : la compatibilité dans le temps

Concevoir une API est facile. La faire évoluer sans casser les applications qui en dépendent est le métier — et c’est le point que les cursus traitent le moins, parce qu’il ne se voit qu’au bout de six mois d’exploitation.

Les sessions passent donc du temps sur ce qui coûte cher plus tard : ce qu’on peut ajouter à une réponse sans rien casser et ce qu’on ne peut pas, pourquoi un code de retour mal choisi se paie en support, comment une documentation générée diverge du comportement réel. Ces questions débordent naturellement vers les tests et l’intégration continue et vers les bases de données, une API n’étant le plus souvent qu’une façade posée devant un modèle de données.

Où et comment

Interventions à Amiens, Paris et Lille, ailleurs sur devis, et en distanciel — c’est un des sujets qui passe le mieux à distance, chacun travaillant sur sa propre machine. Formats courts en école (BTS, licence professionnelle, école d’ingénieur) comme sessions intra-entreprise. Qui intervient, et sur quelles bases.

Au catalogue

Les formations api

Tout le catalogue

Conformité

Ce que votre certification Qualiopi exige d’un intervenant externe

C’est votre organisme qui est certifié Qualiopi, et c’est lui que l’audit contrôle — y compris sur les intervenants qu’il fait venir. Faire intervenir un formateur externe ne vous fait rien perdre, à condition qu’il produise ses pièces. Les miennes partent avec chaque intervention :

Un programme opposable
Objectifs formulés en termes de capacités observables, prérequis, durée, public visé et contenu séquencé. C'est la pièce que l'auditeur ouvre en premier, et celle qui manque le plus souvent quand l'intervenant est externe.
Des modalités d’évaluation écrites
Critères de réussite et modalités d'évaluation des acquis, définis avant la session et adossés à votre référentiel si vous m'en communiquez un. Une évaluation improvisée en fin de parcours ne se justifie pas devant un auditeur.
La traçabilité de la session
Feuilles d'émargement par demi-journée, attestation de fin de formation et relevé des acquis, transmis sans qu'il faille les réclamer.
L’évaluation à chaud, transmise brute
Les retours des stagiaires vous parviennent tels quels, y compris les mauvais. Un questionnaire filtré par l'intervenant n'a aucune valeur dans un audit, et aucune pour vous.
L’accessibilité traitée en amont
Les situations de handicap se préparent avant la session, pas le matin même : besoin signalé, aménagement décidé ensemble, ou orientation vers votre référent si l'adaptation dépasse ce que je peux faire.
Le maintien à jour des compétences
CV d'intervenant et preuves d'actualisation des compétences sur les sujets enseignés — le référentiel les demande, et sur des sujets techniques qui bougent vite, c'est aussi ce qui distingue un programme vivant d'un support recyclé.

Questions fréquentes

Ce qu’on me demande avant de signer

Quelle est la différence entre une formation API REST et une formation Python ?
Une formation Python enseigne un langage ; une formation API enseigne un contrat. On y traite la modélisation des ressources, les codes de retour, le versionnement et l'authentification — des décisions qui survivent au langage. FastAPI sert de support parce qu'il rend ces décisions explicites, mais l'essentiel se transpose à toute autre pile.
Faut-il maîtriser Python avant de suivre le module API ?
Il faut savoir écrire une fonction, manipuler des dictionnaires et lire une trace d'erreur. Un groupe qui découvre le langage passera la session à se battre avec la syntaxe au lieu de discuter conception : dans ce cas, Algorithmique fondamentale vient d'abord.
La documentation d'API peut-elle faire l'objet d'un module séparé ?
Oui, et c'est fréquent. Documentation technique se donne indépendamment, y compris à un public non développeur : rédacteurs techniques, chefs de produit, ingénieurs support. Le module part alors d'une API existante — la vôtre, de préférence.

Un besoin, un groupe, une date ?

Décrivez le contexte : niveau réel du groupe, volume horaire visé, période. Réponse sous deux jours ouvrés, avec un programme ajusté et un tarif — pas un catalogue à trier.

Décrire votre besoinQui intervient