api-design-principlesDesign clear, scalable REST and GraphQL APIs including resource modeling, HTTP methods, pagination, error handling, versioning, and schema best practices.
Install via ClawdBot CLI:
clawdbot install wpank/api-design-principlesGrade Fair — based on market validation, documentation quality, package completeness, maintenance status, and authenticity signals.
Calls external URL not in known-safe list
https://github.com/wpank/ai/tree/main/skills/backend/api-design-principlesAudited Apr 16, 2026 · audit v1.0
Generated Mar 1, 2026
A retail company wants to redesign its legacy REST API to improve developer experience and support mobile apps. The API needs to handle product catalogs, user orders, and inventory management with efficient pagination and error handling for high traffic.
A healthcare startup is building a patient portal that aggregates data from multiple sources like EHR systems and lab results. GraphQL is chosen to allow clients to query nested data efficiently and reduce bandwidth for mobile users.
A bank is establishing API design standards for internal teams to ensure consistency across microservices. The focus is on REST principles for simple CRUD operations, secure authentication, and versioning to maintain backward compatibility.
A social media company is migrating from a REST API to GraphQL to handle complex nested relationships like user posts, comments, and likes. This supports rapidly evolving frontend requirements and optimizes data fetching for diverse client devices.
An IoT provider designs a REST API for managing connected devices, focusing on resource modeling for devices and sensors, with pagination for large datasets and error handling for device state conflicts.
Companies monetize their APIs by offering tiered access plans to external developers, charging based on usage metrics like request volume or data throughput. This model leverages well-designed APIs to generate recurring revenue from partners and third-party integrations.
Organizations build and maintain APIs for internal use across departments, improving operational efficiency and reducing development costs. Revenue is indirect, realized through cost savings and faster time-to-market for new features.
Firms offer expertise in API design principles, providing consulting services for API reviews, design workshops, and training programs. Revenue comes from project-based fees or ongoing retainer agreements with clients.
💬 Integration Tip
Use OpenAPI specifications for REST APIs to generate documentation and client SDKs automatically, and implement GraphQL with tools like Apollo Server for efficient schema management and caching.
Scored Apr 19, 2026
API reference for CoinMarketCap DEX endpoints including token lookup, pools, transactions, trending, and security analysis. Use this skill whenever the user...
Use when designing REST or GraphQL APIs, creating OpenAPI specifications, or planning API architecture. Invoke for resource modeling, versioning strategies, pagination patterns, error handling standards.
ServiceNow IT Service Management integration with API key authentication. Manage incidents, problems, change requests, tasks, CMDB records, service catalog i...
This skill should be used when writing documentation for codebases, including README files, architecture documentation, code comments, and API documentation. Use this skill when users request help documenting their code, creating getting-started guides, explaining project structure, or making codebases more accessible to new developers. The skill provides templates, best practices, and structured approaches for creating clear, beginner-friendly documentation.
API Design Reviewer
Cut AI token costs by 60-85% with deterministic query validation and intelligent caching. Standalone or integrates with Company Brain Core OS. Free, open-sou...