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
YouTube Data API integration with managed OAuth. Search videos, manage playlists, access channel data, and interact with comments. Use this skill when users want to interact with YouTube. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway).
Trello API integration with managed OAuth. Manage boards, lists, cards, members, and labels. Use this skill when users want to interact with Trello for project management. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway).
Scaffold, test, document, and debug REST and GraphQL APIs. Use when the user needs to create API endpoints, write integration tests, generate OpenAPI specs, test with curl, mock APIs, or troubleshoot HTTP issues.
Twilio API integration with managed OAuth. SMS, voice calls, phone numbers, and communications. Use this skill when users want to send SMS messages, make voice calls, manage phone numbers, or work with Twilio resources. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Requires network access and valid Maton API key.
Fetch up-to-date library documentation via Context7 API. Use PROACTIVELY when: (1) Working with ANY external library (React, Next.js, Supabase, etc.) (2) User asks about library APIs, patterns, or best practices (3) Implementing features that rely on third-party packages (4) Debugging library-specific issues (5) Need current documentation beyond training data cutoff Always prefer this over guessing library APIs or using outdated knowledge.
OpenClaw skill that installs a Google Sheets CLI with setup steps and commands for read/write, batch, formatting, and sheet management.