Une API est une porte entre des programmes. Au lieu d’une personne qui clique sur des boutons à l’écran, un programme envoie une requête sous une forme convenue, et un autre programme répond sous une forme convenue. Le mot interface est la clé : il décrit ce que vous pouvez demander et ce que vous recevez en retour, pas la façon dont la réponse est produite.

L’abréviation signifie Application Programming Interface. On l’emploie pour tout, des fonctions qu’offre un langage de programmation aux services web qu’une entreprise ouvre à ses clients. Cette fiche porte sur le second cas, l’API web.

À quoi ressemble une API web

Une API web fonctionne avec le même protocole que les sites web, HTTP. Un programme envoie une requête à une adresse et reçoit une réponse, le plus souvent écrite en JSON, un format texte simple pour des données structurées. L’exemple ci-dessous ne sert qu’à illustrer la forme.

GET /api/sites HTTP/1.1
Authorization: Bearer YOUR_KEY

200 OK
{"sites": [{"name": "Shop", "status": "up"}]}

La requête indique ce qui est demandé (l’adresse et la méthode) et prouve qui demande (la clé). La réponse porte un code d’état qui indique si cela a fonctionné. Consultez les codes d’état HTTP pour savoir ce que ces nombres signifient.

À quoi sert une API

  • Lire des données dans un autre outil, comme un rapport, un tableur ou un tableau de bord.
  • Relier des services, pour qu’un événement dans l’un déclenche une action dans l’autre.
  • Automatiser, lorsqu’un script fait à intervalles réguliers ce qu’une personne ferait à la main.
  • Construire sur un service, lorsqu’une entreprise crée sa propre application à partir de données qu’elle ne stocke pas elle-même.

Lecture seule et lecture-écriture

Une API peut vous permettre seulement de regarder, ou aussi de modifier des choses. Une API en lecture seule peut afficher des données, mais ne peut rien créer, modifier ni supprimer. Si une clé en lecture seule fuite, des informations peuvent fuiter, mais le compte ne peut pas être endommagé. Une API en lecture-écriture est plus puissante et demande plus d’attention sur qui détient la clé.

Idées reçues

  • « Une API, c’est la même chose qu’un site web. » Un site web est fait pour être lu par des personnes. Une API est faite pour des programmes, et n’a généralement aucune page.
  • « Une clé, c’est la même chose qu’un mot de passe. » Une clé identifie un programme et définit ce qu’il peut faire. Elle doit rester aussi secrète qu’un mot de passe, mais elle est généralement créée pour un seul usage, de sorte qu’on peut la révoquer sans toucher à rien d’autre.
  • « Toute API est REST. » REST est un style d’API web parmi d’autres. Beaucoup d’API se disent REST tout en ne suivant qu’une partie de ses règles, et d’autres utilisent des styles différents.

API et surveillance

La surveillance et les API se rencontrent à deux endroits. Un moniteur peut vérifier qu’une API répond correctement et rapidement, car une API défaillante casse tout ce qui est construit dessus. Et un service de surveillance peut proposer sa propre API, pour que vous puissiez lire ses résultats dans d’autres outils.

UptimeWire propose une API en lecture seule dans les offres Business et Agency. Vos propres outils peuvent ainsi lire les données de surveillance de votre compte. Elle ne peut rien modifier dans le compte, et ses clés sont distinctes de celles de la connexion MCP destinée aux assistants d’IA.