Documenting APIs on Amazon API Gateway: Code-First or Design-First, The Choice Is Yours
One of the hardest debates is deciding between a code-first API approach or design-first. In an ideal world, we would deliver our APIs at maximum velocity, with minimum maintenance. To maintain the appropriate API consumption, the world has looked at Amazon’s API Gateway as the orchestration of resources to create, deploy, and manage APIs at scale. One of the biggest challenges users face when using any API Gateway is the lack of consistency and standardization throughout the API experience.