Créer une API d’objets trouvés est un projet pratique en Go destiné aux personnes qui connaissent les bases du langage et souhaitent fournir des données utiles par HTTP. Complétez une API en lecture seule pour un catalogue communautaire d’objets trouvés, puis utilisez le site préparé pour rechercher des objets et consulter leurs détails.
Deux laboratoires guidés vous conduisent d’un exemple fonctionnel contenant un objet aux réponses du catalogue complet, aux gestionnaires réutilisables, à la recherche et aux erreurs prévisibles. Un défi indépendant applique le même contrat à un autre bureau d’objets trouvés. Chaque unité dispose de son propre environnement et de ses données préparés ; aucun fichier du laboratoire précédent n’est nécessaire. Prévoyez environ 120 à 160 minutes, une estimation de l’auteur qui comprend la lecture et les corrections courantes.
Ce que vous apprendrez
À la fin du cours, vous saurez :
- associer les chemins et méthodes des requêtes aux gestionnaires HTTP de Go et aux réponses JSON ;
- retourner tous les enregistrements du catalogue et identifier chaque objet par son ID, même lorsque les noms sont identiques ;
- combiner les filtres de catégorie et de mot-clé pour que chaque résultat satisfasse les deux conditions ;
- distinguer une liste vide d’une requête invalide, d’un objet introuvable et d’une méthode non prise en charge ;
- tester des gestionnaires avec
httptesten vérifiant ensemble le statut, le contenu et la forme du JSON ; - utiliser un véritable site qui lit votre API tout en conservant le catalogue et la page fournis.
À qui s’adresse ce cours
Ce cours s’adresse aux personnes qui apprennent Go et sont prêtes à combiner des structures de données et des fonctions connues dans un petit service.
Prérequis : Navigation élémentaire dans le terminal, structures, slices, maps, fonctions et modules de Go. Le traitement HTTP, l’encodage JSON, la gestion explicite des erreurs et les tests des gestionnaires sont expliqués avant leur utilisation. Aucune expérience des frameworks web ou des bases de données n’est nécessaire.
Environnement d’apprentissage : LabEx fournit Go, le code de départ, les données du catalogue et un WebIDE dans le navigateur. Utilisez le terminal Workspace et le site Lost and Found pour créer et essayer le service sans installer Go localement. Le site, les libellés d’interface, les commandes et les sorties du programme restent en anglais.
Questions fréquentes
Vais-je aussi créer le site web ?
Le site est déjà préparé. Votre travail consiste à réaliser l’API Go qui fournit ses véritables résultats de recherche et les détails des objets. Vous utiliserez la page pour comprendre comment un consommateur dépend de vos réponses.
Quels outils vais-je utiliser ?
Le projet utilise la bibliothèque standard de Go, notamment net/http, encoding/json et httptest. Il ne nécessite ni framework, ni base de données, ni système d’authentification, ni écritures concurrentes.
Qu’est-ce qui change dans le défi ?
Le catalogue présente d’autres enregistrements, catégories et IDs, dont des objets de même nom. Vous appliquez de façon autonome le contrat d’API déjà pratiqué. La tâche reste en lecture seule ; ajouter ou supprimer des enregistrements est hors du périmètre.
