api-engineering

API Engineering

Guide to API design patterns, GraphQL, gRPC, API gateways, rate limiting, and versioning strategies.

Note: This is a foundational version. Community contributions welcome to expand coverage!

Purpose

Enable teams to design, build, and maintain robust, scalable APIs.

When to Use This Skill

Automatically activates when working on:

• REST API design and best practices
• GraphQL schema design
• gRPC service definition
• API gateway configuration (Kong, Ambassador)
• API versioning strategies
• Rate limiting and throttling
• API security (OAuth2, JWT)

Quick Start Checklist

• Define clear API contract (OpenAPI/GraphQL schema)
• Implement authentication/authorization
• Add rate limiting
• Version your API
• Document endpoints
• Implement error handling
• Add request validation

Resource Files

• rest-api-design.md - RESTful principles, resource modeling, HTTP methods
• graphql-patterns.md - Schema design, resolvers, N+1 problem, DataLoader
• api-versioning.md - URI versioning, header versioning, strategies
• rate-limiting.md - Token bucket, sliding window, distributed rate limiting

Best Practices

✅ Follow RESTful principles ✅ Use proper HTTP status codes ✅ Version your API from day one ✅ Implement rate limiting ✅ Validate input thoroughly ✅ Document with OpenAPI/GraphQL introspection ✅ Use API gateways for centralized concerns

Integration Points

• backend-dev-guidelines: API implementation
• documentation-as-code: API documentation
• devsecops: API security
• cloud-engineering: API Gateway services

---

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 🎯 SKILL ACTIVATED: api-engineering ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Total Resources: 4 foundational guides (community can expand!) Status: Basic coverage - contributions welcome