---

name: api-rest-conventions description: Use this skill when designing, implementing, or reviewing RESTful APIs and URL structures.

RESTful API Design Conventions

This skill provides comprehensive guidance for designing RESTful APIs following industry best practices and conventions.

Topics

• URL Structure and Naming
• HTTP Methods and Semantics
• Status Codes and Error Handling
• Data Transfer Objects (DTOs)
• API Versioning
• OpenAPI/Swagger Documentation
• Security and Authentication
• Performance Optimization
• Testing and Validation

Following these RESTful API conventions ensures consistent, maintainable, and developer-friendly APIs that integrate well with modern web and mobile applications.