[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6CXH9W9SF7PDH9J1F3ESHAD":3,"skill-same:01M6CXH9W9SF7PDH9J1F3ESHAD":70},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":33,"publishedAt":42,"linkOnly":43,"markdownContent":44,"markdownBody":45,"frontMatter":46,"refName":50,"commitSha":51,"skillDirectory":5,"forksCount":52,"repositoryHtmlUrl":53,"repositoryHomepageUrl":6,"ownerHtmlUrl":54,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":55,"install":56,"resources":69},"01M6CXH9W9SF7PDH9J1F3ESHAD","rest-api",null,"REST API design best practices and patterns","ffsshhttiikk\u002Fopencode-agents-skills","ffsshhttiikk","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F226346827?v=4","01M6CWD9RR3Y7VRQX3MXYC8FYH","01M6CWD9WVPYAZW0J82G1VKGHY",3,"MIT","https:\u002F\u002Fgithub.com\u002Fffsshhttiikk\u002Fopencode-agents-skills\u002Fblob\u002Fmain\u002Frest-api\u002FSKILL.md",[17,22,25,30],{"categoryNo":18,"categoryName":19,"taxonomyType":20,"taxonomyTypeDesc":21},"01JBSEEDCAT000000000000010","后端与接口","SCENARIO","使用场景",{"categoryNo":23,"categoryName":24,"taxonomyType":20,"taxonomyTypeDesc":21},"01JBSEEDCAT000000000000015","视觉设计",{"categoryNo":26,"categoryName":27,"taxonomyType":28,"taxonomyTypeDesc":29},"01JBSEEDCAT000000000000030","开发工程师","PROFESSION","适用职业",{"categoryNo":31,"categoryName":32,"taxonomyType":28,"taxonomyTypeDesc":29},"01JBSEEDCAT000000000000032","设计师",[34,35,36,37,38,39,40,41],"REST","api","rest api","design","api design","best practices","opencode","patterns","2026-11-10 10:12:30",false,"---\nname: rest-api\ndescription: REST API design best practices and patterns\nlicense: MIT\ncompatibility: opencode\nmetadata:\n  audience: developers\n  category: api-design\n---\n## What I do\n- Design clean REST APIs following best practices\n- Implement proper HTTP methods and status codes\n- Handle pagination, filtering, and sorting\n- Version APIs properly\n- Document APIs with OpenAPI\u002FSwagger\n- Implement authentication and authorization\n- Handle errors consistently\n- Use HATEOAS where appropriate\n\n## When to use me\nWhen designing or implementing REST APIs.\n\n## REST Design Principles\n```\nResources: \u002Fusers, \u002Fusers\u002F{id}, \u002Fusers\u002F{id}\u002Fposts\nCollections: \u002Fposts, \u002Fposts?status=published\nActions as sub-resources: \u002Fusers\u002F{id}\u002Factivate, \u002Fusers\u002F{id}\u002Fdeactivate\n\nHTTP Methods:\nGET     - Retrieve resource(s)\nPOST    - Create resource(s)\nPUT     - Replace resource\nPATCH   - Partial update\nDELETE  - Remove resource\n\nStatus Codes:\n200 OK - Success\n201 Created - Resource created\n204 No Content - Success, no body\n400 Bad Request - Invalid input\n401 Unauthorized - Authentication required\n403 Forbidden - Authenticated but not authorized\n404 Not Found - Resource doesn't exist\n409 Conflict - Resource state conflict\n422 Unprocessable Entity - Validation errors\n429 Too Many Requests - Rate limiting\n500 Internal Server Error - Server error\n```\n\n## API Response Format\n```json\n{\n  \"data\": {\n    \"id\": \"123\",\n    \"type\": \"user\",\n    \"attributes\": {\n      \"email\": \"user@example.com\",\n      \"name\": \"John Doe\",\n      \"createdAt\": \"2024-01-15T10:30:00Z\"\n    },\n    \"relationships\": {\n      \"posts\": {\n        \"links\": {\n          \"related\": \"\u002Fusers\u002F123\u002Fposts\"\n        }\n      }\n    },\n    \"links\": {\n      \"self\": \"\u002Fusers\u002F123\"\n    }\n  },\n  \"meta\": {\n    \"copyright\": \"2024\"\n  }\n}\n```\n\n## Error Response Format\n```json\n{\n  \"errors\": [\n    {\n      \"id\": \"550e8400-e29b-41d4-a716-446655440000\",\n      \"status\": 422,\n      \"code\": \"VALIDATION_ERROR\",\n      \"title\": \"Validation failed\",\n      \"detail\": \"The 'email' field must be a valid email address\",\n      \"source\": {\n        \"pointer\": \"\u002Fdata\u002Fattributes\u002Femail\"\n      },\n      \"meta\": {\n        \"field\": \"email\",\n        \"value\": \"invalid-email\"\n      }\n    }\n  ]\n}\n```\n\n## Collection Responses\n```json\n{\n  \"data\": [\n    {\n      \"id\": \"1\",\n      \"type\": \"user\",\n      \"attributes\": { \"name\": \"User 1\" }\n    },\n    {\n      \"id\": \"2\",\n      \"type\": \"user\",\n      \"attributes\": { \"name\": \"User 2\" }\n    }\n  ],\n  \"links\": {\n    \"self\": \"\u002Fapi\u002Fv1\u002Fusers?page[number]=1&page[size]=10\",\n    \"first\": \"\u002Fapi\u002Fv1\u002Fusers?page[number]=1&page[size]=10\",\n    \"last\": \"\u002Fapi\u002Fv1\u002Fusers?page[number]=10&page[size]=10\",\n    \"next\": \"\u002Fapi\u002Fv1\u002Fusers?page[number]=2&page[size]=10\",\n    \"prev\": null\n  },\n  \"meta\": {\n    \"totalCount\": 100,\n    \"totalPages\": 10,\n    \"currentPage\": 1,\n    \"pageSize\": 10\n  }\n}\n```\n\n## Query Parameters\n```\nFiltering:      ?status=published&author=123\nSorting:        ?sort=-createdAt,title\nPagination:     ?page[number]=2&page[size]=20\nFields:         ?fields[user]=email,name\nIncluding:      ?include=posts,posts.comments\nSparse Fields: ?fields[user]=id,name&fields[post]=id,title\nSearch:         ?search=keyword\n```\n\n## API Versioning\n```\nURL: \u002Fapi\u002Fv1\u002Fusers\nHeader: Accept: application\u002Fvnd.api+json; version=1\n```\n\n## Best Practices\n- Use plural nouns for resources: `\u002Fusers` not `\u002Fuser`\n- Use nouns for resources, not verbs\n- Return appropriate headers (ETag, Last-Modified)\n- Use idempotent operations for safety\n- Implement rate limiting\n- Use HTTPS only\n- Cache with proper headers\n- Document breaking changes in new versions\n","## What I do\n- Design clean REST APIs following best practices\n- Implement proper HTTP methods and status codes\n- Handle pagination, filtering, and sorting\n- Version APIs properly\n- Document APIs with OpenAPI\u002FSwagger\n- Implement authentication and authorization\n- Handle errors consistently\n- Use HATEOAS where appropriate\n\n## When to use me\nWhen designing or implementing REST APIs.\n\n## REST Design Principles\n```\nResources: \u002Fusers, \u002Fusers\u002F{id}, \u002Fusers\u002F{id}\u002Fposts\nCollections: \u002Fposts, \u002Fposts?status=published\nActions as sub-resources: \u002Fusers\u002F{id}\u002Factivate, \u002Fusers\u002F{id}\u002Fdeactivate\n\nHTTP Methods:\nGET     - Retrieve resource(s)\nPOST    - Create resource(s)\nPUT     - Replace resource\nPATCH   - Partial update\nDELETE  - Remove resource\n\nStatus Codes:\n200 OK - Success\n201 Created - Resource created\n204 No Content - Success, no body\n400 Bad Request - Invalid input\n401 Unauthorized - Authentication required\n403 Forbidden - Authenticated but not authorized\n404 Not Found - Resource doesn't exist\n409 Conflict - Resource state conflict\n422 Unprocessable Entity - Validation errors\n429 Too Many Requests - Rate limiting\n500 Internal Server Error - Server error\n```\n\n## API Response Format\n```json\n{\n  \"data\": {\n    \"id\": \"123\",\n    \"type\": \"user\",\n    \"attributes\": {\n      \"email\": \"user@example.com\",\n      \"name\": \"John Doe\",\n      \"createdAt\": \"2024-01-15T10:30:00Z\"\n    },\n    \"relationships\": {\n      \"posts\": {\n        \"links\": {\n          \"related\": \"\u002Fusers\u002F123\u002Fposts\"\n        }\n      }\n    },\n    \"links\": {\n      \"self\": \"\u002Fusers\u002F123\"\n    }\n  },\n  \"meta\": {\n    \"copyright\": \"2024\"\n  }\n}\n```\n\n## Error Response Format\n```json\n{\n  \"errors\": [\n    {\n      \"id\": \"550e8400-e29b-41d4-a716-446655440000\",\n      \"status\": 422,\n      \"code\": \"VALIDATION_ERROR\",\n      \"title\": \"Validation failed\",\n      \"detail\": \"The 'email' field must be a valid email address\",\n      \"source\": {\n        \"pointer\": \"\u002Fdata\u002Fattributes\u002Femail\"\n      },\n      \"meta\": {\n        \"field\": \"email\",\n        \"value\": \"invalid-email\"\n      }\n    }\n  ]\n}\n```\n\n## Collection Responses\n```json\n{\n  \"data\": [\n    {\n      \"id\": \"1\",\n      \"type\": \"user\",\n      \"attributes\": { \"name\": \"User 1\" }\n    },\n    {\n      \"id\": \"2\",\n      \"type\": \"user\",\n      \"attributes\": { \"name\": \"User 2\" }\n    }\n  ],\n  \"links\": {\n    \"self\": \"\u002Fapi\u002Fv1\u002Fusers?page[number]=1&page[size]=10\",\n    \"first\": \"\u002Fapi\u002Fv1\u002Fusers?page[number]=1&page[size]=10\",\n    \"last\": \"\u002Fapi\u002Fv1\u002Fusers?page[number]=10&page[size]=10\",\n    \"next\": \"\u002Fapi\u002Fv1\u002Fusers?page[number]=2&page[size]=10\",\n    \"prev\": null\n  },\n  \"meta\": {\n    \"totalCount\": 100,\n    \"totalPages\": 10,\n    \"currentPage\": 1,\n    \"pageSize\": 10\n  }\n}\n```\n\n## Query Parameters\n```\nFiltering:      ?status=published&author=123\nSorting:        ?sort=-createdAt,title\nPagination:     ?page[number]=2&page[size]=20\nFields:         ?fields[user]=email,name\nIncluding:      ?include=posts,posts.comments\nSparse Fields: ?fields[user]=id,name&fields[post]=id,title\nSearch:         ?search=keyword\n```\n\n## API Versioning\n```\nURL: \u002Fapi\u002Fv1\u002Fusers\nHeader: Accept: application\u002Fvnd.api+json; version=1\n```\n\n## Best Practices\n- Use plural nouns for resources: `\u002Fusers` not `\u002Fuser`\n- Use nouns for resources, not verbs\n- Return appropriate headers (ETag, Last-Modified)\n- Use idempotent operations for safety\n- Implement rate limiting\n- Use HTTPS only\n- Cache with proper headers\n- Document breaking changes in new versions\n",{"name":5,"license":14,"metadata":47,"description":7,"compatibility":40},{"audience":48,"category":49},"developers","api-design","main","5f7a3e453c98261f93d19a6a7de44ad8f7b72d41",2,"https:\u002F\u002Fgithub.com\u002Fffsshhttiikk\u002Fopencode-agents-skills","https:\u002F\u002Fgithub.com\u002Fffsshhttiikk","2026-03-01 06:55:40",{"source":8,"skillName":5,"commands":57,"prompt":67,"zipAvailable":68},[58,61,64],{"tool":59,"command":60},"npx","npx skills add ffsshhttiikk\u002Fopencode-agents-skills --skill rest-api",{"tool":62,"command":63},"bunx","bunx skills add ffsshhttiikk\u002Fopencode-agents-skills --skill rest-api",{"tool":65,"command":66},"pnpm","pnpm dlx skills add ffsshhttiikk\u002Fopencode-agents-skills --skill rest-api","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fffsshhttiikk\u002Fopencode-agents-skills\u002Fblob\u002Fmain\u002Frest-api\u002FSKILL.md",true,[],[71,82,92,101,111,120],{"skillNo":72,"name":73,"nameZh":6,"description":74,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":77,"publishedAt":42},"01M6CXT9TXDF79BWJTMQAPB49G","xamarin","Xamarin cross-platform development","https:\u002F\u002Fgithub.com\u002Fffsshhttiikk\u002Fopencode-agents-skills\u002Fblob\u002Fmain\u002Fxamarin\u002FSKILL.md",[],[73,78,79,80,40,81],"platform","cross-platform","mobile","development",{"skillNo":83,"name":84,"nameZh":6,"description":85,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":42},"01M6CXT8AD04MFYDA32VW3FKAG","wrangling","Data wrangling fundamentals","https:\u002F\u002Fgithub.com\u002Fffsshhttiikk\u002Fopencode-agents-skills\u002Fblob\u002Fmain\u002Fwrangling\u002FSKILL.md",[],[84,89,40,90,91],"data wrangling","science","data",{"skillNo":93,"name":94,"nameZh":6,"description":95,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":96,"categories":97,"keywords":98,"publishedAt":42},"01M6CXT717GCN7SRRNPBDP4508","windows","Windows operating system administration and scripting","https:\u002F\u002Fgithub.com\u002Fffsshhttiikk\u002Fopencode-agents-skills\u002Fblob\u002Fmain\u002Fwindows\u002FSKILL.md",[],[94,99,40,100],"system","scripting",{"skillNo":102,"name":103,"nameZh":6,"description":104,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":105,"categories":106,"keywords":107,"publishedAt":42},"01M6CXT54K794NMEM3XAPZZDKT","wide-column","Wide-column data model","https:\u002F\u002Fgithub.com\u002Fffsshhttiikk\u002Fopencode-agents-skills\u002Fblob\u002Fmain\u002Fwide-column\u002FSKILL.md",[],[108,109,40,110,91],"wide column","databases","model",{"skillNo":112,"name":113,"nameZh":6,"description":114,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":115,"categories":116,"keywords":117,"publishedAt":42},"01M6CXT28FMT2P4V9GZE67WA8E","wide-column-stores","Wide-column database stores","https:\u002F\u002Fgithub.com\u002Fffsshhttiikk\u002Fopencode-agents-skills\u002Fblob\u002Fmain\u002Fwide-column-stores\u002FSKILL.md",[],[118,109,40,119],"wide column stores","database",{"skillNo":121,"name":122,"nameZh":6,"description":123,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":124,"categories":125,"keywords":126,"publishedAt":42},"01M6CXT0D0M0Q4T2N7C2RX7DSN","websockets","WebSocket implementation and best practices","https:\u002F\u002Fgithub.com\u002Fffsshhttiikk\u002Fopencode-agents-skills\u002Fblob\u002Fmain\u002Fwebsockets\u002FSKILL.md",[],[122,127,128,129,40,39,130],"websocket","real-time","time","implementation"]