GraphQL
UI Bakery allows you to easily connect to GraphQL with no need for additional layers like APIs and 3rd-party services.

Prerequisites

If your API is hosted behind the Firewall, add the following IP address to the Firewall whitelist:
52.176.109.125

Configuration

  1. 1.
    Go to Datasources - Connect - GraphQL.
  2. 2.
    Enter URL to your GraphQL server. You can provide HTTP headers and Query Params, it will be sent with every query to the data source, but it can also be overwritten for every specific query in the action configuration.
  3. 3.
    Authentication can be done with custom HTTP header or query param. If your server is secured with Basic Auth, provide the username and the password in Basic Auth settings.
If your server doesn't support GraphQL introspection queries, then uncheck the Load and save GraphQL schema checkbox. GraphQL queries will continue to work, but autocomplete suggestion in the query editor will be limited.
GraphQL connection configuration

Usage

  1. 1.
    Create a new action, select GraphQL query and choose a data source you want to query.
  2. 2.
    Specify your query. If you need to pass user's data in your query, use GraphQL variables.
GraphQL query configuration

Error handling

By default, GraphQL server returns status 200 response even if the query failed. UI Bakery considers a request failed if it contains errors in response, errors cab be accessed via {{error}} action variable. You can also access raw GraphQL response with {{res}} variable.
Last modified 3mo ago
Copy link
Outline
Prerequisites
Configuration
Usage
Error handling