# Introduction

You can use the Uni-Select GraphQL API to create precise and flexible queries for the data you need to integrate with Uni-Select.

# General introduction

# Feedback is Welcome

The more suggestions our developers make, the better our APIs become. If you send us any feedback or suggestions regarding the APIs or documentation, we will look into it and come back to you.

# Limitation of Liability

In no event will we have any liability to you or any third party for any lost profits or revenues or any indirect, special, incidental, consequential, cover or punitive damages, however, caused by the use of this API.

# Is the API down?

Of course, we want the API fully functional for users and developers at all times. In the unfortunate event, you're having trouble to contact our services and need to determine what is going on, you can:

# Introduction to GraphQL

# About GraphQL

The GraphQL data query language is:

  • A specification. The spec determines the validity of the schema on the API server. The schema defines the validity of client calls.
  • Strongly typed. The schema defines an API's type system and all object relationships.
  • Introspective. A client can query the schema for details about the schema.
  • Hierarchical. The shape of a GraphQL call mirrors the shape of the JSON data it returns. Nested fields let you query for and receive only the data you specify in a single round trip.
  • An application layer. GraphQL is not a storage model or a database query language. The graph refers to graph structures defined in the schema, where nodes define objects and edges define relationships between objects. The API traverses and returns application data based on the schema definitions, independent of how the data is stored.

# Why Uni-Select is using GraphQL

Uni-Select chose GraphQL for our API because it offers significantly more flexibility for our integrators. The ability to define precisely the data you want and only the data you want is a powerful advantage over a REST API endpoints. GraphQL lets you replace multiple REST requests with a single call to fetch the information you specify.

# About the GraphQL schema reference

The docs in the schema's documentation are generated from the Uni-Select GraphQL schema. All calls are validated and executed against the schema. Use these docs to find out what data you can call:

  • Allowed operations: queries and mutations.
  • Schema-defined types: scalars, objects, enums, interfaces, unions, and input objects.

Note that you may need to rely on both the docs and the schema validation to call the GraphQL API successfully.

For other information, such as authentication and rate limit details, check out the guides.

Last Updated: 8/12/2020, 6:36:17 PM