skills.rest
sumeetonline90
sumeetonline90COMMUNITY
Explore all skills by this author →
GitHub

api-design

Design standardized REST API conventions for endpoints, resources, and error responses.

Updated Jun 25, 2026
Search Tags:#api design#rate limiting#rest api#pagination#api versioning#api best practices#http status codes
One-click install
npx skills add https://github.com/sumeetonline90/fitup_all --skill api-design-sumeetonline90
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: api-design
Source: https://github.com/sumeetonline90/fitup_all/tree/main/.cursor/.agents/skills/api-design
Command: npx skills add https://github.com/sumeetonline90/fitup_all --skill api-design-sumeetonline90

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the risk of inconsistent, non-standard REST API design that causes developer friction, integration bugs, and long-term maintainability issues for web, mobile, and partner-facing services.

Core Features & Use Cases

  • Standardized API Conventions: Covers resource naming, HTTP method semantics, status code usage, and consistent response formatting.
  • Scalable API Patterns: Includes pagination, filtering, sorting, error handling, authentication, rate limiting, and versioning best practices.
  • Use Case: For a fitness app backend, use this skill to design consistent user, workout, and activity endpoints that follow industry standards, reducing integration time for mobile and web clients.

Quick Start

Use the api-design skill to create a standardized REST API structure for your new user management endpoints, including proper resource naming, status codes, and pagination support.

Frequently Asked Questions about api-design

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What are the best practices for REST API design to avoid integration errors?▼

REST API design best practices involve standardizing resource naming, HTTP method semantics, and status code usage to eliminate developer friction and integration bugs. This ensures consistent, maintainable backend contracts for web and mobile services.

How do I implement pagination, filtering, and sorting in a REST API?▼

Implement pagination, filtering, and sorting in a REST API by applying scalable design patterns that structure large datasets efficiently. These patterns maintain consistent endpoint behavior and improve response times for client integrations.

How should I format error responses and HTTP status codes for production APIs?▼

Format error responses and HTTP status codes for production APIs by following standardized conventions that provide clear, developer-friendly feedback. Proper status code usage and consistent error formatting reduce integration time and debugging friction.

Does this approach cover rate limiting and API versioning for scalable backend services?▼

Yes, this approach covers rate limiting and API versioning for scalable backend services. It includes best practices for managing API traffic and evolving endpoint contracts without breaking existing web and mobile client integrations.

When do I need standardized API contracts for my web or mobile app backend?▼

You need standardized API contracts for web or mobile app backends when inconsistent endpoint design causes developer friction, integration errors, and poor maintainability. Standardized resource naming and authentication patterns reduce long-term integration time.

Related Skills

Explore More Software Engineering Skills→
felvieirafelvieira
22

backend-api

Define API contracts and data models for Node.js backend applications.

Community
Advanced
petbrainspetbrains
13

backend-trpc-openapi

Generate REST endpoints and OpenAPI documentation from tRPC routers.

Official
Intermediate
boomNDSboomNDS

api-security-best-practices

Apply authentication, authorization, input validation, and rate limiting patterns to secure APIs.

Community
Advanced
rohitg00rohitg00
2.5k

graphql-design

Design GraphQL schemas and resolver patterns with DataLoader integration and Relay-style pagination.

Community
Advanced