cursorius » server

We need to provide an API for users to administrate the server through. The three candidate technologies are REST, GraphQL, and gRPC. REST is probably out of the question because I don't like REST.

Between GraphQL and gRPC, the two main questions are protocol ergonomics and correct models. Typically I would lean towards GraphQL for browser support, but with `connect-go`, gRPC-web support is basically free. The main delineation factor then is which models the API we want best. I think GraphQL will probably do this better, as I envision this API to be a set of queries against the cursorius server dataset. gRPC provides us a RPC api, which seems wrong when most of the operations will be querying and modifying the state of pipelines, runs, and other objects.

• https://github.com/ccbrown/api-fu
• https://github.com/graphql-go/graphql