Playground

Try requests in your browser, without writing code. Apollo, the GraphQL tool Wino uses, gives two web pages for that:

Tool	Use it to	Sends requests to
Apollo Explorer	Browse the schema: every query, mutation, type and field, with its description	Production only
Apollo Sandbox	Try requests safely	The URL you choose, for example staging

Both work the same way: write a query on the left, run it, and read the response on the right.

Apollo Explorer: browse the schema

1. Open the Wino Explorer ↗.
2. Search for a type or an operation in the Documentation panel, for example variants, and click the fields you want: the Explorer writes the query for you.
3. To run it, add your key in the Headers panel: Authorization with the value Bearer <your API key>.

The Explorer sends requests to production

It's connected to https://production.api.v2.wino.fr/graphql and you can't change it: a mutation run there changes real shop data. To see the shape of a response without sending anything, turn on Mock responses in the Explorer's settings. To really try a request, use the Sandbox on staging.

Apollo Sandbox: try requests on staging

1. Open the Sandbox on staging ↗. The box at the top shows the endpoint: https://staging.api.v2.wino.fr/graphql.
2. Add your staging key. The Sandbox reads the schema from the API itself, and the API answers only with a key: open the Settings tab on the left, edit the connection settings, and add the header Authorization with the value Bearer <your staging key>.
3. Paste this query and run it:

query Shops {
  shops {
    edges {
      node {
        id
        name
      }
    }
  }
}

The response lists the shops of your key, as in the Quickstart.

Don't put your key in a link: anyone who gets the link gets the key.

Learn more

• Apollo Explorer documentation ↗
• Apollo Sandbox documentation ↗