Http Apiv1.0.0

An e-commerce platform needs to design new product and order APIs. This skill helps define consistent resource models, HTTP verbs, pagination for product listings, and idempotent order creation to prevent duplicate charges.

A SaaS company wants to unify error formats across its microservices to improve client handling. The skill provides patterns for stable machine-readable error codes, correlation IDs, and avoiding information leakage.

A fintech team reviews pull requests for new transfer endpoints. The skill guides the review order: check read path navigation, write safety (idempotency for retries), error consistency, and evolution docs.

A social media app needs to paginate user feeds efficiently without returning unbounded lists. The skill suggests consistent pagination/filter patterns and cursor-based pagination for large datasets.

Design APIs as the core product, allowing third-party developers to integrate easily. The skill ensures predictable URLs and honest error codes, reducing integration friction and support costs.

Offer a platform where customers build on top of your APIs. Consistent error handling and idempotency increase reliability, making your platform more attractive and reducing churn.

Provide consulting services to enterprises for designing or reviewing their APIs. This skill provides a structured methodology (review order, smells) that consultants can sell as a service.