Bézier API

The Bézier API allows fully automated interaction with Bézier, whether for publishing power curves from your internal systems, or for syncing and exporting as part of your farm design workflows.

The Bézier API has been in production for less than a year and should NOT be considered stable. We strongly recommend that customers wanting to integrate processes with Bézier contact us first.

With that said, we 'eat our own dogfood': the Bézier frontend is built on the same API we expose to customers, so we're rapidly improving and stabilising it.

Until general release, the instructions below won't work - but this page should give you a flavour of what's coming.

Using GraphQL

The Bézier API is based on GraphQL, not on REST principles. For some, this may seem counterintuitive at first - but trust us, it's well worth a couple of days learning this powerful technology, as it saves weeks of time and effort down the line.

We chose GraphQL because it allows us to:

• Reduce errors by getting data types consistent all the way from the database to the frontend

• Improve performance by querying for all the data we need in one request, rather than many

• Reduce code complexity by avoiding data normalisation problems (common with REST APIs having resources served on different endpoints), while automatically handling caching on the client side

For further reading, there's a good blog from GitHub on why they shifted to GraphQL.

Browsing the API

The graphical browser is LIVE! If you mutate data on this tool, you will see the it change in real life! To avoid making a mess of your production data, we recommend you create a duplicate organisation, with test data, to use as a sandbox for building your integrations.

Getting started is simple! Log into Bézier first (so you can query your own data), then navigate to the graphical browser for the API. Use the Documentation panel on the left to browse the contents of the API and build a query. Execute the query ▶️ and you've got data!

Generating tokens

To generate tokens for automating against the API, please contact us.