{"id":1020,"date":"2020-03-19T17:46:57","date_gmt":"2020-03-19T09:46:57","guid":{"rendered":"http:\/\/www.shuran.cn\/?p=1020"},"modified":"2020-03-19T17:46:57","modified_gmt":"2020-03-19T09:46:57","slug":"restful-api-%e8%ae%be%e8%ae%a1%e8%a7%84%e8%8c%83","status":"publish","type":"post","link":"https:\/\/www.shuran.cn\/?p=1020","title":{"rendered":"RESTful API \u8bbe\u8ba1\u89c4\u8303"},"content":{"rendered":"\n<h1 class=\"wp-block-heading\" id=\"RESTful-API-\u8bbe\u8ba1\u89c4\u8303\">RESTful API \u8bbe\u8ba1\u89c4\u8303<\/h1>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\"><p>\u539f\u6587\u94fe\u63a5\uff1a<a href=\"https:\/\/sitoi.cn\/go.html?u=aHR0cHM6Ly9naXRodWIuY29tL2dvZHJ1b3lpL3Jlc3RmdWwtYXBpLXNwZWNpZmljYXRpb24=\" rel=\"noreferrer noopener\" target=\"_blank\">https:\/\/github.com\/godruoyi\/restful-api-specification<\/a><\/p><\/blockquote>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"toc-heading-1\">\u5173\u4e8e\u300c\u80fd\u613f\u52a8\u8bcd\u300d\u7684\u4f7f\u7528<\/h2>\n\n\n\n<p>\u4e3a\u4e86\u907f\u514d\u6b67\u4e49\uff0c\u6587\u6863\u5927\u91cf\u4f7f\u7528\u4e86\u300c\u80fd\u613f\u52a8\u8bcd\u300d\uff0c\u5bf9\u5e94\u7684\u89e3\u91ca\u5982\u4e0b\uff1a<\/p>\n\n\n\n<ul class=\"wp-block-list\"><li><code>\u5fc5\u987b (MUST)<\/code>\uff1a\u7edd\u5bf9\uff0c\u4e25\u683c\u9075\u5faa\uff0c\u8bf7\u7167\u505a\uff0c\u65e0\u6761\u4ef6\u9075\u5b88\uff1b<\/li><li><code>\u4e00\u5b9a\u4e0d\u53ef (MUST NOT)<\/code>\uff1a\u7981\u4ee4\uff0c\u4e25\u4ee4\u7981\u6b62\uff1b<\/li><li><code>\u5e94\u8be5 (SHOULD)<\/code>&nbsp;\uff1a\u5f3a\u70c8\u5efa\u8bae\u8fd9\u6837\u505a\uff0c\u4f46\u662f\u4e0d\u5f3a\u6c42\uff1b<\/li><li><code>\u4e0d\u8be5 (SHOULD NOT)<\/code>\uff1a\u5f3a\u70c8\u4e0d\u5efa\u8bae\u8fd9\u6837\u505a\uff0c\u4f46\u662f\u4e0d\u5f3a\u6c42\uff1b<\/li><li><code>\u53ef\u4ee5 (MAY)<\/code>&nbsp;\u548c&nbsp;<code>\u53ef\u9009 (OPTIONAL)<\/code>&nbsp;\uff1a\u9009\u62e9\u6027\u9ad8\u4e00\u70b9\uff0c\u5728\u8fd9\u4e2a\u6587\u6863\u5185\uff0c\u6b64\u8bcd\u8bed\u4f7f\u7528\u8f83\u5c11\uff1b<\/li><\/ul>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\"><p>\u53c2\u89c1\uff1a<a href=\"https:\/\/sitoi.cn\/go.html?u=aHR0cDovL3d3dy5pZXRmLm9yZy9yZmMvcmZjMjExOS50eHQ=\" rel=\"noreferrer noopener\" target=\"_blank\">RFC 2119<\/a><\/p><\/blockquote>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"toc-heading-2\">Protocol<\/h2>\n\n\n\n<p>\u5ba2\u6237\u7aef\u5728\u901a\u8fc7&nbsp;<code>API<\/code>&nbsp;\u4e0e\u540e\u7aef\u670d\u52a1\u901a\u4fe1\u7684\u8fc7\u7a0b\u4e2d\uff0c<code>\u5e94\u8be5<\/code>&nbsp;\u4f7f\u7528&nbsp;<code>HTTPS<\/code>&nbsp;\u534f\u8bae\u3002<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"toc-heading-3\">API Root URL<\/h2>\n\n\n\n<p><code>API<\/code>&nbsp;\u7684\u6839\u5165\u53e3\u70b9\u5e94\u5c3d\u53ef\u80fd\u4fdd\u6301\u8db3\u591f\u7b80\u5355\uff0c\u8fd9\u91cc\u6709\u4e24\u4e2a\u5e38\u89c1\u7684&nbsp;<code>URL<\/code>&nbsp;\u6839\u4f8b\u5b50\uff1a<\/p>\n\n\n\n<ul class=\"wp-block-list\"><li>api.example.com\/*<\/li><li>example.com\/api\/*<\/li><\/ul>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\"><p>\u5982\u679c\u4f60\u7684\u5e94\u7528\u5f88\u5e9e\u5927\u6216\u8005\u4f60\u9884\u8ba1\u5b83\u5c06\u4f1a\u53d8\u7684\u5f88\u5e9e\u5927\uff0c\u90a3&nbsp;<code>\u5e94\u8be5<\/code>&nbsp;\u5c06&nbsp;<code>API<\/code>&nbsp;\u653e\u5230\u5b50\u57df\u4e0b\uff08<code>api.example.com<\/code>\uff09\u3002\u8fd9\u79cd\u505a\u6cd5\u53ef\u4ee5\u4fdd\u6301\u67d0\u4e9b\u89c4\u6a21\u5316\u4e0a\u7684\u7075\u6d3b\u6027\u3002<\/p><\/blockquote>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"toc-heading-4\">Versioning<\/h2>\n\n\n\n<p>\u6240\u6709\u7684&nbsp;<code>API<\/code>&nbsp;\u5fc5\u987b\u4fdd\u6301\u5411\u540e\u517c\u5bb9\uff0c\u4f60&nbsp;<code>\u5fc5\u987b<\/code>&nbsp;\u5728\u5f15\u5165\u65b0\u7248\u672c&nbsp;<code>API<\/code>&nbsp;\u7684\u540c\u65f6\u786e\u4fdd\u65e7\u7248\u672c&nbsp;<code>API<\/code>&nbsp;\u4ecd\u7136\u53ef\u7528\u3002\u6240\u4ee5&nbsp;<code>\u5e94\u8be5<\/code>&nbsp;\u4e3a\u5176\u63d0\u4f9b\u7248\u672c\u652f\u6301\u3002<\/p>\n\n\n\n<p>\u76ee\u524d\u6bd4\u8f83\u5e38\u89c1\u7684\u4e24\u79cd\u7248\u672c\u53f7\u5f62\u5f0f\uff1a<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"toc-heading-5\">\u5728 URL \u4e2d\u5d4c\u5165\u7248\u672c\u7f16\u53f7<\/h3>\n\n\n\n<p>Http<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>api.example.com\/v1\/*<\/code><\/pre>\n\n\n\n<p>\u8fd9\u79cd\u505a\u6cd5\u662f\u7248\u672c\u53f7\u76f4\u89c2\u3001\u6613\u4e8e\u8c03\u8bd5\uff1b\u53e6\u4e00\u79cd\u505a\u6cd5\u662f\uff0c\u5c06\u7248\u672c\u53f7\u653e\u5728&nbsp;<code>HTTP Header<\/code>&nbsp;\u5934\u4e2d\uff1a<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"toc-heading-6\">\u901a\u8fc7\u5a92\u4f53\u7c7b\u578b\u6765\u6307\u5b9a\u7248\u672c\u4fe1\u606f<\/h3>\n\n\n\n<p>Http<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>Accept: application\/vnd.example.com.v1+json<\/code><\/pre>\n\n\n\n<p>\u5176\u4e2d&nbsp;<code>vnd<\/code>&nbsp;\u8868\u793a&nbsp;<code>Standards Tree<\/code>&nbsp;\u6807\u51c6\u6811\u7c7b\u578b\uff0c\u6709\u4e09\u4e2a\u4e0d\u540c\u7684\u6811:&nbsp;<code>x<\/code>\uff0c<code>prs<\/code>&nbsp;\u548c&nbsp;<code>vnd<\/code>\u3002\u4f60\u4f7f\u7528\u7684\u6807\u51c6\u6811\u9700\u8981\u53d6\u51b3\u4e8e\u4f60\u5f00\u53d1\u7684\u9879\u76ee<\/p>\n\n\n\n<ul class=\"wp-block-list\"><li>\u672a\u6ce8\u518c\u7684\u6811\uff08<code>x<\/code>\uff09\u4e3b\u8981\u8868\u793a\u672c\u5730\u548c\u79c1\u6709\u73af\u5883<\/li><li>\u79c1\u6709\u6811\uff08<code>prs<\/code>\uff09\u4e3b\u8981\u8868\u793a\u6ca1\u6709\u5546\u4e1a\u53d1\u5e03\u7684\u9879\u76ee<\/li><li>\u4f9b\u5e94\u5546\u6811\uff08<code>vnd<\/code>\uff09\u4e3b\u8981\u8868\u793a\u516c\u5f00\u53d1\u5e03\u7684\u9879\u76ee<\/li><\/ul>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\"><p>\u540e\u9762\u51e0\u4e2a\u53c2\u6570\u4f9d\u6b21\u4e3a\u5e94\u7528\u540d\u79f0\uff08\u4e00\u822c\u4e3a\u5e94\u7528\u57df\u540d\uff09\u3001\u7248\u672c\u53f7\u3001\u671f\u671b\u7684\u8fd4\u56de\u683c\u5f0f\u3002<\/p><\/blockquote>\n\n\n\n<p>\u81f3\u4e8e\u5177\u4f53\u628a\u7248\u672c\u53f7\u653e\u5728\u4ec0\u4e48\u5730\u65b9\uff0c\u8fd9\u4e2a\u95ee\u9898\u4e00\u76f4\u5b58\u5728\u5f88\u5927\u7684\u4e89\u8bae\uff0c\u4f46\u7531\u4e8e\u6211\u4eec\u5927\u591a\u6570\u65f6\u95f4\u90fd\u5728\u4f7f\u7528&nbsp;<code>Laravel<\/code>&nbsp;\u5f00\u53d1\uff0c<code>\u5e94\u8be5<\/code>&nbsp;\u4f7f\u7528&nbsp;<a href=\"https:\/\/sitoi.cn\/go.html?u=aHR0cHM6Ly9naXRodWIuY29tL2RpbmdvL2FwaQ==\" rel=\"noreferrer noopener\" target=\"_blank\">dingo\/api<\/a>&nbsp;\u6765\u5feb\u901f\u6784\u5efa\u5e94\u7528\uff0c\u5b83\u91c7\u7528\u7b2c\u4e8c\u79cd\u65b9\u5f0f\u6765\u7ba1\u7406&nbsp;<code>API<\/code>&nbsp;\u7248\u672c\uff0c\u5e76\u4e14\u5df2\u96c6\u6210\u4e86\u6807\u51c6\u7684&nbsp;<code>HTTP Response<\/code>\u3002<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"toc-heading-7\">Endpoints<\/h2>\n\n\n\n<p>\u7aef\u70b9\u5c31\u662f\u6307\u5411\u7279\u5b9a\u8d44\u6e90\u6216\u8d44\u6e90\u96c6\u5408\u7684&nbsp;<code>URL<\/code>\u3002\u5728\u7aef\u70b9\u7684\u8bbe\u8ba1\u4e2d\uff0c\u4f60&nbsp;<code>\u5fc5\u987b<\/code>&nbsp;\u9075\u5b88\u4e0b\u5217\u7ea6\u5b9a\uff1a<\/p>\n\n\n\n<ul class=\"wp-block-list\"><li>URL \u7684\u547d\u540d&nbsp;<code>\u5fc5\u987b<\/code>&nbsp;\u5168\u90e8\u5c0f\u5199<\/li><li>URL \u4e2d\u8d44\u6e90\uff08<code>resource<\/code>\uff09\u7684\u547d\u540d&nbsp;<code>\u5fc5\u987b<\/code>&nbsp;\u662f\u540d\u8bcd\uff0c\u5e76\u4e14&nbsp;<code>\u5fc5\u987b<\/code>&nbsp;\u662f\u590d\u6570\u5f62\u5f0f<\/li><li><code>\u5fc5\u987b<\/code>&nbsp;\u4f18\u5148\u4f7f\u7528&nbsp;<code>Restful<\/code>&nbsp;\u7c7b\u578b\u7684 URL<\/li><li>URL&nbsp;<code>\u5fc5\u987b<\/code>&nbsp;\u662f\u6613\u8bfb\u7684<\/li><li>URL&nbsp;<code>\u4e00\u5b9a\u4e0d\u53ef<\/code>&nbsp;\u66b4\u9732\u670d\u52a1\u5668\u67b6\u6784<\/li><\/ul>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\"><p>\u81f3\u4e8e URL \u662f\u5426\u5fc5\u987b\u4f7f\u7528\u8fde\u5b57\u7b26\uff08<code>-<\/code>\uff09 \u6216\u4e0b\u5212\u7ebf\uff08<code>_<\/code>\uff09\uff0c\u4e0d\u505a\u786c\u6027\u89c4\u5b9a\uff0c\u4f46&nbsp;<code>\u5fc5\u987b<\/code>&nbsp;\u6839\u636e\u56e2\u961f\u60c5\u51b5\u7edf\u4e00\u4e00\u79cd\u98ce\u683c\u3002<\/p><\/blockquote>\n\n\n\n<p>\u6765\u770b\u4e00\u4e2a\u53cd\u4f8b<\/p>\n\n\n\n<ul class=\"wp-block-list\"><li><a href=\"https:\/\/sitoi.cn\/go.html?u=aHR0cHM6Ly9hcGkuZXhhbXBsZS5jb20vZ2V0VXNlckluZm8\/dXNlcmlkPTE=\" rel=\"noreferrer noopener\" target=\"_blank\">https:\/\/api.example.com\/getUserInfo?userid=1<\/a><\/li><li><a href=\"https:\/\/sitoi.cn\/go.html?u=aHR0cHM6Ly9hcGkuZXhhbXBsZS5jb20vZ2V0dXNlcnM=\" rel=\"noreferrer noopener\" target=\"_blank\">https:\/\/api.example.com\/getusers<\/a><\/li><li><a href=\"https:\/\/sitoi.cn\/go.html?u=aHR0cHM6Ly9hcGkuZXhhbXBsZS5jb20vc3YvdQ==\" rel=\"noreferrer noopener\" target=\"_blank\">https:\/\/api.example.com\/sv\/u<\/a><\/li><li><a href=\"https:\/\/sitoi.cn\/go.html?u=aHR0cHM6Ly9hcGkuZXhhbXBsZS5jb20vY2dpLWJpbi91c2Vycy9nZXRfdXNlci5waHA\/dXNlcmlkPTE=\" rel=\"noreferrer noopener\" target=\"_blank\">https:\/\/api.example.com\/cgi-bin\/users\/get_user.php?userid=1<\/a><\/li><\/ul>\n\n\n\n<p>\u518d\u6765\u770b\u4e00\u4e2a\u6b63\u5217<\/p>\n\n\n\n<ul class=\"wp-block-list\"><li><a href=\"https:\/\/sitoi.cn\/go.html?u=aHR0cHM6Ly9hcGkuZXhhbXBsZS5jb20vem9vcw==\" rel=\"noreferrer noopener\" target=\"_blank\">https:\/\/api.example.com\/zoos<\/a><\/li><li><a href=\"https:\/\/sitoi.cn\/go.html?u=aHR0cHM6Ly9hcGkuZXhhbXBsZS5jb20vYW5pbWFscw==\" rel=\"noreferrer noopener\" target=\"_blank\">https:\/\/api.example.com\/animals<\/a><\/li><li><a href=\"https:\/\/sitoi.cn\/go.html?u=aHR0cHM6Ly9hcGkuZXhhbXBsZS5jb20vem9vcy97em9vfS9hbmltYWxz\" rel=\"noreferrer noopener\" target=\"_blank\">https:\/\/api.example.com\/zoos\/{zoo}\/animals<\/a><\/li><li><a href=\"https:\/\/sitoi.cn\/go.html?u=aHR0cHM6Ly9hcGkuZXhhbXBsZS5jb20vYW5pbWFsX3R5cGVz\" rel=\"noreferrer noopener\" target=\"_blank\">https:\/\/api.example.com\/animal_types<\/a><\/li><li><a href=\"https:\/\/sitoi.cn\/go.html?u=aHR0cHM6Ly9hcGkuZXhhbXBsZS5jb20vZW1wbG95ZWVz\" rel=\"noreferrer noopener\" target=\"_blank\">https:\/\/api.example.com\/employees<\/a><\/li><\/ul>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"toc-heading-8\">HTTP \u52a8\u8bcd<\/h2>\n\n\n\n<p>\u5bf9\u4e8e\u8d44\u6e90\u7684\u5177\u4f53\u64cd\u4f5c\u7c7b\u578b\uff0c\u7531&nbsp;<code>HTTP<\/code>&nbsp;\u52a8\u8bcd\u8868\u793a\u3002\u5e38\u7528\u7684&nbsp;<code>HTTP<\/code>&nbsp;\u52a8\u8bcd\u6709\u4e0b\u9762\u4e94\u4e2a\uff08\u62ec\u53f7\u91cc\u662f\u5bf9\u5e94\u7684&nbsp;<code>SQL<\/code>&nbsp;\u547d\u4ee4\uff09\u3002<\/p>\n\n\n\n<ul class=\"wp-block-list\"><li>GET\uff08SELECT\uff09\uff1a\u4ece\u670d\u52a1\u5668\u53d6\u51fa\u8d44\u6e90\uff08\u4e00\u9879\u6216\u591a\u9879\uff09\u3002<\/li><li>POST\uff08CREATE\uff09\uff1a\u5728\u670d\u52a1\u5668\u65b0\u5efa\u4e00\u4e2a\u8d44\u6e90\u3002<\/li><li>PUT\uff08UPDATE\uff09\uff1a\u5728\u670d\u52a1\u5668\u66f4\u65b0\u8d44\u6e90\uff08\u5ba2\u6237\u7aef\u63d0\u4f9b\u6539\u53d8\u540e\u7684\u5b8c\u6574\u8d44\u6e90\uff09\u3002<\/li><li>PATCH\uff08UPDATE\uff09\uff1a\u5728\u670d\u52a1\u5668\u66f4\u65b0\u8d44\u6e90\uff08\u5ba2\u6237\u7aef\u63d0\u4f9b\u6539\u53d8\u7684\u5c5e\u6027\uff09\u3002<\/li><li>DELETE\uff08DELETE\uff09\uff1a\u4ece\u670d\u52a1\u5668\u5220\u9664\u8d44\u6e90\u3002<\/li><\/ul>\n\n\n\n<p>\u5176\u4e2d<\/p>\n\n\n\n<p>1 \u5220\u9664\u8d44\u6e90&nbsp;<code>\u5fc5\u987b<\/code>&nbsp;\u7528&nbsp;<code>DELETE<\/code>&nbsp;\u65b9\u6cd5<br>2 \u521b\u5efa\u65b0\u7684\u8d44\u6e90&nbsp;<code>\u5fc5\u987b<\/code>&nbsp;\u4f7f\u7528&nbsp;<code>POST<\/code>&nbsp;\u65b9\u6cd5<br>3 \u66f4\u65b0\u8d44\u6e90&nbsp;<code>\u5e94\u8be5<\/code>&nbsp;\u4f7f\u7528&nbsp;<code>PUT<\/code>&nbsp;\u65b9\u6cd5<br>4 \u83b7\u53d6\u8d44\u6e90\u4fe1\u606f&nbsp;<code>\u5fc5\u987b<\/code>&nbsp;\u4f7f\u7528&nbsp;<code>GET<\/code>&nbsp;\u65b9\u6cd5<\/p>\n\n\n\n<p>\u9488\u5bf9\u6bcf\u4e00\u4e2a\u7aef\u70b9\u6765\u8bf4\uff0c\u4e0b\u9762\u5217\u51fa\u6240\u6709\u53ef\u884c\u7684&nbsp;<code>HTTP<\/code>&nbsp;\u52a8\u8bcd\u548c\u7aef\u70b9\u7684\u7ec4\u5408<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"\"><thead><tr><th>\u8bf7\u6c42\u65b9\u6cd5<\/th><th>URL<\/th><th>\u63cf\u8ff0<\/th><\/tr><\/thead><tbody><tr><td>GET<\/td><td>\/zoos<\/td><td>\u5217\u51fa\u6240\u6709\u7684\u52a8\u7269\u56ed(ID\u548c\u540d\u79f0\uff0c\u4e0d\u8981\u592a\u8be6\u7ec6)<\/td><\/tr><tr><td>POST<\/td><td>\/zoos<\/td><td>\u65b0\u589e\u4e00\u4e2a\u65b0\u7684\u52a8\u7269\u56ed<\/td><\/tr><tr><td>GET<\/td><td>\/zoos\/{zoo}<\/td><td>\u83b7\u53d6\u6307\u5b9a\u52a8\u7269\u56ed\u8be6\u60c5<\/td><\/tr><tr><td>PUT<\/td><td>\/zoos\/{zoo}<\/td><td>\u66f4\u65b0\u6307\u5b9a\u52a8\u7269\u56ed(\u6574\u4e2a\u5bf9\u8c61)<\/td><\/tr><tr><td>PATCH<\/td><td>\/zoos\/{zoo}<\/td><td>\u66f4\u65b0\u52a8\u7269\u56ed(\u90e8\u5206\u5bf9\u8c61)<\/td><\/tr><tr><td>DELETE<\/td><td>\/zoos\/{zoo}<\/td><td>\u5220\u9664\u6307\u5b9a\u52a8\u7269\u56ed<\/td><\/tr><tr><td>GET<\/td><td>\/zoos\/{zoo}\/animals<\/td><td>\u68c0\u7d22\u6307\u5b9a\u52a8\u7269\u56ed\u4e0b\u7684\u52a8\u7269\u5217\u8868(ID\u548c\u540d\u79f0\uff0c\u4e0d\u8981\u592a\u8be6\u7ec6)<\/td><\/tr><tr><td>GET<\/td><td>\/animals<\/td><td>\u5217\u51fa\u6240\u6709\u52a8\u7269(ID\u548c\u540d\u79f0)\u3002<\/td><\/tr><tr><td>POST<\/td><td>\/animals<\/td><td>\u65b0\u589e\u65b0\u7684\u52a8\u7269<\/td><\/tr><tr><td>GET<\/td><td>\/animals\/{animal}<\/td><td>\u83b7\u53d6\u6307\u5b9a\u7684\u52a8\u7269\u8be6\u60c5<\/td><\/tr><tr><td>PUT<\/td><td>\/animals\/{animal}<\/td><td>\u66f4\u65b0\u6307\u5b9a\u7684\u52a8\u7269(\u6574\u4e2a\u5bf9\u8c61)<\/td><\/tr><tr><td>PATCH<\/td><td>\/animals\/{animal}<\/td><td>\u66f4\u65b0\u6307\u5b9a\u7684\u52a8\u7269(\u90e8\u5206\u5bf9\u8c61)<\/td><\/tr><tr><td>GET<\/td><td>\/animal_types<\/td><td>\u83b7\u53d6\u6240\u6709\u52a8\u7269\u7c7b\u578b(ID\u548c\u540d\u79f0\uff0c\u4e0d\u8981\u592a\u8be6\u7ec6)<\/td><\/tr><tr><td>GET<\/td><td>\/animal_types\/{type}<\/td><td>\u83b7\u53d6\u6307\u5b9a\u7684\u52a8\u7269\u7c7b\u578b\u8be6\u60c5<\/td><\/tr><tr><td>GET<\/td><td>\/employees<\/td><td>\u68c0\u7d22\u6574\u4e2a\u96c7\u5458\u5217\u8868<\/td><\/tr><tr><td>GET<\/td><td>\/employees\/{employee}<\/td><td>\u68c0\u7d22\u6307\u5b9a\u7279\u5b9a\u7684\u5458\u5de5<\/td><\/tr><tr><td>GET<\/td><td>\/zoos\/{zoo}\/employees<\/td><td>\u68c0\u7d22\u5728\u8fd9\u4e2a\u52a8\u7269\u56ed\u5de5\u4f5c\u7684\u96c7\u5458\u7684\u540d\u5355(\u8eab\u4efd\u8bc1\u548c\u59d3\u540d)<\/td><\/tr><tr><td>POST<\/td><td>\/employees<\/td><td>\u65b0\u589e\u6307\u5b9a\u65b0\u5458\u5de5<\/td><\/tr><tr><td>POST<\/td><td>\/zoos\/{zoo}\/employees<\/td><td>\u5728\u7279\u5b9a\u7684\u52a8\u7269\u56ed\u96c7\u4f63\u4e00\u540d\u5458\u5de5<\/td><\/tr><tr><td>DELETE<\/td><td>\/zoos\/{zoo}\/employees\/{employee}<\/td><td>\u4ece\u67d0\u4e2a\u52a8\u7269\u56ed\u89e3\u96c7\u4e00\u540d\u5458\u5de5<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\"><p>\u8d85\u51fa&nbsp;<code>Restful<\/code>&nbsp;\u7aef\u70b9\u7684\uff0c<code>\u5e94\u8be5<\/code>&nbsp;\u6a21\u4eff\u4e0a\u8868\u7684\u65b9\u5f0f\u6765\u5b9a\u4e49\u7aef\u70b9\u3002<\/p><\/blockquote>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"toc-heading-9\">Filtering<\/h2>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\"><p>\u5982\u679c\u8bb0\u5f55\u6570\u91cf\u5f88\u591a\uff0c\u670d\u52a1\u5668\u4e0d\u53ef\u80fd\u90fd\u5c06\u5b83\u4eec\u8fd4\u56de\u7ed9\u7528\u6237\u3002API&nbsp;<code>\u5e94\u8be5<\/code>&nbsp;\u63d0\u4f9b\u53c2\u6570\uff0c\u8fc7\u6ee4\u8fd4\u56de\u7ed3\u679c\u3002\u4e0b\u9762\u662f\u4e00\u4e9b\u5e38\u89c1\u7684\u53c2\u6570\u3002<\/p><\/blockquote>\n\n\n\n<ul class=\"wp-block-list\"><li>?limit=10\uff1a\u6307\u5b9a\u8fd4\u56de\u8bb0\u5f55\u7684\u6570\u91cf<\/li><li>?offset=10\uff1a\u6307\u5b9a\u8fd4\u56de\u8bb0\u5f55\u7684\u5f00\u59cb\u4f4d\u7f6e\u3002<\/li><li>?page=2&amp;per_page=100\uff1a\u6307\u5b9a\u7b2c\u51e0\u9875\uff0c\u4ee5\u53ca\u6bcf\u9875\u7684\u8bb0\u5f55\u6570\u3002<\/li><li>?sortby=name&amp;order=asc\uff1a\u6307\u5b9a\u8fd4\u56de\u7ed3\u679c\u6309\u7167\u54ea\u4e2a\u5c5e\u6027\u6392\u5e8f\uff0c\u4ee5\u53ca\u6392\u5e8f\u987a\u5e8f\u3002<\/li><li>?animal_type_id=1\uff1a\u6307\u5b9a\u7b5b\u9009\u6761\u4ef6<\/li><\/ul>\n\n\n\n<p>\u6240\u6709&nbsp;<code>URL<\/code>&nbsp;\u53c2\u6570&nbsp;<code>\u5fc5\u987b<\/code>&nbsp;\u662f\u5168\u5c0f\u5199\uff0c<code>\u5fc5\u987b<\/code>&nbsp;\u4f7f\u7528\u4e0b\u5212\u7ebf\u7c7b\u578b\u7684\u53c2\u6570\u5f62\u5f0f\u3002<\/p>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\"><p>\u5206\u9875\u53c2\u6570&nbsp;<code>\u5fc5\u987b<\/code>&nbsp;\u56fa\u5b9a\u4e3a&nbsp;<code>page<\/code>\u3001<code>per_page<\/code><\/p><\/blockquote>\n\n\n\n<p>\u7ecf\u5e38\u4f7f\u7528\u7684\u3001\u590d\u6742\u7684\u67e5\u8be2&nbsp;<code>\u5e94\u8be5<\/code>&nbsp;\u6807\u7b7e\u5316\uff0c\u964d\u4f4e\u7ef4\u62a4\u6210\u672c\u3002\u5982Http<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>GET \/trades?status=closed&amp;sort=sortby=name&amp;order=asc\n\n# \u53ef\u4e3a\u5176\u5b9a\u5236\u5feb\u6377\u65b9\u5f0f\nGET \/trades\/recently_closed<\/code><\/pre>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"toc-heading-10\">Authentication<\/h2>\n\n\n\n<p><code>\u5e94\u8be5<\/code>&nbsp;\u4f7f\u7528&nbsp;<code>OAuth2.0<\/code>&nbsp;\u7684\u65b9\u5f0f\u4e3a API \u8c03\u7528\u8005\u63d0\u4f9b\u767b\u5f55\u8ba4\u8bc1\u3002<code>\u5fc5\u987b<\/code>&nbsp;\u5148\u901a\u8fc7\u767b\u5f55\u63a5\u53e3\u83b7\u53d6&nbsp;<code>Access Token<\/code>&nbsp;\u540e\u518d\u901a\u8fc7\u8be5&nbsp;<code>token<\/code>&nbsp;\u8c03\u7528\u9700\u8981\u8eab\u4efd\u8ba4\u8bc1\u7684&nbsp;<code>API<\/code>\u3002<\/p>\n\n\n\n<p>Oauth \u7684\u7aef\u70b9\u8bbe\u8ba1\u793a\u5217<\/p>\n\n\n\n<ul class=\"wp-block-list\"><li>RFC 6749 \/token<\/li><li>Twitter \/oauth2\/token<\/li><li>Fackbook \/oauth\/access_token<\/li><li>Google \/o\/oauth2\/token<\/li><li>Github \/login\/oauth\/access_token<\/li><li>Instagram \/oauth\/authorize<\/li><\/ul>\n\n\n\n<p>\u5ba2\u6237\u7aef\u5728\u83b7\u5f97&nbsp;<code>access token<\/code>&nbsp;\u7684\u540c\u65f6&nbsp;<code>\u5fc5\u987b<\/code>&nbsp;\u5728\u54cd\u5e94\u4e2d\u5305\u542b\u4e00\u4e2a\u540d\u4e3a&nbsp;<code>expires_in<\/code>&nbsp;\u7684\u6570\u636e\uff0c\u5b83\u8868\u793a\u5f53\u524d\u83b7\u5f97\u7684&nbsp;<code>token<\/code>&nbsp;\u4f1a\u5728\u591a\u5c11&nbsp;<code>\u79d2<\/code>&nbsp;\u540e\u5931\u6548\u3002Json<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n    \"access_token\": \"token....\",\n    \"token_type\": \"Bearer\",\n    \"expires_in\": 3600\n}<\/code><\/pre>\n\n\n\n<p>\u5ba2\u6237\u7aef\u5728\u8bf7\u6c42\u9700\u8981\u8ba4\u8bc1\u7684&nbsp;<code>API<\/code>&nbsp;\u65f6\uff0c<code>\u5fc5\u987b<\/code>&nbsp;\u5728\u8bf7\u6c42\u5934&nbsp;<code>Authorization<\/code>&nbsp;\u4e2d\u5e26\u4e0a&nbsp;<code>access_token<\/code>\u3002Bash<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>Authorization: Bearer token...<\/code><\/pre>\n\n\n\n<p>\u5f53\u8d85\u8fc7\u6307\u5b9a\u7684\u79d2\u6570\u540e\uff0c<code>access token<\/code>&nbsp;\u5c31\u4f1a\u8fc7\u671f\uff0c\u518d\u6b21\u7528\u8fc7\u671f\/\u6216\u65e0\u6548\u7684&nbsp;<code>token<\/code>&nbsp;\u8bbf\u95ee\u65f6\uff0c\u670d\u52a1\u7aef&nbsp;<code>\u5e94\u8be5<\/code>&nbsp;\u8fd4\u56de&nbsp;<code>invalid_token<\/code>&nbsp;\u7684\u9519\u8bef\u6216&nbsp;<code>401<\/code>&nbsp;\u9519\u8bef\u7801\u3002Http<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>HTTP\/1.1 401 Unauthorized\nContent-Type: application\/json\nCache-Control: no-store\nPragma: no-cache<\/code><\/pre>\n\n\n\n<p>Json<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n    \"error\": \"invalid_token\"\n}<\/code><\/pre>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\"><p>Laravel \u5f00\u53d1\u4e2d\uff0c<code>\u5e94\u8be5<\/code>&nbsp;\u4f7f\u7528&nbsp;<a href=\"https:\/\/sitoi.cn\/go.html?u=aHR0cHM6Ly9naXRodWIuY29tL3R5bW9uZGVzaWducy9qd3QtYXV0aA==\" rel=\"noreferrer noopener\" target=\"_blank\">JWT<\/a>&nbsp;\u6765\u4e3a\u7ba1\u7406\u4f60\u7684 Token\uff0c\u5e76\u4e14&nbsp;<code>\u4e00\u5b9a\u4e0d\u53ef<\/code>&nbsp;\u5728&nbsp;<code>api<\/code>&nbsp;\u4e2d\u95f4\u4ef6\u4e2d\u5f00\u542f\u8bf7\u6c42&nbsp;<code>session<\/code>\u3002<\/p><\/blockquote>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"toc-heading-11\">Response<\/h2>\n\n\n\n<p>\u6240\u6709\u7684&nbsp;<code>API<\/code>&nbsp;\u54cd\u5e94\uff0c<code>\u5fc5\u987b<\/code>&nbsp;\u9075\u5b88&nbsp;<code>HTTP<\/code>&nbsp;\u8bbe\u8ba1\u89c4\u8303\uff0c<code>\u5fc5\u987b<\/code>&nbsp;\u9009\u62e9\u5408\u9002\u7684&nbsp;<code>HTTP<\/code>&nbsp;\u72b6\u6001\u7801\u3002<code>\u4e00\u5b9a\u4e0d\u53ef<\/code>&nbsp;\u6240\u6709\u63a5\u53e3\u90fd\u8fd4\u56de\u72b6\u6001\u7801\u4e3a&nbsp;<code>200<\/code>&nbsp;\u7684&nbsp;<code>HTTP<\/code>&nbsp;\u54cd\u5e94\uff0c\u5982\uff1aHttp<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>HTTP\/1.1 200 ok\nContent-Type: application\/json\nServer: example.com<\/code><\/pre>\n\n\n\n<p>Json<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n    \"code\": 0,\n    \"msg\": \"success\",\n    \"data\": {\n        \"username\": \"username\"\n    }\n}<\/code><\/pre>\n\n\n\n<p>\u6216Http<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>HTTP\/1.1 200 ok\nContent-Type: application\/json\nServer: example.com<\/code><\/pre>\n\n\n\n<p>Json<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n    \"code\": -1,\n    \"msg\": \"\u8be5\u6d3b\u52a8\u4e0d\u5b58\u5728\"\n}<\/code><\/pre>\n\n\n\n<p>\u4e0b\u8868\u5217\u4e3e\u4e86\u5e38\u89c1\u7684&nbsp;<code>HTTP<\/code>&nbsp;\u72b6\u6001\u7801<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"\"><thead><tr><th>\u72b6\u6001\u7801<\/th><th>\u63cf\u8ff0<\/th><\/tr><\/thead><tbody><tr><td>1xx<\/td><td>\u4ee3\u8868\u8bf7\u6c42\u5df2\u88ab\u63a5\u53d7\uff0c\u9700\u8981\u7ee7\u7eed\u5904\u7406<\/td><\/tr><tr><td>2xx<\/td><td>\u8bf7\u6c42\u5df2\u6210\u529f\uff0c\u8bf7\u6c42\u6240\u5e0c\u671b\u7684\u54cd\u5e94\u5934\u6216\u6570\u636e\u4f53\u5c06\u968f\u6b64\u54cd\u5e94\u8fd4\u56de<\/td><\/tr><tr><td>3xx<\/td><td>\u91cd\u5b9a\u5411<\/td><\/tr><tr><td>4xx<\/td><td>\u5ba2\u6237\u7aef\u539f\u56e0\u5f15\u8d77\u7684\u9519\u8bef<\/td><\/tr><tr><td>5xx<\/td><td>\u670d\u52a1\u7aef\u539f\u56e0\u5f15\u8d77\u7684\u9519\u8bef<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\"><p>\u53ea\u6709\u6765\u81ea\u5ba2\u6237\u7aef\u7684\u8bf7\u6c42\u88ab\u6b63\u786e\u7684\u5904\u7406\u540e\u624d\u80fd\u8fd4\u56de&nbsp;<code>2xx<\/code>&nbsp;\u7684\u54cd\u5e94\uff0c\u6240\u4ee5\u5f53 API \u8fd4\u56de&nbsp;<code>2xx<\/code>&nbsp;\u7c7b\u578b\u7684\u72b6\u6001\u7801\u65f6\uff0c\u524d\u7aef&nbsp;<code>\u5fc5\u987b<\/code>&nbsp;\u8ba4\u5b9a\u8be5\u8bf7\u6c42\u5df2\u5904\u7406\u6210\u529f\u3002<\/p><\/blockquote>\n\n\n\n<p>\u5fc5\u987b\u5f3a\u8c03\u7684\u662f\uff0c\u6240\u6709&nbsp;<code>API<\/code>&nbsp;<code>\u4e00\u5b9a\u4e0d\u53ef<\/code>&nbsp;\u8fd4\u56de&nbsp;<code>1xx<\/code>&nbsp;\u7c7b\u578b\u7684\u72b6\u6001\u7801\u3002\u5f53&nbsp;<code>API<\/code>&nbsp;\u53d1\u751f\u9519\u8bef\u65f6\uff0c<code>\u5fc5\u987b<\/code>&nbsp;\u8fd4\u56de\u51fa\u9519\u65f6\u7684\u8be6\u7ec6\u4fe1\u606f\u3002\u76ee\u524d\u5e38\u89c1\u8fd4\u56de\u9519\u8bef\u4fe1\u606f\u7684\u65b9\u6cd5\u6709\u4e24\u79cd\uff1a<\/p>\n\n\n\n<p>1\u3001\u5c06\u9519\u8bef\u8be6\u7ec6\u653e\u5165&nbsp;<code>HTTP<\/code>&nbsp;\u54cd\u5e94\u9996\u90e8\uff1bHttp<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>X-MYNAME-ERROR-CODE: 4001\nX-MYNAME-ERROR-MESSAGE: Bad authentication token\nX-MYNAME-ERROR-INFO: http:\/\/docs.example.com\/api\/v1\/authentication<\/code><\/pre>\n\n\n\n<p>2\u3001\u76f4\u63a5\u653e\u5165\u54cd\u5e94\u5b9e\u4f53\u4e2d\uff1bHttp<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>HTTP\/1.1 401 Unauthorized\nServer: nginx\/1.11.9\nContent-Type: application\/json\nTransfer-Encoding: chunked\nCache-Control: no-cache, private\nDate: Sun, 24 Jun 2018 10:02:59 GMT\nConnection: keep-alive<\/code><\/pre>\n\n\n\n<p>Json<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n    \"error_code\":40100,\n    \"message\":\"Unauthorized\"\n}<\/code><\/pre>\n\n\n\n<p>\u8003\u8651\u5230\u6613\u8bfb\u6027\u548c\u5ba2\u6237\u7aef\u7684\u6613\u5904\u7406\u6027\uff0c\u6211\u4eec&nbsp;<code>\u5fc5\u987b<\/code>&nbsp;\u628a\u9519\u8bef\u4fe1\u606f\u76f4\u63a5\u653e\u5230\u54cd\u5e94\u5b9e\u4f53\u4e2d\uff0c\u5e76\u4e14\u9519\u8bef\u683c\u5f0f&nbsp;<code>\u5e94\u8be5<\/code>&nbsp;\u6ee1\u8db3\u5982\u4e0b\u683c\u5f0f\uff1aJson<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n    \"message\": \"\u60a8\u67e5\u627e\u7684\u8d44\u6e90\u4e0d\u5b58\u5728\",\n    \"error_code\": 404001\n}<\/code><\/pre>\n\n\n\n<p>\u5176\u4e2d\u9519\u8bef\u7801\uff08<code>error_code<\/code>\uff09<code>\u5fc5\u987b<\/code>&nbsp;\u548c&nbsp;<code>HTTP<\/code>&nbsp;\u72b6\u6001\u7801\u5bf9\u5e94\uff0c\u4e5f\u65b9\u4fbf\u9519\u8bef\u7801\u5f52\u7c7b\uff0c\u5982\uff1aHttp<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>HTTP\/1.1 429 Too Many Requests\nServer: nginx\/1.11.9\nContent-Type: application\/json\nTransfer-Encoding: chunked\nCache-Control: no-cache, private\nDate: Sun, 24 Jun 2018 10:15:52 GMT\nConnection: keep-alive<\/code><\/pre>\n\n\n\n<p>Json<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n    \"error_code\":429001,\n    \"message\":\"\u4f60\u64cd\u4f5c\u592a\u9891\u7e41\u4e86\"\n}<\/code><\/pre>\n\n\n\n<p>Http<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>HTTP\/1.1 403 Forbidden\nServer: nginx\/1.11.9\nContent-Type: application\/json\nTransfer-Encoding: chunked\nCache-Control: no-cache, private\nDate: Sun, 24 Jun 2018 10:19:27 GMT\nConnection: keep-alive<\/code><\/pre>\n\n\n\n<p>Json<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n    \"error_code\":403002,\n    \"message\":\"\u7528\u6237\u5df2\u7981\u7528\"\n}<\/code><\/pre>\n\n\n\n<p><code>\u5e94\u8be5<\/code>&nbsp;\u5728\u8fd4\u56de\u7684\u9519\u8bef\u4fe1\u606f\u4e2d\uff0c\u540c\u65f6\u5305\u542b\u9762\u5411\u5f00\u53d1\u8005\u548c\u9762\u5411\u7528\u6237\u7684\u63d0\u793a\u4fe1\u606f\uff0c\u524d\u8005\u53ef\u65b9\u4fbf\u5f00\u53d1\u4eba\u5458\u8c03\u8bd5\uff0c\u540e\u8005\u53ef\u76f4\u63a5\u5c55\u793a\u7ed9\u7ec8\u7aef\u7528\u6237\u67e5\u770b\u5982\uff1aJson<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n    \"message\": \"\u76f4\u63a5\u5c55\u793a\u7ed9\u7ec8\u7aef\u7528\u6237\u7684\u9519\u8bef\u4fe1\u606f\",\n    \"error_code\": \"\u4e1a\u52a1\u9519\u8bef\u7801\",\n    \"error\": \"\u4f9b\u5f00\u53d1\u8005\u67e5\u770b\u7684\u9519\u8bef\u4fe1\u606f\",\n    \"debug\": [\n        \"\u9519\u8bef\u5806\u6808\uff0c\u5fc5\u987b\u5f00\u542f debug \u624d\u5b58\u5728\"\n    ]\n}<\/code><\/pre>\n\n\n\n<p>\u4e0b\u9762\u8be6\u7ec6\u5217\u4e3e\u4e86\u5404\u79cd\u60c5\u51b5 API \u7684\u8fd4\u56de\u8bf4\u660e\u3002<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"toc-heading-12\">200 ok<\/h3>\n\n\n\n<p><code>200<\/code>&nbsp;\u72b6\u6001\u7801\u662f\u6700\u5e38\u89c1\u7684&nbsp;<code>HTTP<\/code>&nbsp;\u72b6\u6001\u7801\uff0c\u5728\u6240\u6709&nbsp;<strong>\u6210\u529f<\/strong>&nbsp;\u7684&nbsp;<code>GET<\/code>&nbsp;\u8bf7\u6c42\u4e2d\uff0c<code>\u5fc5\u987b<\/code>&nbsp;\u8fd4\u56de\u6b64\u72b6\u6001\u7801\u3002<code>HTTP<\/code>&nbsp;\u54cd\u5e94\u5b9e\u4f53\u90e8\u5206&nbsp;<code>\u5fc5\u987b<\/code>&nbsp;\u76f4\u63a5\u5c31\u662f\u6570\u636e\uff0c\u4e0d\u8981\u505a\u591a\u4f59\u7684\u5305\u88c5\u3002<\/p>\n\n\n\n<p>\u9519\u8bef\u793a\u4f8b\uff1aHttp<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>HTTP\/1.1 200 ok\nContent-Type: application\/json\nServer: example.com<\/code><\/pre>\n\n\n\n<p>Json<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n    \"user\": {\n        \"id\":1,\n        \"nickname\":\"fwest\",\n        \"username\": \"example\"\n    }\n}<\/code><\/pre>\n\n\n\n<p>\u6b63\u786e\u793a\u4f8b\uff1a<\/p>\n\n\n\n<p>1\u3001\u83b7\u53d6\u5355\u4e2a\u8d44\u6e90\u8be6\u60c5Json<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n    \"id\": 1,\n    \"username\": \"Sitoi\",\n    \"age\": 88\n}<\/code><\/pre>\n\n\n\n<p>2\u3001\u83b7\u53d6\u8d44\u6e90\u96c6\u5408Json<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>[\n    {\n        \"id\": 1,\n        \"username\": \"Sitoi\",\n        \"age\": 88\n    },\n    {\n        \"id\": 2,\n        \"username\": \"foo\",\n        \"age\": 88\n    }\n]<\/code><\/pre>\n\n\n\n<p>3\u3001\u989d\u5916\u7684\u5a92\u4f53\u4fe1\u606fJson<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n    \"data\": [\n        {\n            \"id\": 1,\n            \"avatar\": \"https:\/\/lorempixel.com\/640\/480\/?32556\",\n            \"nickname\": \"fwest\",\n            \"last_logined_time\": \"2018-05-29 04:56:43\",\n            \"has_registed\": true\n        },\n        {\n            \"id\": 2,\n            \"avatar\": \"https:\/\/lorempixel.com\/640\/480\/?86144\",\n            \"nickname\": \"zschowalter\",\n            \"last_logined_time\": \"2018-06-16 15:18:34\",\n            \"has_registed\": true\n        }\n    ],\n    \"meta\": {\n        \"pagination\": {\n            \"total\": 101,\n            \"count\": 2,\n            \"per_page\": 2,\n            \"current_page\": 1,\n            \"total_pages\": 51,\n            \"links\": {\n                \"next\": \"http:\/\/api.example.com?page=2\"\n            }\n        }\n    }\n}<\/code><\/pre>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\"><p>\u5176\u4e2d\uff0c\u5206\u9875\u548c\u5176\u4ed6\u989d\u5916\u7684\u5a92\u4f53\u4fe1\u606f\uff0c\u5fc5\u987b\u653e\u5230&nbsp;<code>meta<\/code>&nbsp;\u5b57\u6bb5\u4e2d\u3002<\/p><\/blockquote>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"toc-heading-13\">201 Created<\/h3>\n\n\n\n<p>\u5f53\u670d\u52a1\u5668\u521b\u5efa\u6570\u636e\u6210\u529f\u65f6\uff0c<code>\u5e94\u8be5<\/code>&nbsp;\u8fd4\u56de\u6b64\u72b6\u6001\u7801\u3002\u5e38\u89c1\u7684\u5e94\u7528\u573a\u666f\u662f\u4f7f\u7528&nbsp;<code>POST<\/code>&nbsp;\u63d0\u4ea4\u7528\u6237\u4fe1\u606f\uff0c\u5982\uff1a<\/p>\n\n\n\n<ul class=\"wp-block-list\"><li>\u6dfb\u52a0\u4e86\u65b0\u7528\u6237<\/li><li>\u4e0a\u4f20\u4e86\u56fe\u7247<\/li><li>\u521b\u5efa\u4e86\u65b0\u6d3b\u52a8<\/li><\/ul>\n\n\n\n<p>\u7b49\uff0c\u90fd\u53ef\u4ee5\u8fd4\u56de&nbsp;<code>201<\/code>&nbsp;\u72b6\u6001\u7801\u3002\u9700\u8981\u6ce8\u610f\u7684\u662f\uff0c\u4f60\u53ef\u4ee5\u9009\u62e9\u5728\u7528\u6237\u521b\u5efa\u6210\u529f\u540e\u8fd4\u56de\u65b0\u7528\u6237\u7684\u6570\u636eHttp<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>HTTP\/1.1 201 Created\nServer: nginx\/1.11.9\nContent-Type: application\/json\nTransfer-Encoding: chunked\nDate: Sun, 24 Jun 2018 09:13:40 GMT\nConnection: keep-alive<\/code><\/pre>\n\n\n\n<p>Json<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n    \"id\": 1,\n    \"avatar\": \"https:\\\/\\\/lorempixel.com\\\/640\\\/480\\\/?32556\",\n    \"nickname\": \"fwest\",\n    \"last_logined_time\": \"2018-05-29 04:56:43\",\n    \"created_at\": \"2018-06-16 17:55:55\",\n    \"updated_at\": \"2018-06-16 17:55:55\"\n}<\/code><\/pre>\n\n\n\n<p>\u4e5f\u53ef\u4ee5\u8fd4\u56de\u4e00\u4e2a\u54cd\u5e94\u5b9e\u4f53\u4e3a\u7a7a\u7684&nbsp;<code>HTTP Response<\/code>&nbsp;\u5982\uff1aHttp<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>HTTP\/1.1 201 Created\nServer: nginx\/1.11.9\nContent-Type: text\/html; charset=UTF-8\nTransfer-Encoding: chunked\nDate: Sun, 24 Jun 2018 09:12:20 GMT\nConnection: keep-alive<\/code><\/pre>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\"><p>\u8fd9\u91cc\u6211\u4eec&nbsp;<code>\u5e94\u8be5<\/code>&nbsp;\u91c7\u7528\u7b2c\u4e8c\u79cd\u65b9\u5f0f\uff0c\u56e0\u4e3a\u5927\u591a\u6570\u60c5\u51b5\u4e0b\uff0c\u5ba2\u6237\u7aef\u53ea\u9700\u8981\u77e5\u9053\u8be5\u8bf7\u6c42\u64cd\u4f5c\u6210\u529f\u4e0e\u5426\uff0c\u5e76\u4e0d\u9700\u8981\u8fd4\u56de\u65b0\u8d44\u6e90\u7684\u4fe1\u606f\u3002<\/p><\/blockquote>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"toc-heading-14\">202 Accepted<\/h3>\n\n\n\n<p>\u8be5\u72b6\u6001\u7801\u8868\u793a\u670d\u52a1\u5668\u5df2\u7ecf\u63a5\u53d7\u5230\u4e86\u6765\u81ea\u5ba2\u6237\u7aef\u7684\u8bf7\u6c42\uff0c\u4f46\u8fd8\u672a\u5f00\u59cb\u5904\u7406\u3002\u5e38\u7528\u77ed\u4fe1\u53d1\u9001\u3001\u90ae\u4ef6\u901a\u77e5\u3001\u6a21\u677f\u6d88\u606f\u63a8\u9001\u7b49\u8fd9\u7c7b\u5f88\u8017\u65f6\u9700\u8981\u961f\u5217\u652f\u6301\u7684\u573a\u666f\u4e2d\uff1b<\/p>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\"><p>\u8fd4\u56de\u8be5\u72b6\u6001\u7801\u65f6\uff0c\u54cd\u5e94\u5b9e\u4f53&nbsp;<code>\u5fc5\u987b<\/code>&nbsp;\u4e3a\u7a7a\u3002<\/p><\/blockquote>\n\n\n\n<p>Http<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>HTTP\/1.1 202 Accepted\nServer: nginx\/1.11.9\nContent-Type: text\/html; charset=UTF-8\nTransfer-Encoding: chunked\nDate: Sun, 24 Jun 2018 09:25:15 GMT\nConnection: keep-alive<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"toc-heading-15\">204 No Content<\/h3>\n\n\n\n<p>\u8be5\u72b6\u6001\u7801\u8868\u793a\u54cd\u5e94\u5b9e\u4f53\u4e0d\u5305\u542b\u4efb\u4f55\u6570\u636e\uff0c\u5176\u4e2d\uff1a<\/p>\n\n\n\n<ul class=\"wp-block-list\"><li>\u5728\u4f7f\u7528&nbsp;<code>DELETE<\/code>&nbsp;\u65b9\u6cd5\u5220\u9664\u8d44\u6e90&nbsp;<strong>\u6210\u529f<\/strong>&nbsp;\u65f6\uff0c<code>\u5fc5\u987b<\/code>&nbsp;\u8fd4\u56de\u8be5\u72b6\u6001\u7801<\/li><li>\u4f7f\u7528&nbsp;<code>PUT<\/code>\u3001<code>PATCH<\/code>&nbsp;\u65b9\u6cd5\u66f4\u65b0\u6570\u636e&nbsp;<strong>\u6210\u529f<\/strong>&nbsp;\u65f6\uff0c\u4e5f&nbsp;<code>\u5e94\u8be5<\/code>&nbsp;\u8fd4\u56de\u6b64\u72b6\u6001\u7801<\/li><\/ul>\n\n\n\n<p>Http<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>HTTP\/1.1 204 No Content\nServer: nginx\/1.11.9\nDate: Sun, 24 Jun 2018 09:29:12 GMT\nConnection: keep-alive<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"toc-heading-16\">3xx \u91cd\u5b9a\u5411<\/h3>\n\n\n\n<p>\u6240\u6709&nbsp;<code>API<\/code>&nbsp;<code>\u4e0d\u8be5<\/code>&nbsp;\u8fd4\u56de&nbsp;<code>3xx<\/code>&nbsp;\u7c7b\u578b\u7684\u72b6\u6001\u7801\u3002\u56e0\u4e3a&nbsp;<code>3xx<\/code>&nbsp;\u7c7b\u578b\u7684\u54cd\u5e94\u683c\u5f0f\u4e00\u822c\u4e3a\u4e0b\u5217\u683c\u5f0f\uff1aHttp<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>HTTP\/1.1 302 Found\nServer: nginx\/1.11.9\nContent-Type: text\/html; charset=UTF-8\nTransfer-Encoding: chunked\nCache-Control: no-cache, private\nDate: Sun, 24 Jun 2018 09:41:50 GMT\nLocation: https:\/\/example.com\nConnection: keep-alive<\/code><\/pre>\n\n\n\n<p>Html<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>&lt;!DOCTYPE html>\n&lt;html>\n    &lt;head>\n        &lt;meta charset=\"UTF-8\" \/>\n        &lt;meta http-equiv=\"refresh\" content=\"0;url=https:\/\/example.com\" \/>\n\n        &lt;title>Redirecting to https:\/\/example.com&lt;\/title>\n    &lt;\/head>\n    &lt;body>\n        Redirecting to &lt;a href=\"https:\/\/example.com\">https:\/\/example.com&lt;\/a>.\n    &lt;\/body>\n&lt;\/html><\/code><\/pre>\n\n\n\n<p>\u6240\u6709&nbsp;<code>API<\/code>&nbsp;<code>\u4e00\u5b9a\u4e0d\u53ef<\/code>&nbsp;\u8fd4\u56de\u7eaf&nbsp;<code>HTML<\/code>&nbsp;\u7ed3\u6784\u7684\u54cd\u5e94\uff1b\u82e5\u4e00\u5b9a\u8981\u4f7f\u7528\u91cd\u5b9a\u5411\u529f\u80fd\uff0c<code>\u53ef\u4ee5<\/code>&nbsp;\u8fd4\u56de\u4e00\u4e2a\u54cd\u5e94\u5b9e\u4f53\u4e3a\u7a7a\u7684&nbsp;<code>3xx<\/code>&nbsp;\u54cd\u5e94\uff0c\u5e76\u5728\u54cd\u5e94\u5934\u4e2d\u52a0\u4e0a&nbsp;<code>Location<\/code>&nbsp;\u5b57\u6bb5:Http<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>HTTP\/1.1 302 Found\nServer: nginx\/1.11.9\nContent-Type: text\/html; charset=UTF-8\nTransfer-Encoding: chunked\nDate: Sun, 24 Jun 2018 09:52:50 GMT\nLocation: https:\/\/sitoi.cn\nConnection: keep-alive<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"toc-heading-17\">400 Bad Request<\/h3>\n\n\n\n<p>\u7531\u4e8e\u660e\u663e\u7684\u5ba2\u6237\u7aef\u9519\u8bef\uff08\u4f8b\u5982\uff0c\u8bf7\u6c42\u8bed\u6cd5\u683c\u5f0f\u9519\u8bef\u3001\u65e0\u6548\u7684\u8bf7\u6c42\u3001\u65e0\u6548\u7684\u7b7e\u540d\u7b49\uff09\uff0c\u670d\u52a1\u5668&nbsp;<code>\u5e94\u8be5<\/code>&nbsp;\u653e\u5f03\u8be5\u8bf7\u6c42\u3002<\/p>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\"><p>\u5f53\u670d\u52a1\u5668\u65e0\u6cd5\u4ece\u5176\u4ed6 4xx \u7c7b\u578b\u7684\u72b6\u6001\u7801\u4e2d\u627e\u51fa\u5408\u9002\u7684\u6765\u8868\u793a\u9519\u8bef\u7c7b\u578b\u65f6\uff0c\u90fd&nbsp;<code>\u5fc5\u987b<\/code>&nbsp;\u8fd4\u56de\u8be5\u72b6\u6001\u7801\u3002<\/p><\/blockquote>\n\n\n\n<p>Http<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>HTTP\/1.1 400 Bad Request\nServer: nginx\/1.11.9\nContent-Type: application\/json\nTransfer-Encoding: chunked\nCache-Control: no-cache, private\nDate: Sun, 24 Jun 2018 13:22:36 GMT\nConnection: keep-alive<\/code><\/pre>\n\n\n\n<p>Json<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n    \"error_code\":40000,\n    \"message\":\"\u65e0\u6548\u7684\u7b7e\u540d\"\n}<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"toc-heading-18\">401 Unauthorized<\/h3>\n\n\n\n<p>\u8be5\u72b6\u6001\u7801\u8868\u793a\u5f53\u524d\u8bf7\u6c42\u9700\u8981\u8eab\u4efd\u8ba4\u8bc1\uff0c\u4ee5\u4e0b\u60c5\u51b5\u90fd&nbsp;<code>\u5fc5\u987b<\/code>&nbsp;\u8fd4\u56de\u8be5\u72b6\u6001\u7801\u3002<\/p>\n\n\n\n<ul class=\"wp-block-list\"><li>\u672a\u8ba4\u8bc1\u7528\u6237\u8bbf\u95ee\u9700\u8981\u8ba4\u8bc1\u7684 API<\/li><li>access_token \u65e0\u6548\/\u8fc7\u671f<\/li><\/ul>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\"><p>\u5ba2\u6237\u7aef\u5728\u6536\u5230&nbsp;<code>401<\/code>&nbsp;\u54cd\u5e94\u540e\uff0c\u90fd&nbsp;<code>\u5e94\u8be5<\/code>&nbsp;\u63d0\u793a\u7528\u6237\u8fdb\u884c\u4e0b\u4e00\u6b65\u7684\u767b\u5f55\u64cd\u4f5c\u3002<\/p><\/blockquote>\n\n\n\n<p>Http<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>HTTP\/1.1 401 Unauthorized\nServer: nginx\/1.11.9\nContent-Type: application\/json\nTransfer-Encoding: chunked\nWWW-Authenticate: JWTAuth\nCache-Control: no-cache, private\nDate: Sun, 24 Jun 2018 13:17:02 GMT\nConnection: keep-alive<\/code><\/pre>\n\n\n\n<p>Json<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n    \"message\":\"Token Signature could not be verified.\",\n    \"error_code\":\"40100\"\n}<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"toc-heading-19\">403 Forbidden<\/h3>\n\n\n\n<p>\u8be5\u72b6\u6001\u7801\u53ef\u4ee5\u7b80\u5355\u7684\u7406\u89e3\u4e3a\u6ca1\u6709\u6743\u9650\u8bbf\u95ee\u8be5\u8bf7\u6c42\uff0c\u670d\u52a1\u5668\u6536\u5230\u8bf7\u6c42\u4f46\u62d2\u7edd\u63d0\u4f9b\u670d\u52a1\u3002<\/p>\n\n\n\n<p>\u5982\u5f53\u666e\u901a\u7528\u6237\u8bf7\u6c42\u64cd\u4f5c\u7ba1\u7406\u5458\u7528\u6237\u65f6\uff0c<code>\u5fc5\u987b<\/code>&nbsp;\u8fd4\u56de\u8be5\u72b6\u6001\u7801\u3002Http<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>HTTP\/1.1 403 Forbidden\nServer: nginx\/1.11.9\nContent-Type: application\/json\nTransfer-Encoding: chunked\nCache-Control: no-cache, private\nDate: Sun, 24 Jun 2018 13:05:34 GMT\nConnection: keep-alive<\/code><\/pre>\n\n\n\n<p>Json<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n    \"error_code\":40301,\n    \"message\":\"\u6743\u9650\u4e0d\u8db3\"\n}<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"toc-heading-20\">404 Not Found<\/h3>\n\n\n\n<p>\u8be5\u72b6\u6001\u7801\u8868\u793a\u7528\u6237\u8bf7\u6c42\u7684\u8d44\u6e90\u4e0d\u5b58\u5728\uff0c\u5982<\/p>\n\n\n\n<ul class=\"wp-block-list\"><li>\u83b7\u53d6\u4e0d\u5b58\u5728\u7684\u7528\u6237\u4fe1\u606f \uff08get \/users\/9999999\uff09<\/li><li>\u8bbf\u95ee\u4e0d\u5b58\u5728\u7684\u7aef\u70b9<\/li><\/ul>\n\n\n\n<p>\u90fd&nbsp;<code>\u5fc5\u987b<\/code>&nbsp;\u8fd4\u56de\u8be5\u72b6\u6001\u7801\uff0c\u82e5\u8be5\u8d44\u6e90\u5df2\u6c38\u4e45\u4e0d\u5b58\u5728\uff0c\u5219&nbsp;<code>\u5e94\u8be5<\/code>&nbsp;\u8fd4\u56de&nbsp;<code>410<\/code>&nbsp;\u54cd\u5e94\u3002<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"toc-heading-21\">405 Method Not Allowed<\/h3>\n\n\n\n<p>\u5f53\u5ba2\u6237\u7aef\u4f7f\u7528\u7684&nbsp;<code>HTTP<\/code>&nbsp;\u8bf7\u6c42\u65b9\u6cd5\u4e0d\u88ab\u670d\u52a1\u5668\u5141\u8bb8\u65f6\uff0c<code>\u5fc5\u987b<\/code>&nbsp;\u8fd4\u56de\u8be5\u72b6\u6001\u7801\u3002<\/p>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\"><p>\u5982\u5ba2\u6237\u7aef\u8c03\u7528\u4e86&nbsp;<code>POST<\/code>&nbsp;\u65b9\u6cd5\u6765\u8bbf\u95ee\u53ea\u652f\u6301 GET \u65b9\u6cd5\u7684 API<\/p><\/blockquote>\n\n\n\n<p>\u8be5\u54cd\u5e94&nbsp;<code>\u5fc5\u987b<\/code>&nbsp;\u8fd4\u56de\u4e00\u4e2a&nbsp;<code>Allow<\/code>&nbsp;\u5934\u4fe1\u606f\u7528\u4ee5\u8868\u793a\u51fa\u5f53\u524d\u8d44\u6e90\u80fd\u591f\u63a5\u53d7\u7684\u8bf7\u6c42\u65b9\u6cd5\u7684\u5217\u8868\u3002Http<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>HTTP\/1.1 405 Method Not Allowed\nServer: nginx\/1.11.9\nContent-Type: application\/json\nTransfer-Encoding: chunked\nAllow: GET, HEAD\nCache-Control: no-cache, private\nDate: Sun, 24 Jun 2018 12:30:57 GMT\nConnection: keep-alive<\/code><\/pre>\n\n\n\n<p>Json<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n    \"message\":\"405 Method Not Allowed\",\n    \"error_code\":40500\n}<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"toc-heading-22\">406 Not Acceptable<\/h3>\n\n\n\n<p><code>API<\/code>&nbsp;\u5728\u4e0d\u652f\u6301\u5ba2\u6237\u7aef\u6307\u5b9a\u7684\u6570\u636e\u683c\u5f0f\u65f6\uff0c\u5e94\u8be5\u8fd4\u56de\u6b64\u72b6\u6001\u7801\u3002\u5982\u652f\u6301&nbsp;<code>JSON<\/code>&nbsp;\u548c&nbsp;<code>XML<\/code>&nbsp;\u8f93\u51fa\u7684&nbsp;<code>API<\/code>&nbsp;\u88ab\u6307\u5b9a\u8fd4\u56de&nbsp;<code>YAML<\/code>&nbsp;\u683c\u5f0f\u7684\u6570\u636e\u65f6\u3002<\/p>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\"><p>Http \u534f\u8bae\u4e00\u822c\u901a\u8fc7\u8bf7\u6c42\u9996\u90e8\u7684 Accept \u6765\u6307\u5b9a\u6570\u636e\u683c\u5f0f<\/p><\/blockquote>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"toc-heading-23\">408 Request Timeout<\/h3>\n\n\n\n<p>\u5ba2\u6237\u7aef\u8bf7\u6c42\u8d85\u65f6\u65f6&nbsp;<code>\u5fc5\u987b<\/code>&nbsp;\u8fd4\u56de\u8be5\u72b6\u6001\u7801\uff0c\u9700\u8981\u6ce8\u610f\u7684\u65f6\uff0c\u8be5\u72b6\u6001\u7801\u8868\u793a&nbsp;<strong>\u5ba2\u6237\u7aef\u8bf7\u6c42\u8d85\u65f6<\/strong>\uff0c\u5728\u6d89\u53ca\u7b2c\u4e09\u65b9&nbsp;<code>API<\/code>&nbsp;\u8c03\u7528\u8d85\u65f6\u65f6\uff0c<code>\u4e00\u5b9a\u4e0d\u53ef<\/code>&nbsp;\u8fd4\u56de\u8be5\u72b6\u6001\u7801\u3002<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"toc-heading-24\">409 Confilct<\/h3>\n\n\n\n<p>\u8be5\u72b6\u6001\u7801\u8868\u793a\u56e0\u4e3a\u8bf7\u6c42\u5b58\u5728\u51b2\u7a81\u65e0\u6cd5\u5904\u7406\u3002\u5982\u901a\u8fc7\u624b\u673a\u53f7\u7801\u63d0\u4f9b\u6ce8\u518c\u529f\u80fd\u7684&nbsp;<code>API<\/code>\uff0c\u5f53\u7528\u6237\u63d0\u4ea4\u7684\u624b\u673a\u53f7\u5df2\u5b58\u5728\u65f6\uff0c<code>\u5fc5\u987b<\/code>&nbsp;\u8fd4\u56de\u6b64\u72b6\u6001\u7801\u3002Http<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>HTTP\/1.1 409 Conflict\nServer: nginx\/1.11.9\nContent-Type: application\/json\nTransfer-Encoding: chunked\nCache-Control: no-cache, private\nDate: Sun, 24 Jun 2018 12:19:04 GMT\nConnection: keep-alive<\/code><\/pre>\n\n\n\n<p>Json<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n    \"error_code\":40900,\n    \"message\":\"\u624b\u673a\u53f7\u5df2\u5b58\u5728\"\n}<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"toc-heading-25\">410 Gone<\/h3>\n\n\n\n<p>\u548c&nbsp;<code>404<\/code>&nbsp;\u7c7b\u4f3c\uff0c\u8be5\u72b6\u6001\u7801\u4e5f\u8868\u793a\u8bf7\u6c42\u7684\u8d44\u6e90\u4e0d\u5b58\u5728\uff0c\u53ea\u662f&nbsp;<code>410<\/code>&nbsp;\u72b6\u6001\u7801\u8fdb\u4e00\u6b65\u8868\u793a\u6240\u8bf7\u6c42\u7684\u8d44\u6e90\u5df2\u4e0d\u5b58\u5728\uff0c\u5e76\u4e14\u672a\u6765\u4e5f\u4e0d\u4f1a\u5b58\u5728\u3002\u5728\u6536\u5230&nbsp;<code>410<\/code>&nbsp;\u72b6\u6001\u7801\u540e\uff0c\u5ba2\u6237\u7aef&nbsp;<code>\u5e94\u8be5<\/code>&nbsp;\u505c\u6b62\u518d\u6b21\u8bf7\u6c42\u8be5\u8d44\u6e90\u3002<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"toc-heading-26\">413 Request Entity Too Large<\/h3>\n\n\n\n<p>\u8be5\u72b6\u6001\u7801\u8868\u793a\u670d\u52a1\u5668\u62d2\u7edd\u5904\u7406\u5f53\u524d\u8bf7\u6c42\uff0c\u56e0\u4e3a\u8be5\u8bf7\u6c42\u63d0\u4ea4\u7684\u5b9e\u4f53\u6570\u636e\u5927\u5c0f\u8d85\u8fc7\u4e86\u670d\u52a1\u5668\u613f\u610f\u6216\u8005\u80fd\u591f\u5904\u7406\u7684\u8303\u56f4\u3002<\/p>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\"><p>\u6b64\u79cd\u60c5\u51b5\u4e0b\uff0c\u670d\u52a1\u5668\u53ef\u4ee5\u5173\u95ed\u8fde\u63a5\u4ee5\u514d\u5ba2\u6237\u7aef\u7ee7\u7eed\u53d1\u9001\u6b64\u8bf7\u6c42\u3002<\/p><\/blockquote>\n\n\n\n<p>\u5982\u679c\u8fd9\u4e2a\u72b6\u51b5\u662f\u4e34\u65f6\u7684\uff0c\u670d\u52a1\u5668&nbsp;<code>\u5e94\u8be5<\/code>&nbsp;\u8fd4\u56de\u4e00\u4e2a&nbsp;<code>Retry-After<\/code>&nbsp;\u7684\u54cd\u5e94\u5934\uff0c\u4ee5\u544a\u77e5\u5ba2\u6237\u7aef\u53ef\u4ee5\u5728\u591a\u5c11\u65f6\u95f4\u4ee5\u540e\u91cd\u65b0\u5c1d\u8bd5\u3002<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"toc-heading-27\">414 Request-URI Too Long<\/h3>\n\n\n\n<p>\u8be5\u72b6\u6001\u7801\u8868\u793a\u8bf7\u6c42\u7684&nbsp;<code>URI<\/code>&nbsp;\u957f\u5ea6\u8d85\u8fc7\u4e86\u670d\u52a1\u5668\u80fd\u591f\u89e3\u91ca\u7684\u957f\u5ea6\uff0c\u56e0\u6b64\u670d\u52a1\u5668\u62d2\u7edd\u5bf9\u8be5\u8bf7\u6c42\u63d0\u4f9b\u670d\u52a1\u3002<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"toc-heading-28\">415 Unsupported Media Type<\/h3>\n\n\n\n<p>\u901a\u5e38\u8868\u793a\u670d\u52a1\u5668\u4e0d\u652f\u6301\u5ba2\u6237\u7aef\u8bf7\u6c42\u9996\u90e8&nbsp;<code>Content-Type<\/code>&nbsp;\u6307\u5b9a\u7684\u6570\u636e\u683c\u5f0f\u3002\u5982\u5728\u53ea\u63a5\u53d7&nbsp;<code>JSON<\/code>&nbsp;\u683c\u5f0f\u7684&nbsp;<code>API<\/code>&nbsp;\u4e2d\u653e\u5165&nbsp;<code>XML<\/code>&nbsp;\u7c7b\u578b\u7684\u6570\u636e\u5e76\u5411\u670d\u52a1\u5668\u53d1\u9001\uff0c\u90fd&nbsp;<code>\u5e94\u8be5<\/code>&nbsp;\u8fd4\u56de\u8be5\u72b6\u6001\u7801\u3002<\/p>\n\n\n\n<p>\u8be5\u72b6\u6001\u7801\u4e5f\u53ef\u7528\u4e8e\u5982\uff1a\u53ea\u5141\u8bb8\u4e0a\u4f20\u56fe\u7247\u683c\u5f0f\u7684\u6587\u4ef6\uff0c\u4f46\u662f\u5ba2\u6237\u7aef\u63d0\u4ea4\u5a92\u4f53\u6587\u4ef6\u975e\u6cd5\u6216\u4e0d\u662f\u56fe\u7247\u7c7b\u578b\uff0c\u8fd9\u65f6&nbsp;<code>\u5e94\u8be5<\/code>&nbsp;\u8fd4\u56de\u8be5\u72b6\u6001\u7801\uff1aHttp<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>HTTP\/1.1 415 Unsupported Media Type\nServer: nginx\/1.11.9\nContent-Type: application\/json\nTransfer-Encoding: chunked\nCache-Control: no-cache, private\nDate: Sun, 24 Jun 2018 12:09:40 GMT\nConnection: keep-alive<\/code><\/pre>\n\n\n\n<p>Json<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n    \"error_code\":41500,\n    \"message\":\"\u4e0d\u5141\u8bb8\u4e0a\u4f20\u7684\u56fe\u7247\u683c\u5f0f\"\n}<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"toc-heading-29\">429 Too Many Requests<\/h3>\n\n\n\n<p>\u8be5\u72b6\u6001\u7801\u8868\u793a\u7528\u6237\u8bf7\u6c42\u6b21\u6570\u8d85\u8fc7\u5141\u8bb8\u8303\u56f4\u3002\u5982&nbsp;<code>API<\/code>&nbsp;\u8bbe\u5b9a\u4e3a&nbsp;<code>60\u6b21\/\u5206\u949f<\/code>\uff0c\u5f53\u7528\u6237\u5728\u4e00\u5206\u949f\u5185\u8bf7\u6c42\u6b21\u6570\u8d85\u8fc7 60 \u6b21\u540e\uff0c\u90fd&nbsp;<code>\u5e94\u8be5<\/code>&nbsp;\u8fd4\u56de\u8be5\u72b6\u6001\u7801\u3002\u5e76\u4e14\u4e5f&nbsp;<code>\u5e94\u8be5<\/code>&nbsp;\u5728\u54cd\u5e94\u9996\u90e8\u4e2d\u52a0\u4e0a\u4e0b\u5217\u5934\u90e8\uff1aBash<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>X-RateLimit-Limit: 10 \u8bf7\u6c42\u901f\u7387\uff08\u7531\u5e94\u7528\u8bbe\u5b9a\uff0c\u5176\u5355\u4f4d\u4e00\u822c\u4e3a\u5c0f\u65f6\/\u5206\u949f\u7b49\uff0c\u8fd9\u91cc\u662f 10\u6b21\/5\u5206\u949f\uff09\nX-RateLimit-Remaining: 0 \u5f53\u524d\u5269\u4f59\u7684\u8bf7\u6c42\u6570\u91cf\nX-RateLimit-Reset: 1529839462 \u91cd\u7f6e\u65f6\u95f4\nRetry-After: 120 \u4e0b\u4e00\u6b21\u8bbf\u95ee\u5e94\u8be5\u7b49\u5f85\u7684\u65f6\u95f4\uff08\u79d2\uff09<\/code><\/pre>\n\n\n\n<p>\u5217\u5b50Http<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>HTTP\/1.1 429 Too Many Requests\nServer: nginx\/1.11.9\nContent-Type: application\/json\nTransfer-Encoding: chunked\nX-RateLimit-Limit: 10\nX-RateLimit-Remaining: 0\nX-RateLimit-Reset: 1529839462\nRetry-After: 290\nCache-Control: no-cache, private\nDate: Sun, 24 Jun 2018 11:19:32 GMT\nConnection: keep-alive<\/code><\/pre>\n\n\n\n<p>Json<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n    \"message\":\"You have exceeded your rate limit.\",\n    \"error_code\":42900\n}<\/code><\/pre>\n\n\n\n<p><code>\u5fc5\u987b<\/code>&nbsp;\u4e3a\u6240\u6709\u7684 API \u8bbe\u7f6e Rate Limit \u652f\u6301\u3002<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"toc-heading-30\">500 Internal Server Error<\/h3>\n\n\n\n<p>\u8be5\u72b6\u6001\u7801&nbsp;<code>\u5fc5\u987b<\/code>&nbsp;\u5728\u670d\u52a1\u5668\u51fa\u9519\u65f6\u629b\u51fa\uff0c\u5bf9\u4e8e\u6240\u6709\u7684&nbsp;<code>500<\/code>&nbsp;\u9519\u8bef\uff0c\u90fd&nbsp;<code>\u5e94\u8be5<\/code>&nbsp;\u63d0\u4f9b\u5b8c\u6574\u7684\u9519\u8bef\u4fe1\u606f\u652f\u6301\uff0c\u4e5f\u65b9\u4fbf\u8ddf\u8e2a\u8c03\u8bd5\u3002<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"toc-heading-31\">503 Service Unavailable<\/h3>\n\n\n\n<p>\u8be5\u72b6\u6001\u7801\u8868\u793a\u670d\u52a1\u5668\u6682\u65f6\u5904\u7406\u4e0d\u53ef\u7528\u72b6\u6001\uff0c\u5f53\u670d\u52a1\u5668\u9700\u8981\u7ef4\u62a4\u6216\u7b2c\u4e09\u65b9&nbsp;<code>API<\/code>&nbsp;\u8bf7\u6c42\u8d85\u65f6\/\u4e0d\u53ef\u8fbe\u65f6\uff0c\u90fd&nbsp;<code>\u5e94\u8be5<\/code>&nbsp;\u8fd4\u56de\u8be5\u72b6\u6001\u7801\uff0c\u5176\u4e2d\u82e5\u662f\u4e3b\u52a8\u5173\u95ed API \u670d\u52a1\uff0c<code>\u5e94\u8be5<\/code>\u5728\u8fd4\u56de\u7684\u54cd\u5e94\u9996\u90e8\u52a0\u4e0a&nbsp;<code>Retry-After<\/code>&nbsp;\u5934\u90e8\uff0c\u8868\u793a\u591a\u5c11\u79d2\u540e\u53ef\u4ee5\u518d\u6b21\u8bbf\u95ee\u3002Http<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>HTTP\/1.1 503 Service Unavailable\nServer: nginx\/1.11.9\nContent-Type: application\/json\nTransfer-Encoding: chunked\nCache-Control: no-cache, private\nDate: Sun, 24 Jun 2018 10:56:20 GMT\nRetry-After: 60\nConnection: keep-alive<\/code><\/pre>\n\n\n\n<p>Json<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n    \"error_code\":50300,\n    \"message\":\"\u670d\u52a1\u7ef4\u62a4\u4e2d\"\n}<\/code><\/pre>\n\n\n\n<p>\u5176\u4ed6\u00a0<code>HTTP<\/code>\u00a0\u72b6\u6001\u7801\u8bf7\u53c2\u8003\u00a0<a rel=\"noreferrer noopener\" href=\"https:\/\/sitoi.cn\/go.html?u=aHR0cHM6Ly96aC53aWtpcGVkaWEub3JnL3poLWhhbnMvSFRUUCVFNyU4QSVCNiVFNiU4MCU4MSVFNyVBMCU4MQ==\" target=\"_blank\">HTTP \u72b6\u6001\u7801- \u7ef4\u57fa\u767e\u79d1<\/a>\u3002<\/p>\n","protected":false},"excerpt":{"rendered":"<p>RESTful API \u8bbe\u8ba1\u89c4\u8303 \u539f\u6587\u94fe\u63a5\uff1ahttps:\/\/github.com\/godruoyi\/restf\u2026 <span class=\"read-more\"><a href=\"https:\/\/www.shuran.cn\/?p=1020\">Read More &raquo;<\/a><\/span><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[9],"tags":[],"class_list":["post-1020","post","type-post","status-publish","format-standard","hentry","category-php"],"_links":{"self":[{"href":"https:\/\/www.shuran.cn\/index.php?rest_route=\/wp\/v2\/posts\/1020","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.shuran.cn\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.shuran.cn\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.shuran.cn\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.shuran.cn\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=1020"}],"version-history":[{"count":1,"href":"https:\/\/www.shuran.cn\/index.php?rest_route=\/wp\/v2\/posts\/1020\/revisions"}],"predecessor-version":[{"id":1021,"href":"https:\/\/www.shuran.cn\/index.php?rest_route=\/wp\/v2\/posts\/1020\/revisions\/1021"}],"wp:attachment":[{"href":"https:\/\/www.shuran.cn\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=1020"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.shuran.cn\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=1020"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.shuran.cn\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=1020"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}