Using the Selector Builder GUI

We've created a simple GUI that allows you to build selectors by simply clicking through the object tree.

To use this GUI, simply replace the suffix of the URL with ".yoga". You can play with an example on our running demo server here. It looks like this:

The bottom of the selector page prints out the load time which is how long that particular query takes to return. This is useful to give you an idea of how changes to the selector impact the responsiveness of your server.

If I want to now create a query that returns some songs my friends like, I may click on favoriteArtists, followed by albums, then songs. As I click on each entity, it expands to show me available properties and children I can add the the request. Simultaneously it refreshes the preview pane on the right hand side, so I can see how this changes the results:

Note that the selector builder will ignore it if you try to select core fields, since they are returned by default. Also, remember that navigation links which are used to explore the API are disabled by default when a selector is added to the query. This behavior can be changed in the configuration.