[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-fdb9b68e-7966-407c-9378-bfa5477cee27":3,"$fsP00ETxMHunLDMH69gy_sESczzEGknWaJ6bfHWpeSFE":42},{"id":4,"title":5,"description":6,"categoryId":7,"moduleId":8,"tags":9,"prompt":10,"icon":11,"source":12,"sourceUrl":13,"authorId":14,"authorName":15,"isPublic":16,"stars":17,"runs":18,"createdAt":19,"updatedAt":19,"module":20,"category":27,"packages":33},"fdb9b68e-7966-407c-9378-bfa5477cee27","api-design-principles","精通REST和GraphQL API设计原则，构建直观、可扩展和易于维护的API，让开发者满意并经得起时间的考验。","cat_coding_backend","mod_coding","sickn33,coding","---\nname: api-design-principles\ndescription: \"Master REST and GraphQL API design principles to build intuitive, scalable, and maintainable APIs that delight developers and stand the test of time.\"\nrisk: safe\nsource: community\ndate_added: \"2026-02-27\"\n---\n\n# API Design Principles\n\nMaster REST and GraphQL API design principles to build intuitive, scalable, and maintainable APIs that delight developers and stand the test of time.\n\n## Use this skill when\n\n- Designing new REST or GraphQL APIs\n- Refactoring existing APIs for better usability\n- Establishing API design standards for your team\n- Reviewing API specifications before implementation\n- Migrating between API paradigms (REST to GraphQL, etc.)\n- Creating developer-friendly API documentation\n- Optimizing APIs for specific use cases (mobile, third-party integrations)\n\n## Do not use this skill when\n\n- You only need implementation guidance for a specific framework\n- You are doing infrastructure-only work without API contracts\n- You cannot change or version public interfaces\n\n## Instructions\n\n1. Define consumers, use cases, and constraints.\n2. Choose API style and model resources or types.\n3. Specify errors, versioning, pagination, and auth strategy.\n4. Validate with examples and review for consistency.\n\nRefer to `resources\u002Fimplementation-playbook.md` for detailed patterns, checklists, and templates.\n\n## Resources\n\n- `resources\u002Fimplementation-playbook.md` for detailed patterns, checklists, and templates.\n\n## Limitations\n- Use this skill only when the task clearly matches the scope described above.\n- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.\n- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.\n","","imported","https:\u002F\u002Fgithub.com\u002Fsickn33\u002Fantigravity-awesome-skills","user_system_seed","SkillOPIC",true,123,389,"2026-05-16 13:03:18",{"id":8,"name":21,"slug":22,"icon":23,"description":24,"sort":25,"createdAt":26},"编程开发","coding","mdi-code-braces","代码生成、调试、审查，提升开发效率",2,"2026-05-16 12:53:40",{"id":7,"name":28,"slug":29,"icon":30,"description":31,"moduleId":8,"sort":25,"skillCount":32,"createdAt":26},"后端开发","backend","mdi-server","API、数据库、服务端架构",296,[34],{"id":35,"skillId":4,"version":36,"fileName":37,"fileSize":38,"filePath":39,"fileHash":40,"manifest":41,"createdAt":19},"319e9bc0-5b35-40ee-ab0f-a196fe33cb94","1.0.0","api-design-principles.zip",15652,"uploads\u002Fskills\u002Ffdb9b68e-7966-407c-9378-bfa5477cee27\u002Fapi-design-principles.zip","246fe2ee506d634c0b0427d7fff1fbbe4105855745b41aabf58f30f28323ab70","[{\"path\":\"SKILL.md\",\"isDirectory\":false,\"size\":1793},{\"path\":\"assets\u002Fapi-design-checklist.md\",\"isDirectory\":false,\"size\":3884},{\"path\":\"assets\u002Frest-api-template.py\",\"isDirectory\":false,\"size\":5323},{\"path\":\"references\u002Fgraphql-schema-design.md\",\"isDirectory\":false,\"size\":9005},{\"path\":\"references\u002Frest-best-practices.md\",\"isDirectory\":false,\"size\":7571},{\"path\":\"resources\u002Fimplementation-playbook.md\",\"isDirectory\":false,\"size\":13019}]",{"code":43,"message":44,"data":45},200,"success",{"items":46,"stats":47,"page":50},[],{"averageRating":48,"totalRatings":48,"ratingCounts":49},0,[48,48,48,48,48],{"limit":51,"offset":48,"hasMore":52,"nextOffset":51,"ratedOnly":16},15,false]