LeçonsComment afficher les données d’une API externe sur votre site

Mini-leçon 16 sur 30 · Relier données et IA

Ouvrez la recherche prête à l’emploi

À qui s’adresse cette leçon ?

Pour les personnes souhaitant afficher des informations actuelles d’un autre service. La page et l’assistant gèrent le code navigateur ; concentrez-vous sur le résultat.

Demandez une valeur au service au lieu de saisir un nombre fixe dans la page.

Objectif de cette leçon

  • Recherchez un vrai dépôt public.
  • Affichez un résultat supplémentaire utile avec un assistant.
  • Distinguez absence de dépôt et indisponibilité du service.
Explications, exemple détaillé et exercices

Avant de commencer

L’atelier fourni, Internet et un aperçu HTTP local que l’assistant peut démarrer. Cet exemple lit des dépôts GitHub publics sans jeton privé ; disponibilité et limites de requêtes s’appliquent.

Vérifiez vos acquis de départ

Ce sont des compétences utiles, pas des cours obligatoires bloquants. Si vous les maîtrisez, commencez ici ; sinon, ouvrez la préparation. Les fichiers fournis remplacent un site personnel préalable.

  1. Comment créer votre premier site personnel

    Créez une présentation, une rubrique projets et un accès au contact à partir du modèle fourni.

Durée estimée: 14–26 min

Estimations avec les fichiers fournis et les comptes et outils requis déjà prêts. La configuration, les files de déploiement et les délais de messagerie ou de DNS demandent du temps supplémentaire. Les requêtes GitHub sans authentification partagent un quota lié à l’adresse IP ; des tests répétés peuvent l’atteindre.

Comprendre le principe

Faites démarrer le dossier public fourni sur HTTP. Utilisez l’exemple octocat / Hello-World du modèle et activez le bouton de recherche.

Comparez l’identité et le nombre renvoyés avec le résultat du service à cet instant. Ne figez pas un ancien nombre dans le code comme s’il était actuel.

Un exemple concret

Un nombre d’étoiles enregistré dans le texte de la page ne peut pas suivre les changements du dépôt.

Démarre la recherche de dépôt public sur HTTP local. Préserve le rendu texte sûr et n’ajoute aucun jeton privé aux fichiers navigateur. Aide-moi à tester un dépôt réel, un dépôt absent et une requête en échec. Ajoute ensuite le nombre documenté d’éléments ouverts et aide-moi à le comparer à la réponse API. Gère le code pour moi.

Fichiers de cette étape

Commencer iciFichiers de l’atelier

Ouvrez ou téléchargez les fichiers ci-dessous. Enregistrez le projet en conservant les chemins indiqués.

À vous de jouer

Quel dépôt avez-vous recherché et quel résultat la page exécutée a-t-elle réellement affiché ?

Afficher une solution détaillée

Exemple de recherche avec nombre inventé : « Lors du test, j’ai demandé octocat / Hello-World. La page a retourné octocat/Hello-World et 12 stars ; l’identité et le nombre correspondaient à la réponse inspectée. » 12 est une mesure fictive pour cet exemple, pas un fait actuel sur ce dépôt.

Le nombre d’étoiles peut changer. Votre relevé doit contenir celui et l’heure réellement observés ; sans réponse du service, notez cet état au lieu d’utiliser le nombre d’exemple.

Éléments d’une réponse solide

  • Nomme le propriétaire/dépôt public réellement demandé et l’identité retournée.
  • Rapporte le nombre et l’heure observés ou l’échec précis sans figer une valeur d’exemple.
Comment ça marche (facultatif)

Affichez les données d’un autre service

Chargez depuis GitHub le nom, la description et le nombre d’étoiles d’un dépôt public.

Une API est une manière définie pour un logiciel de demander des données ou une action. Ici, votre site demande un dépôt à GitHub et reçoit du JSON plutôt qu’une page HTML.

Nous utilisons une lecture publique pour apprendre à gérer les requêtes sans commencer par l’authentification. Le résultat peut changer entre deux requêtes ; c’est une observation actuelle, pas un nombre à inscrire en dur.

Exemple détaillé

Pour le propriétaire octocat et le dépôt Hello-World, le chemin demandé est /repos/octocat/Hello-World sur api.github.com. La page affiche les champs full_name et stargazers_count reçus.

GitHub : obtenir un dépôt

Exercice technique complémentaire

Quelle différence y a-t-il entre copier un nombre d’étoiles dans le HTML et le récupérer quand on appuie sur le bouton ?

Afficher une solution détaillée

Le HTML copié conserve l’ancienne valeur jusqu’à sa modification. Un fetch demande la réponse actuelle à cet instant, mais exige de gérer le chargement et les échecs, car le service ou le réseau peut ne pas répondre.

  • Explique à quel moment la valeur est obtenue.
  • Reconnaît que la requête externe peut échouer.

Étape 1 · Comment afficher les données d’une API externe sur votre site

Vérifiez une réponse réussie

Utilisez une observation comparable à la source.

Explications, exemple détaillé et exercices

Comprendre le principe

Demandez d’afficher la réponse API publique correspondant au dépôt de test et vérifiez les valeurs affichées. Gardez le test public et non sensible.

Une requête retournant une erreur ne doit pas être traitée comme un résultat normal. Vous n’avez pas à écrire le code de requête/erreur pour juger le résultat visible.

Un exemple concret

Valeurs illustratives : full_name = practice/example et stargazers_count = 12 doivent devenir le nom visible practice/example et 12 stars. Ces valeurs fictives expliquent la correspondance, pas le nombre actuel de l’exemple GitHub fourni.

Fichiers de cette étape

Commencer iciFichiers de l’atelier

Ouvrez ou téléchargez les fichiers ci-dessous. Enregistrez le projet en conservant les chemins indiqués.

À vous de jouer

Le résultat de la page correspondait-il à la réponse du dépôt examinée ?

Afficher une solution détaillée

Correspondance illustrative avec valeurs fictives : une réponse contenant full_name = practice/example et stargazers_count = 12 doit afficher practice/example et 12 stars. Elle ne doit pas garder le nom du dépôt précédent ni transformer un nombre absent en zéro.

Pour le test réel, utilisez la réponse du dépôt demandé au moment du test. Une réponse de limitation de débit ne fournit aucun résultat normal d’étoiles à afficher.

Éléments d’une réponse solide

  • Associe l’identité et le nombre d’étoiles de la page à la même réponse du service public.
  • Ne présente pas une erreur ou un champ absent comme un résultat normal valant zéro.
Comment ça marche (facultatif)

Construisez et vérifiez une requête

Encodez la saisie de l’utilisateur et examinez la réponse avant de l’utiliser.

Lisez public/app.js et exécutez la page fournie en HTTP. encodeURIComponent garde chaque valeur de propriétaire ou de dépôt dans son propre segment de chemin. L’hôte est fixe ; le visiteur ne fournit pas une destination arbitraire.

fetch se résout même pour des erreurs HTTP comme 404 : attendre son résultat ne suffit donc pas. Vérifiez response.ok et les statuts pertinents, analysez le JSON, puis vérifiez les champs nécessaires à la fonction. textContent affiche les chaînes externes comme du texte.

Le court extrait ci-dessous illustre le contrôle HTTP général. Le fichier app.js complet traite d’abord spécifiquement les réponses 404 et celles liées aux restrictions ou limites de requêtes, puis vérifie les autres statuts d’échec, analyse le JSON et valide les champs. Conservez cet ordre lorsque vous ajoutez un champ affiché.

Exemple détaillé

Une description contenant des chevrons doit rester du texte visible et ne pas devenir du balisage de page. Un 404 doit afficher un message d’absence ou d’accès public manquant, plutôt qu’une carte de réussite vide.

if (!response.ok) throw Error('Request failed');
const data = await response.json();
result.textContent = data.full_name;

Exercice technique complémentaire

Pourquoi try/catch ne détecte-t-il pas à lui seul toutes les réponses HTTP en échec ?

Afficher une solution détaillée

Les erreurs HTTP peuvent quand même produire un objet Response normal. Vérifiez status/ok et déclenchez ou traitez l’erreur avant de considérer son corps comme le dépôt demandé.

  • Sait que fetch peut se résoudre avec 404 ou 500.
  • Vérifie le statut avant d’afficher une réussite.

Étape 2 · Comment afficher les données d’une API externe sur votre site

Essayez absence et indisponibilité

Rendez les différents échecs compréhensibles.

Explications, exemple détaillé et exercices

Comprendre le principe

Essayez un nom de dépôt inexistant. Avec l’assistant, testez aussi une requête bloquée/ratée dans la page locale. Gardez la recherche saisie pour corriger ou réessayer.

La page doit distinguer dépôt absent et panne temporaire. N’ajoutez pas de jeton privé au navigateur pour contourner une limite de requêtes.

Un exemple concret

« Dépôt introuvable » et « Service indisponible ; réessayez » proposent au visiteur des actions suivantes différentes.

Fichiers de cette étape

Commencer iciFichiers de l’atelier

Ouvrez ou téléchargez les fichiers ci-dessous. Enregistrez le projet en conservant les chemins indiqués.

À vous de jouer

Qu’ont montré les deux échecs et le visiteur pouvait-il poursuivre ?

Afficher une solution détaillée

Exemple d’erreur : « Un dépôt inventé a affiché Repository not found or not publicly accessible. Une requête bloquée volontairement pour le test local a produit une erreur ; les champs propriétaire/dépôt restaient disponibles et le bouton pouvait être réessayé. »

La requête bloquée est une simulation, pas la preuve d’une panne GitHub. Une limite de débit doit mener à un nouvel essai plus tard, pas à une clé de compte privée dans le code public.

Éléments d’une réponse solide

  • Consigne des résultats distincts pour un dépôt absent et un test assisté de requête échouée.
  • Vérifie que la recherche reste corrigeable ou relançable sans ajouter de jeton privé dans le navigateur.
Comment ça marche (facultatif)

Rendez les états d’échec distincts

L’absence de dépôt, l’absence de réseau et l’épuisement du quota sont des problèmes différents.

Testez un vrai dépôt public, un nom manifestement inexistant et le mode hors connexion du navigateur. L’interface efface l’ancien résultat avant une nouvelle requête, empêche les doubles envois et réactive ensuite le bouton.

GitHub peut rejeter les requêtes non authentifiées à cause de limites liées à l’IP. N’y répondez pas en plaçant un jeton privé dans le navigateur. Pour un usage authentifié régulier, utilisez les identifiants dans une route serveur contrôlée et mettez en cache lorsque c’est approprié.

Exemple détaillé

Si une carte de réussite reste visible sous “Not found” (introuvable), un visiteur peut prendre des données anciennes pour le nouveau résultat. Effacer l’ancien résultat rend l’état de la requête actuelle sans ambiguïté.

GitHub : limites de requêtes de l’API REST

Exercice technique complémentaire

Une recherche échoue après de nombreux tests. L’interface doit-elle annoncer que le dépôt a zéro étoile ?

Afficher une solution détaillée

Non. Zéro est une véritable valeur de données. Signalez des données indisponibles ou restreintes et examinez le statut ; le nombre est inconnu tant qu’une réponse réussie ne le fournit pas.

  • Ne transforme pas des données indisponibles en zéro.
  • Vérifie le statut de la requête et les indices relatifs au quota.

Étape 3 · Comment afficher les données d’une API externe sur votre site

Ajoutez un résultat utile

Décrivez l’information nouvelle et laissez l’assistant la connecter.

Explications, exemple détaillé et exercices

Comprendre le principe

Demandez d’ajouter open_issues_count à côté du résultat existant et de l’intituler open issues and pull requests. Ce total GitHub comprend les deux catégories ; il ne doit pas devenir un simple nombre de bugs. Consultez la référence après avoir essayé votre version.

Comparez la valeur affichée à la réponse réelle, puis répétez réussite, dépôt absent et indisponibilité. Vous jugez le sens et les états observés ; l’assistant réalise le code du navigateur.

Un exemple concret

Un open_issues_count fictif de 5 pourrait représenter deux issues ouvertes et trois pull requests ouvertes. « 5 bugs » affirmerait quelque chose que ce champ ne démontre pas.

Fichiers de cette étape

Commencer iciFichiers de l’atelier

Ouvrez ou téléchargez les fichiers ci-dessous. Enregistrez le projet en conservant les chemins indiqués.

À vous de jouer

Ajoutez le total des issues et pull requests ouvertes. Comment la valeur affichée correspondait-elle à la réponse, et qu’ont donné les tests absent/indisponible ?

Travail à rendre: La page modifiée et les résultats observés normal, absent et échec du service.

Afficher une solution détaillée

Exemple de correspondance : « Pour une réponse fictive open_issues_count = 5, la page montre 5 open issues and pull requests. Le total peut inclure deux issues et trois pull requests ; ce n’est pas un compte de cinq bugs. »

Exemple de test : « La recherche normale correspondait à la réponse ; le dépôt absent gardait son message introuvable ; le blocage simulé conservait une erreur réessayable. » Fournissez votre valeur réelle comparée et nommez les contrôles non effectués.

Éléments d’une réponse solide

  • Affiche open_issues_count comme open issues and pull requests, pas seulement comme bugs ou issues.
  • Compare la nouvelle valeur à une réponse et répète les états normal, absent et indisponible.
Comment ça marche (facultatif)

Votre devoir : ajouter un champ de dépôt utile

Ajoutez un nombre de tickets en préservant une distinction claire entre données et erreurs.

Affichez open_issues_count après avoir vérifié qu’il s’agit d’un nombre fini. Notez que le total GitHub comprend les demandes de fusion, comme indiqué dans la documentation ; ne le présentez pas comme un décompte exact des seuls rapports de bogues.

Consignez une recherche réussie, un dépôt absent et un essai hors connexion. Incluez ce que voit le visiteur pendant la requête et après chaque issue.

Exemple détaillé

Un libellé comme “Open issues and pull requests” (tickets et demandes de fusion ouverts) décrit la mesure plus précisément que “Bugs” (bogues).

Le parcours de référence complet est disponible dans reference/assignment-walkthrough.txt. Comparez ses étapes avec votre résultat ; remplissez le relevé de test à partir de vos propres observations sur votre projet.

Exercice technique complémentaire

Complétez le résultat avec le décompte documenté des éléments ouverts et démontrez les trois états.

Afficher une solution détaillée

Ajoutez open_issues_count aux champs validés après le traitement des statuts réussis. Exigez un nombre fini, puis utilisez le libellé 'Open issues and pull requests', car ce champ de dépôt GitHub comprend les deux. Le script de référence complet conserve l’affichage par textContent et les états de chargement et d’erreur existants.

Jeu de données d’exemple : full_name='sample/site', stargazers_count=3, open_issues_count=2 produit 'sample/site — 3 stars — 2 open issues and pull requests'. Cela affiche trois étoiles et deux tickets ou demandes de fusion ouverts, sans affirmer que les deux éléments sont des bogues.

Testez à nouveau un dépôt public valide, un 404 et le mode hors connexion. Effacez la carte précédente au début de la recherche suivante ; une erreur ne doit ni conserver des nombres périmés ni remplacer des données indisponibles par zéro.

  • Valide le nombre ajouté et le désigne avec précision.
  • Aucune ancienne réussite ne reste affichée après l’échec d’une nouvelle recherche.

Cette leçon vous a-t-elle été utile ?

Laissez un J’aime ou partagez-la avec quelqu’un qui pourrait en profiter.