As a developer I want to design the best possible API so I can implement it in a stable future-proof manner
Things to think about when designing the API:
- REST and HTTP links between results
- API version
- schema (food for thought: OpenAPI, CoreAPI, Swagger, etc)
- handling of paginated results
- writing a client should be easy
Acceptance criteria:
- The schema format has been decided
- We have a good vision of how fasjson's API should look like
DoD: all of the above