What is GraphQL?

GraphQL is a powerful way of exchanging data. Using it does require developer expertise, similar to consuming REST or SOAP APIs. If you just need to download our product data into Excel as a one-off action, you would be better off visiting our CSV Feeds page.

Our GraphQL API is hosted at https://www.schreuderssport.com/graphql - you can visit it now to see what information is available. We provide the GraphiQL tool for writing, validating and testing your queries.

A good place to start is clicking on the Docs button to open the Documentation Explorer.

Which gives you the choice of examining our Queries (retrieving information) and Mutations (manipulating data in some way, for example placing a Sales Order).

Clicking on Query will show the data available to you:

In turn, for example, you can click on Product and see the data which is available for that.

Starting with a simple query of a particular Product:

Given a particular barcode, we fetch just the productCode. Notice that the response has the identical structure to the query, i.e. you define what it should look like.

As an another example, we can expand out the query to retrieve price and availability information:

The queries (retrieving all possible data) can be found in the Samples Projects, along with example code in both .NET Core and PHP which demonstrates how to execute the queries against the API.

Errors

If there are any errors in the request or its execution, they are returned in the response and the HTTP Status Code is set to 400 - Bad Request. The Graphiql tool also highlights any errors in the syntax of the query.

More information on GraphQL can be found here: https://graphql.org