Suggestion: GraphQL API

[chimon2000]

Justification

It would be nice to be able to query using GraphQL from the client side. I can think of a couple of advantages.

Sparse Fieldsets

Rather than try to build multiple endpoints for each integration, it's probably better to have a single query that can sparsely load params.

Simplifies query parameters

Currently we only have two integrations, but I could see querying getting complex soon. GraphQL gives us an easy way of being able to extend support.

Strongly typed schema

Can easily draft a schema that works for both the server and the clients.

On the downside, if we ever wanted to create a native client the supporting libraries for Flutter is missing some things. Considering our client right now is essentially read-only that may not be a big deal.

Implementation

The obvious candidate for implementing this in python is Graphene - Flask tutorials appear very straightforward.