API Design

Design API endpoints, schemas, and contracts. Use when defining public interfaces or data models. Use when this capability is needed.

tomevault-io Updated

File contents

API Design

Define the interface contracts for APIs, including endpoints, request/response schemas, and error handling.

Process

  1. Review spec.md and architecture.md
  2. Define endpoints and HTTP methods
  3. Design request and response schemas
  4. Define error responses and codes
  5. Consider versioning strategy

Output

Create api-design.md using the template in templates/api-design.md.

Tips

  • Use consistent naming conventions
  • Design for backwards compatibility
  • Include example payloads
  • Document rate limits if applicable
  • Consider pagination for list endpoints

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

tomevault-io/skills-registry/tree/main/amattas--agentic-coding--api-design commit 3e7bbdecb6

Frequently asked questions

npx skillmds@latest add tomevault-io/api-design-18