Echo sur Android et iOS

Echo Mobile vous permet d'envoyer des requêtes, de consulter les réponses et de travailler avec vos collections loin de votre ordinateur. Utilisez les liens de la page de téléchargement pour ouvrir la boutique correspondante. L'application mobile possède sa propre interface : certains outils du bureau n'ont donc pas d'écran équivalent sur le téléphone.

Commencer par une requête

1. Ouvrez Collections. Créez un espace si vous n'en avez pas encore, puis ajoutez-y une collection.
2. Ouvrez la collection et ajoutez une requête. Les nouvelles requêtes créées sur mobile sont de type HTTP.
3. Donnez-lui un nom, choisissez la méthode et saisissez une URL accessible depuis l'appareil.
4. Complétez la requête dans Paramètres, En-têtes, Corps et Authentification. Vous pouvez désactiver une ligne de paramètre ou d'en-tête sans la supprimer.
5. Touchez Envoyer. Pendant l'exécution, cette même zone propose Annuler.
6. Ouvrez Réponse pour consulter le résultat. Les modifications d'une requête éditable sont enregistrées automatiquement, sans étape supplémentaire avant l'envoi.

Vous pouvez travailler avec les données de l'appareil sans vous connecter. Envoyer une requête exige toujours un accès à l'API cible. Si l'API s'exécute sur votre ordinateur, localhost sur le téléphone désigne le téléphone lui-même. Utilisez une adresse accessible depuis l'appareil et vérifiez la connexion réseau ou VPN.

La base de données de l'appareil est chiffrée et sa clé est conservée dans le stockage sécurisé du système. Gardez le verrouillage de l'écran activé, notamment si les collections contiennent des identifiants ou des réponses privées.

Retrouver les collections du bureau

Connectez-vous dans les Paramètres avec le même compte Gapfy que sur le bureau. Si vous appartenez à plusieurs organisations, sélectionnez l'espace de travail correspondant avant de chercher ses collections. Tirez la liste des collections ou des environnements vers le bas pour synchroniser, ou utilisez Synchroniser maintenant dans les Paramètres.

Collections, requêtes et environnements peuvent vous suivre entre appareils. L'historique des requêtes et les cookies restent sur l'appareil où ils ont été créés. Une erreur de synchronisation signifie que les dernières modifications n'ont peut-être pas atteint l'autre appareil. Consultez l'état et reconnectez-vous lorsque l'application le demande.

Les collections reçues apparaissent dans Partagé avec moi, regroupées par la personne qui les a partagées. L'accès en lecture permet d'ouvrir et d'envoyer des requêtes sans modifier la collection enregistrée. Pour modifier le contenu, il faut un accès de contribution. Configurez le partage depuis le bureau ou Maestro.

Choisir un environnement

Ouvrez Environnements pour créer un environnement et modifier ses variables. Enregistrez chaque variable après avoir changé son nom ou sa valeur. Marquez mots de passe et tokens comme Secret pour masquer les valeurs dans l'éditeur ; utilisez Afficher lorsque vous devez les consulter.

Choisissez Définir comme actif dans la liste, ou touchez le nom de l'environnement près d'Envoyer pour en sélectionner un. Aucun environnement efface la sélection. Une requête telle que {{baseUrl}}/orders utilise l'environnement sélectionné lors de l'envoi. Si une variable n'est pas remplacée, vérifiez d'abord l'environnement actif et le nom de la variable.

Les références Key Vault synchronisées depuis le bureau conservent leur type sur mobile. Enregistrer une référence ne la transforme pas en secret textuel ordinaire. L'application mobile ne peut pas récupérer le secret dans Key Vault ; une requête qui en dépend ne peut donc pas y être exécutée. Utilisez un environnement adapté au mobile ou lancez cette requête sur le bureau. Consultez environnements et variables.

Authentification et détails de la réponse

Bearer, Basic et clé d'API disposent de champs dédiés. La clé d'API peut être envoyée dans un en-tête ou un paramètre de requête. Les autres types d'authentification présentent leur configuration en JSON, sans tous les écrans du bureau. Un type enregistré ne garantit pas que son parcours interactif soit disponible sur mobile.

La réponse indique le statut, la durée, le délai avant le premier octet, la taille et les en-têtes. Vous pouvez passer du corps avec coloration au texte brut et copier le corps affiché. Les corps volumineux sont tronqués dans le visualiseur, et chaque entrée de l'historique ne conserve qu'un extrait. Une vue tronquée ne contient pas la réponse complète.

Les résultats des tests existants et les messages de console des scripts apparaissent avec la réponse. L'interface mobile ne comporte pas d'éditeur de scripts. Préparez les scripts sur le bureau, puis synchronisez la requête avant de l'exécuter sur le téléphone.

L'Historique permet de rechercher une URL et de filtrer les réponses réussies, les erreurs HTTP et les échecs de transport. Touchez une entrée pour rouvrir sa requête. L'appareil conserve jusqu'à 200 exécutions par requête. L'accueil propose également des raccourcis vers les requêtes récentes.

Protocoles et grands écrans

Le moteur partagé exécute HTTP, GraphQL, WebSocket et SSE. La prise en charge de gRPC est partielle, avec les appels unaires et la découverte par réflexion dans le moteur ; les certificats client et la visualisation des flux restent limités. Les Paramètres présentent un résumé des capacités de l'appareil.

Créez et configurez les requêtes de protocoles avancés sur le bureau avant de les synchroniser. L'éditeur mobile n'a ni sélecteur de protocole, ni navigateur de services gRPC, ni panneaux interactifs de streaming équivalents à ceux du bureau. Il n'a pas non plus d'écrans pour exécuter des collections en lot, enchaîner des requêtes, créer des planifications ou des mocks, importer et exporter, ou utiliser les aides IA. Consultez les guides du bureau pour ces tâches.

En paysage, sur un écran assez large, la liste d'une collection et sa requête peuvent partager l'écran. L'éditeur peut aussi afficher la réponse à côté de la requête lorsque la place le permet. Les Paramètres proposent les thèmes système, clair et sombre ainsi que des couleurs d'accentuation. L'interface suit la langue de l'appareil.

Résoudre un problème de connexion ou de synchronisation

Si Android demande l'autorisation Appareils à proximité avant une requête vers votre réseau, autorisez l'accès pour atteindre cet endpoint. Si l'autorisation a été refusée, l'application propose un lien vers ses paramètres système. Les endpoints publics et ceux de votre réseau peuvent exiger des accès différents.

Réinitialiser les données locales, dans les Paramètres, permet de rétablir le stockage de cet appareil. Cette action demande confirmation et reste indisponible pendant une synchronisation ou un changement d'espace de travail. Les espaces, collections, requêtes et environnements déjà synchronisés peuvent être téléchargés à nouveau après connexion. Les modifications non synchronisées, l'historique et les cookies de cet appareil sont définitivement perdus. Lisez attentivement la confirmation avant d'utiliser cette action.

Utilisez Commentaires dans les Paramètres pour signaler un problème et décrire ce que vous faisiez. Indiquez le protocole et l'erreur affichée, sans identifiants ni données privées de la réponse.