Open davenquinn opened 1 month ago
Output of our first conversation with @CannonLock, @amyfromandi, and @brianaydemir:
We want the API to avoid "reinventing the wheel" while allowing flexibility
We should develop libraries and well-documented patterns for API secrets, token/API key handling, etc. that can be pulled in via libraries.
api-v3
framework.Despite being composed of a handful of separate services with different API query styles, the goal will be to present Macrostrat's API as a unified /api/v3
cluster of routes.
API docs will prioritize OpenAPI/Swagger since it is autogenerated by many tools. We will explore patterns to merge documentation between services and separate it between functional areas.
dev2.macrostrat.org/api/v3/_private
gateway that would automatically apply some security, etc.
With design-focused updates like #3 and #5, and the evolution of our API v3 systems in other areas (e.g., a PostgREST API system) we should start a conversation on how to unify and carry forward Macrostrat's API v3 for future functionality. A few elements that we should establish: