EcholotTutoriels
Des leçons pas à pas avec la boutique de démo Alpenglow, de votre première requête aux agents et à la CI.
Chaque tutoriel mène une tâche du début à la fin. Tous utilisent Alpenglow, une boutique fictive d’équipement de
plein air : l’API de démo à l’adresse https://demo.echolot.dev et un espace de travail
d’exemple qui contient déjà une requête de chaque type. Il vous faut Echolot sur un Mac avec macOS 15 ou version
ultérieure et une puce Apple. Rien de ce que vous envoyez à la démo n’est conservé.
L’espace de travail Alpenglow
La plupart des tutoriels construisent leur propre espace de travail ou partent d’Alpenglow. Pour l’obtenir :
- Téléchargez Alpenglow.echolot.zip.
- Double-cliquez sur le zip dans le Finder pour le décompresser. Vous obtenez
Alpenglow.echolot. - Double-cliquez sur
Alpenglow.echolot. Echolot l’ouvre dans une fenêtre d’espace de travail. Vous pouvez aussi choisir Fichier › Ouvrir un espace de travail… (⌘O) et le sélectionner.
Alpenglow fonctionne avec Aucun environnement choisi : les variables de son espace de travail pointent vers l’API de démo. Il contient :
| Dossier | Ce qu’il contient |
|---|---|
| Auth | Sign in, qui stocke le jeton d’accès dans la variable secrète {{token}} ; Who am I ; Orders with OAuth 2 |
| Catalog | List products, Search, Get product, Categories, la requête GraphQL Search products, Export the catalog (14 Mo) |
| Orders | List orders, Create order, Get order, Cancel order, qui envoient toutes le jeton via l’authentification Bearer du dossier |
| Realtime | Order updates (WebSocket), Order events (Server-Sent Events), Support chat (Socket.IO), Warehouse sensors (MQTT) |
| Inventory | Trois appels gRPC : List warehouses, Watch stock, Reserve stock |
| Agent tools | Deux requêtes MCP, search_catalog et order_status, vers le serveur Alpenglow MCP |
| Echo | Des requêtes vers les endpoints /echo : ce que vous avez envoyé, un état, des redirections, l’authentification Basic, un cookie, du XML et du HTML |
Il contient aussi trois environnements (Local, Staging et Production, protégé ; Staging et Production sont des
adresses fictives), trois flux (Place a test order, Morning stock check, Order status on webhook), le
serveur MCP Alpenglow MCP et les specs alpenglow.yaml, shop.graphql et inventory.proto.
Des serveurs sur votre Mac pour gRPC, Socket.IO et MQTT
L’API de démo ne peut pas servir gRPC, Socket.IO ni MQTT. De petits serveurs pour eux se trouvent dans le dépôt de la
documentation, dans examples/servers. Ils demandent Bun et n’écoutent que sur votre Mac :
git clone https://github.com/staticdreams/echolot-docs.git
cd echolot-docs/examples/servers
bun install
bun run realtime # Socket.IO on http://localhost:3001 (namespace /support), MQTT on mqtt://localhost:1883
bun run grpc # the Inventory service on localhost:50051 (in a second Terminal window)Les requêtes Support chat, Warehouse sensors et Inventory d’Alpenglow pointent déjà vers ces adresses. Arrêtez un serveur avec Control-C.
Les tutoriels
| Tutoriel | Ce que vous apprenez | Durée |
|---|---|---|
| Votre premier espace de travail | Créer un espace de travail de zéro : des requêtes, un dossier, un environnement, un secret et Git | 15 minutes |
| Enchaîner des requêtes | Se connecter, stocker le jeton, l’envoyer partout via l’authentification du dossier ; valeurs dynamiques ; une Idempotency-Key | 15 minutes |
| Tester une API et l’exécuter en CI | Ajouter des vérifications, exécuter l’espace de travail dans l’Exécution, puis echolot run avec un rapport JUnit dans GitHub Actions | 20 minutes |
| Concevoir d’abord la spec et la simuler | Importer ou concevoir une spec OpenAPI, la linter, la simuler, envoyer des requêtes au mock et les vérifier par rapport à la spec | 20 minutes |
| Automatiser avec un flux | Construire un flux sur le canevas : se connecter, lister les commandes, décider, notifier ; l’exécuter, le planifier, le démarrer depuis un webhook | 20 minutes |
| Inspecter un serveur MCP | Ajouter le serveur MCP de démo, regarder ses outils, les appeler, lire la carte de qualité, enregistrer des appels comme requêtes avec des vérifications | 15 minutes |
| Laisser un agent utiliser votre espace de travail en toute sécurité | Connecter Claude Code ou un autre client, définir ce qu’il peut faire, approuver ses envois, protéger un environnement ; ou utiliser l’Assistant intégré | 20 minutes |
| Temps réel | WebSocket et Server-Sent Events avec l’API de démo ; Socket.IO et MQTT avec les serveurs locaux | 20 minutes |
| Vous venez de Postman | Importer une collection et ses environnements, voir ce qui correspond à quoi, l’exécuter, réexporter | 15 minutes |
L’API de démo a des limites
Elle accepte 120 requêtes par minute depuis une adresse, et 10 par minute pour l’export, WebSocket et Server-Sent
Events. Au-delà d’une limite, elle répond 429 Too Many Requests ; attendez une minute et envoyez de nouveau.
CI
Exécutez les vérifications d’un espace de travail à chaque push, avec des rapports JUnit, des secrets issus de votre CI et les garde-fous pour les specs, les schémas et les serveurs MCP.
L’API de démo
Alpenglow, une boutique fictive d’équipement de plein air sur demo.echolot.dev, pour essayer chaque partie d’Echolot.