API REST

API REST : Style d’interface web organisé autour de ressources adressables et des verbes HTTP, retenu sur la plupart des projets mobiles pour sa simplicité de cache et de débogage.

Famille « Technique ». La définition ci-dessus suffit pour suivre une réunion. La suite sert à écrire une exigence que personne ne pourra interpréter à sa façon.

Ce que recouvre API REST, concrètement

Ce que recouvre API REST finit toujours dans une ligne de devis, sous un intitulé plus vague. Nommer le mécanisme, c’est pouvoir comparer deux propositions au lieu de comparer deux totaux.

Sur un projet réel, la question ne se pose jamais en théorie : elle arrive dans un devis, dans une réunion de cadrage ou dans un rapport de recette.

La traduction en exigences

Dans un cahier des charges, API REST se traduit par une exigence mesurable : dans quelles conditions, avec quel volume, et à partir de quel seuil on considère que ce n’est plus tenu.

À écrire noir sur blanc, dans le chapitre qui correspond :

• Le volume de données attendu au lancement, puis à douze mois.
• Le comportement de l’application sans réseau, et ce qui doit rester consultable.
• Les délais d’affichage acceptables sur les écrans les plus consultés.
• L’hébergement retenu, sa localisation, et qui en paie l’abonnement mensuel.

Cette formulation se rédige avant la consultation, pas après réception des propositions : c’est elle qui rend deux devis comparables entre eux.

Le modèle de cahier des charges du guide reprend ces rubriques dans l’ordre attendu par une agence, et la grille de lecture des devis montre à quoi ressemble un chiffrage comparable.

Vérifier plutôt que croire

API REST ne se prouve pas par une capture d’écran. La recette doit produire une trace : un chiffre, un journal, un rapport.

• Demander une restauration de sauvegarde réellement exécutée, avec sa date.
• Déclencher une alerte pour vérifier qu’elle arrive bien à quelqu’un.
• Demander la facture d’hébergement du mois, pour éviter la découverte à six mois.

Ce qui n’est pas vérifié à la recette ne sera pas vérifié du tout : le jour de la mise en ligne, plus personne n’a le temps.

Les pièges à éviter

Sur ce point précis, voici ce qui coûte le plus cher aux porteurs de projet, dans l’ordre où on le rencontre.

• Recetter uniquement sur le Wi-Fi du bureau, puis découvrir le comportement réel en mobilité.
• Oublier le mode dégradé : ce que l’application affiche quand le serveur ne répond pas.
• Laisser les intégrations tierces sans limite d’appel ni conduite à tenir en cas de panne du fournisseur.
• Sortir la supervision et les alertes du périmètre pour tenir le budget initial.
• Confier la décision au prestataire, puis la contester au moment de la recette.

Termes liés

Les entrées du glossaire déjà publiées sur des sujets voisins :

• Webhook
• Notification push
• Lien profond
• Feature flag
• Mode Doze

Questions fréquentes

Que signifie « API REST » ?

Style d’interface web organisé autour de ressources adressables et des verbes HTTP, retenu sur la plupart des projets mobiles pour sa simplicité de cache et de débogage. Le mot est employé tel quel par les équipes francophones. C’est celui à utiliser dans les échanges avec une agence, y compris quand la traduction française existe.

Qui vérifie que c’est bien fait ?

Le client, à la recette, avec un critère écrit à l’avance. À défaut, personne : ces sujets ne se voient pas à l’écran, et un utilisateur ne signale que leurs conséquences.

Par où commencer quand le sujet est nouveau ?

Par les parcours et les règles de gestion, pas par les outils. Le guide du cahier des charges donne l’ordre dans lequel poser les questions à une agence.

Toutes les définitions publiées sont rassemblées dans l’index du glossaire, classées de A à Z et par famille.