{"enrichment":{"faq":[{"a":"REST API Expert teaches that best practices include using standard HTTP methods (GET, POST, PUT, DELETE) correctly, designing resource-oriented endpoints, implementing proper status codes, versioning your API, and providing clear documentation. Key principles involve stateless communication, consistent naming conventions, pagination for large datasets, and meaningful error responses that help clients understand what went wrong.","q":"What are the core REST API best practices?"},{"a":"REST API Expert guides you through structuring a REST API by first defining your resources and their relationships, then mapping them to endpoints following RESTful conventions. Start with resource modeling, choose appropriate HTTP methods for each operation, design your data schema, implement authentication and error handling, add comprehensive documentation, and test thoroughly before deployment.","q":"How do I build a REST API from scratch?"},{"a":"REST API Expert explains that GET retrieves data, POST creates resources, PUT updates existing resources, and DELETE removes them. Status codes convey outcomes: 200 for success, 201 for creation, 400 for bad requests, 401 for authentication failures, 404 for not found, and 500 for server errors. Selecting the right codes helps clients handle responses appropriately and improves API usability.","q":"What HTTP methods and status codes should I use?"},{"a":"REST API Expert recommends using industry-standard authentication methods like OAuth 2.0 or JWT tokens rather than basic auth. Implement HTTPS for all communications, validate and sanitize inputs, use rate limiting to prevent abuse, implement proper authorization checks, and follow the principle of least privilege. Document security requirements clearly and regularly audit your API for vulnerabilities.","q":"How do I implement REST API authentication and security?"},{"a":"REST API Expert covers multiple versioning approaches: URL-based versioning (v1, v2 in the path), header-based versioning, or query parameter versioning. Each has trade-offs regarding caching, clarity, and client complexity. Choose based on your needs, communicate deprecation timelines clearly, and maintain backward compatibility during transitions to minimize disruption to existing clients.","q":"What strategies work for REST API versioning?"},{"a":"REST API Expert advises implementing caching strategies (HTTP caching headers, Redis), using pagination and filtering to reduce payload sizes, monitoring performance metrics, implementing rate limiting, and designing for horizontal scaling. Consider API gateways, load balancing, database optimization, and asynchronous processing for long-running operations. Regular load testing helps identify bottlenecks before they impact users.","q":"How do I optimize and scale REST APIs for production?"}],"shadow_tags":["api-design","http-protocols","backend-architecture","web-services","api-standards","integration-patterns","request-response","api-governance"],"summary_rewrite":"REST API Expert provides comprehensive guidance on designing and building robust APIs. Learn RESTful principles, HTTP semantics, resource modeling, versioning strategies, and proper error handling patterns. Get expert recommendations on endpoint structure, status code selection, pagination approaches, and API documentation."},"gist":{"api_url":"https://skillfed.io/api/skills/duck4nh/antigravity-kit/rest-api-expert.json","as_of":"2026-02-10","description":"REST API Expert teaches REST API design principles including endpoint patterns, HTTP methods, status codes.","install":{"manual":["git clone https://github.com/duck4nh/antigravity-kit","cp -r antigravity-kit ~/.claude/skills/rest-api-expert"],"primary":"npx skillfed install duck4nh/antigravity-kit/rest-api-expert","version":"ae27566a"},"kind":"skill","mirror_url":"https://skillfed.io/duck4nh/antigravity-kit/rest-api-expert.md","similar":[{"id":"ScientiaCapital/skills/api-design-skill","name":"Api Design Skill","publisher":"ScientiaCapital/skills","url":"https://skillfed.io/ScientiaCapital/skills/api-design-skill"}],"title":"Rest Api Expert by duck4nh: Learn REST API design principles and best practices \u2014 SkillFed","use":{"when":["REST API Expert guides you through structuring a REST API by first defining your resources and their relationships.","REST API Expert explains that GET retrieves data, POST creates resources, PUT updates existing resources, and DELETE removes them."]},"what":{"lead":"REST API Expert teaches REST API design principles including endpoint patterns, HTTP methods, status codes, and error handling best practices.","rest":"REST API Expert provides comprehensive guidance on designing and building robust APIs. Learn RESTful principles, HTTP semantics, resource modeling, versioning strategies, and proper error handling patterns. Get expert recommendations on endpoint structure, status code selection, pagination approaches, and API documentation."}},"id":"duck4nh/antigravity-kit/rest-api-expert","install":{"mode":"external","repo":"https://github.com/duck4nh/antigravity-kit"},"links":{"html":"https://skillfed.io/duck4nh/antigravity-kit/rest-api-expert","md":"https://skillfed.io/duck4nh/antigravity-kit/rest-api-expert.md","repo":"https://github.com/duck4nh/antigravity-kit"},"meta":{"agents_supported":[],"first_seen":"2026-07-28","forks":2,"language":"TypeScript","last_updated":"2026-02-10","license":null,"name":"Rest Api Expert","publisher":"duck4nh","stars":14},"relations":{"categories":["api-development","backend-engineering","web-services"],"similar":[{"id":"dadbodgeoff/drift/api-versioning"},{"id":"ScientiaCapital/skills/api-design-skill"},{"id":"NickCrew/Claude-Cortex/api-design-patterns"},{"id":"ancoleman/ai-design-components/designing-apis"},{"id":"miles990/claude-software-skills/api-design"},{"id":"patricio0312rev/skills/api-security-hardener"},{"id":"patricio0312rev/skills/api-endpoint-generator"},{"id":"organvm/a-i--skills/api-design-patterns"},{"id":"dadbodgeoff/drift/error-handling"},{"id":"daffy0208/ai-dev-standards/api-designer"}]},"slug":{"owner":"duck4nh","repo":"antigravity-kit","skill":"rest-api-expert"},"version":"ae27566a"}
