Playground
Essayez des requêtes dans votre navigateur, sans écrire de code. Apollo, l'outil GraphQL utilisé par Wino, propose deux pages web pour cela :
| Outil | À utiliser pour | Envoie les requêtes vers |
|---|---|---|
| Apollo Explorer | Parcourir le schéma : chaque requête (query), mutation, type et champ, avec sa description | La production uniquement |
| Apollo Sandbox | Essayer des requêtes sans risque | L'URL de votre choix, par exemple le staging |
Les deux fonctionnent de la même façon : écrivez une requête à gauche, exécutez-la et lisez la réponse à droite.
Apollo Explorer : parcourir le schéma
- Ouvrez l'Explorer Wino ↗.
- Cherchez un type ou une opération dans le panneau Documentation, par exemple
variants, et cliquez sur les champs voulus : l'Explorer écrit la requête pour vous. - Pour l'exécuter, ajoutez votre clé dans le panneau Headers :
Authorizationavec la valeurBearer <your API key>.
Il est connecté à https://production.api.v2.wino.fr/graphql et vous ne pouvez pas le changer : une mutation exécutée ici modifie les vraies données d'une boutique. Pour voir la forme d'une réponse sans rien envoyer, activez Mock responses dans les paramètres de l'Explorer. Pour vraiment essayer une requête, utilisez la Sandbox en staging.
Apollo Sandbox : essayer des requêtes en staging
- Ouvrez la Sandbox en staging ↗. Le champ en haut affiche l'endpoint :
https://staging.api.v2.wino.fr/graphql. - Ajoutez votre clé de staging. La Sandbox lit le schéma depuis l'API elle-même, et l'API ne répond qu'avec une clé : ouvrez l'onglet Settings à gauche, modifiez les connection settings et ajoutez le header
Authorizationavec la valeurBearer <your staging key>. - Collez cette requête et exécutez-la :
query Shops {
shops {
edges {
node {
id
name
}
}
}
}
La réponse liste les boutiques de votre clé, comme dans le Démarrage rapide.
Ne mettez pas votre clé dans un lien : toute personne qui obtient le lien obtient la clé.