Changes to Pontoon GraphQL API endpoint

[mathjazz]

We're introducing a breaking change to the Pontoon public GraphQL API.

Key Change

The /graphql/ endpoint now always serves the GraphiQL interface (an interactive query editor) when accessed with the Accept: text/html header (e.g. from browsers). Previously, this behavior was limited to local development setups.

How This Affects You

If your integration explicitly or inexplicitly sends the Accept: text/html header, your application might break or behave unexpectedly, as it will now receive the HTML-based GraphiQL interface instead of the JSON response.

To ensure JSON responses: Use the Accept: application/json header or include the raw query argument in your request URL. Requests will also return JSON when no headers are sent.

Example Request

Force JSON response (GET):

curl --globoff "https://pontoon.mozilla.org/graphql/?query={projects{name}}" -H "Accept: application/json"