Pas sûr de ce que fait réellement une API ?

Ce YouTube Short de 45 secondes l'explique avec une analogie de pub

Les API sont comme les accords entre les pubs et leurs fournisseurs.

Votre pub a besoin de bière. La brasserie fabrique de la bière. Vous êtes tous deux d'accord sur la façon dont les commandes sont passées, les livraisons sont effectuées et les paiements sont gérés.

Une bonne API, c'est comme…

Vous avez un fournisseur qui se souvient exactement de ce que vous avez commandé la dernière fois, sait ce qu'il doit vous fournir à nouveau cette fois-ci, à temps, à chaque fois, et vous envoie une simple facture.

Tout fonctionne sans problème, avec un minimum d'effort requis de votre part.

Mauvaises API? Elles sont comme des fournisseurs peu fiables. Peut-être qu'ils vous apportent du vin au lieu de bière, même si vous ne l'avez pas demandé. Ou elles se présentent à 3h du matin alors que vous dormez. Ou elles changent soudainement leurs conditions de paiement sans vous prévenir.

Elles créent plus de problèmes qu'elles n'en résolvent.

Vous voulez une API qui se comporte comme un excellent fournisseur ? Commencez avec Firma, aucune carte de crédit requise