{"id":2818,"date":"2019-11-18T14:59:12","date_gmt":"2019-11-18T06:59:12","guid":{"rendered":"http:\/\/blog.eolinker.com\/?p=2818"},"modified":"2019-11-18T14:59:12","modified_gmt":"2019-11-18T06:59:12","slug":"%e6%8e%a5%e5%8f%a3%e5%ae%9e%e7%8e%b0%e7%89%88%e6%9c%ac%e7%ae%a1%e7%90%86%e7%9a%84%e6%84%8f%e4%b9%89%e5%92%8c%e6%9c%80%e4%bd%b3%e6%96%b9%e6%b3%95","status":"publish","type":"post","link":"http:\/\/blog.eolinker.com\/?p=2818","title":{"rendered":"\u63a5\u53e3\u5b9e\u73b0\u7248\u672c\u7ba1\u7406\u7684\u610f\u4e49\u548c\u6700\u4f73\u65b9\u6cd5"},"content":{"rendered":"<p><img class=\"aligncenter\" src=\"https:\/\/data.eolinker.com\/77GJWkAad9fcb6b978e3a784b9b7c25c23ea6516551e822.png\" \/><\/p>\n<p>API\u7248\u672c\u7ba1\u7406\u7684\u91cd\u8981\u6027\u4e0d\u8a00\u800c\u55bb\uff0c\u5bf9\u4e8eAPI\u7684\u8bbe\u8ba1\u8005\u548c\u4f7f\u7528\u8005\u800c\u8a00\uff0c\u7248\u672c\u7ba1\u7406\u90fd\u6709\u7740\u975e\u5e38\u91cd\u8981\u7684\u610f\u4e49\u3002\u4e0b\u9762\u4f1a\u4eceWEB API \u7248\u672c\u7ba1\u7406\u7684\u89d2\u5ea6\u63d0\u4f9b\u51e0\u79cd\u5e38\u89c1\u529e\u6cd5\uff1a<\/p>\n<p><!--more--><\/p>\n<p>\u9996\u5148\uff0c\u5bf9\u4e8eAPI\u7684\u8bbe\u8ba1\u548c\u5b9e\u73b0\u8005\u800c\u8a00\uff0c\u9700\u8981\u8003\u8651\u5411\u540e\u517c\u5bb9\u6027\uff0c\u4f46\u662f\u968f\u7740\u4e1a\u52a1\u7684\u53d1\u5c55\u6216\u9700\u6c42\u7684\u53d8\u66f4\u5f80\u5f80\u4f1a\u5bfc\u81f4\u517c\u5bb9\u6027\u5b9e\u73b0\u975e\u5e38\u590d\u6742\uff0c\u56e0\u6b64\u5f15\u5165API\u7248\u672c\u7ba1\u7406\u5c06\u80fd\u89e3\u51b3\u8fd9\u4e2a\u5c34\u5c2c\u3002\u4e0b\u9762\u63d0\u4f9b\u591a\u4e2a\u7248\u672c\u7ba1\u7406\u7684API\u5b9e\u73b0\uff0c\u4e0d\u9700\u8981\u518d\u4e3a\u4e86\u5411\u540e\u517c\u5bb9\u6027\u800c\u7ede\u5c3d\u8111\u6c41\u3002\u5176\u6b21\uff0c\u5bf9\u4e8eAPI\u7684\u4f7f\u7528\u8005\u800c\u8a00\uff0c\u4e5f\u53ef\u4ee5\u7075\u6d3b\u9009\u62e9\u4f7f\u7528\u4e0d\u540c\u7248\u672cAPI\uff0c\u800c\u4e0d\u7528\u62c5\u5fc3API\u7684\u517c\u5bb9\u6027\u95ee\u9898\u3002<\/p>\n<h1>WEB API \u7248\u672c\u5316\u7684\u4e94\u79cd\u65b9\u5f0f:<\/h1>\n<p>\u65b9\u5f0f\u4e00\uff1a\u5229\u7528URL<\/p>\n<p>HTTP GET:<br \/>\nhttps:\/\/banbenguanli.com\/api\/v2\/useracount\/card<\/p>\n<p>\u65b9\u5f0f\u4e8c\uff1a\u5229\u7528\u7528\u6237\u81ea\u5b9a\u4e49\u7684request header<\/p>\n<p>HTTP GET:<br \/>\nhttps:\/\/banbenguanli.com\/api\/useracount\/card<br \/>\napi-version: 2<\/p>\n<p>\u65b9\u5f0f\u4e09\uff1a\u5229\u7528content type<\/p>\n<p>HTTP GET:<br \/>\nhttps:\/\/banbenguanli.com\/api\/useracount\/card<br \/>\nAccept: application\/vnd.banbenguanli.v2+json<\/p>\n<p>\u65b9\u5f0f\u56db\uff1a\u5229\u7528content type\uff0c\u628a\u7248\u672c\u53f7\u5206\u79bb\u51fa\u6765\u4e86<\/p>\n<p>HTTP GET:<br \/>\nhttps:\/\/banbenguanli.com\/api\/useracount\/card<br \/>\nAccept: application\/vnd.banbenguanli+json; version=2.0<\/p>\n<p>\u65b9\u5f0f\u4e94\uff1a\u5229\u7528URL\u91cc\u7684parameter<\/p>\n<p>HTTP GET:<br \/>\nhttps:\/\/banbenguanli.com\/api\/useracount\/card?v=2<\/p>\n<h1>API\u7248\u672c\u63a7\u5236\u7b56\u7565<\/h1>\n<p>\u4efb\u4f55\u4e0d\u65ad\u53d1\u5c55\u53d8\u5316\u7684API\u90fd\u9700\u8981API\u7248\u672c\u63a7\u5236\u7b56\u7565\u3002API\u7248\u672c\u53ef\u4ee5\u9002\u5e94\u6839\u636eAPI\u4f7f\u7528\u8005\u7684\u671f\u671b\u800c\u5207\u6362\u4e0d\u540c\u7248\u672c\u53d8\u5f97\u6709\u6240\u4e0d\u540c\u3002\u5efa\u8bae\u5c06\u4ee5\u4e0bAPI\u7248\u672c\u63a7\u5236\u7b56\u7565\u4f5c\u4e3a\u6574\u4f53API\u7ba1\u7406\u7cfb\u7edf\u7684\u4e00\u90e8\u5206\u3002<\/p>\n<p>1.\u5982\u679cAPI\u5904\u4e8e\u65e9\u671f\u6d4b\u8bd5\u7248\u672c\uff0c\u4e3a\u4e86\u83b7\u5f97\u6d88\u8d39\u8005\u7684\u53cd\u9988\uff0c\u8bf7\u5efa\u7acbAPI\u5404\u79cd\u53ef\u80fd\u53d1\u751f\u7684\u671f\u671b\u3002\u5728\u6b64\u9636\u6bb5\u5185\uff0c\u4f60\u4f1a\u4fdd\u7559\u8fd9\u4e2a\u7248\u672c\u4e00\u6bb5\u65f6\u95f4\uff0c\u56e0\u4e3a\u4f60\u7684API\u8bbe\u8ba1\u53ef\u80fd\u8fd8\u4f1a\u66f4\u6539\u3002\u4f5c\u4e3a\u6d88\u8d39\u8005\uff0cAPI\u662f\u4e0d\u7a33\u5b9a\u7684\uff0c\u56e0\u6b64\u4ed6\u4eec\u5e94\u8be5\u9884\u671f\u5230\u53ef\u80fd\u4f1a\u53d1\u751f\u7684\u53d8\u5316\u3002<\/p>\n<p>2.\u4e00\u65e6\u53d1\u5e03\uff0cAPI\u5e94\u88ab\u89c6\u4e3a\u5951\u7ea6\uff0c\u5982\u679c\u6ca1\u6709\u65b0\u7248\u672c\uff0c\u5219\u4e0d\u80fd\u88ab\u66ff\u6362\u3002<\/p>\n<p>3.\u7a81\u7834\u6027\u7684\u53d8\u5316\u610f\u5473\u7740\u5ba2\u6237\u5fc5\u987b\u8fc1\u79fb\u5230\u65b0\u7248\u672c\uff0c\u8bf7\u4e0eAPI\u4f7f\u7528\u8005\u6c9f\u901a\u66f4\u65b0\u65e5\u671f\uff0c\u4ee5\u786e\u4fdd\u4ed6\u4eec\u80fd\u65b9\u4fbf\u5730\u8fc1\u79fb\u5230\u65b0\u7248\u672c\u3002\u4f46\u5728\u67d0\u4e9b\u60c5\u51b5\u4e0b\uff0c\u65b0\u7248\u672c\u7684\u8fc1\u79fb\u4e0d\u4f1a\u9a6c\u4e0a\u5b9e\u73b0\uff0c\u56e0\u6b64\u4ee5\u524d\u7684API\u7248\u672c\u4f1a\u88ab\u7ee7\u7eed\u4f7f\u7528\u4e00\u6bb5\u65f6\u95f4\u3002<\/p>\n<h1>\u5b9e\u73b0\u7248\u672c\u63a7\u5236\u7684\u5de5\u5177<\/h1>\n<p>\u4f7f\u7528\u5de5\u5177\u548c\u6280\u672f\u53ef\u4ee5\u4ece\u6839\u672c\u4e0a\u5b9e\u73b0API\u7248\u672c\u63a7\u5236\u8fc7\u7a0b\u3002\u7528\u5e02\u573a\u4e0a\u4f18\u79c0\u7684API\u7f16\u8f91\u5668\u5c06\u4f7f\u6280\u672f\u5f00\u53d1\u56e2\u961f\u80fd\u591f\u5728\u66f4\u77ed\u7684\u65f6\u95f4\u5185\u751f\u6210\u5e76\u5207\u6362\u66f4\u591a\u7684API\u7248\u672c\uff0c\u4ece\u800c\u4e0d\u65ad\u6539\u8fdb\u8bbe\u8ba1\u51b3\u7b56\u3002<\/p>\n<p>\u7ed3\u5408\u5de5\u5177\u8fdb\u884c\u7248\u672c\u63a7\u5236\u662f\u5927\u591a\u6570\u5f00\u53d1\u8fc7\u7a0b\u7684\u91cd\u8981\u7ec4\u6210\u90e8\u5206\u3002API\u8bbe\u8ba1\u9886\u57df\u4e2d\u4e5f\u6709\u8fd9\u79cd\u80fd\u7248\u672c\u63a7\u5236\u7684\u5de5\u5177\uff0c\u5b9e\u9645\u4e0a\uff0c\u5168\u7403\u8303\u56f4\u5185API\u670d\u52a1\u9886\u57df\u4e2d\u5df2\u7ecf\u5b58\u5728\u4e00\u4e9b\u4f18\u79c0\u7684Web API\u8bbe\u8ba1\u5de5\u5177\u3002<\/p>\n<p>\u73b0\u5728\uff0c\u5982EOLINKER\u3001RAML\u3001Swagger\uff0c\u90fd\u63d0\u4f9b\u4e86\u51fa\u8272\u7684\u7f16\u8f91\u5de5\u5177\u6765\u652f\u6301\u4ed6\u4eec\u7684\u8bed\u8a00\u3002EOLINKER\u91c7\u7528\u7684\u662f\u7248\u672c\u5bf9\u6bd4\u548c\u91cd\u70b9\u6807\u6ce8\u63d0\u793a\uff0c\u53ef\u4ee5\u6e05\u6670\u7684\u5207\u6362\u3001\u5bf9\u6bd4\u3002RAML\u3001Swagger\u91c7\u7528\u7684\u662f\u7248\u672c\u5207\u6362\uff0c\u65b9\u4fbf\u7a0b\u5ea6\u53ef\u80fd\u7565\u900a\u4e00\u70b9\u3002\u800c\u4e14\u53ea\u6709\u524d\u8005\u662f\u652f\u6301\u4e2d\u6587\u7684\uff0c\u540e\u4e24\u79cd\u53ea\u652f\u6301\u82f1\u6587\u8bed\u8a00\u3002\u8fd9\u4e9bAPI\u7f16\u8f91\u5668\u90fd\u80fd\u8f7b\u677e\u5730\u5b9e\u73b0API\u7248\u672c\u7684\u63a7\u5236\uff0c\u4f7f\u5f97\u66f4\u5bb9\u6613\u5728\u66f4\u77ed\u7684\u65f6\u95f4\u5185\u5207\u6362\u8fd0\u884c\u7248\u672c\u3002<\/p>\n<p><img loading=\"lazy\" class=\"aligncenter\" src=\"https:\/\/data.eolinker.com\/4jsGutC3b7637c7b4f2fc358af597c8a4d92adbcf84be11.png\" width=\"1001\" height=\"283\" \/><\/p>\n<p><em>\u53c2\u8003\u8d44\u6599\uff1a<\/em><\/p>\n<p><em>https:\/\/dzone.com\/articles\/when-and-how-do-you-version-your-api<\/em><\/p>\n<p><em>https:\/\/cloud.tencent.com\/developer\/article\/1476736<\/em><\/p>\n<p><em>https:\/\/blog.csdn.net\/hengyunabc\/article\/details\/20506345<\/em><\/p>\n","protected":false},"excerpt":{"rendered":"<p>API\u7248\u672c\u7ba1\u7406\u7684\u91cd\u8981\u6027\u4e0d\u8a00\u800c\u55bb\uff0c\u5bf9\u4e8eAPI\u7684\u8bbe\u8ba1\u8005\u548c\u4f7f\u7528\u8005\u800c\u8a00\uff0c\u7248\u672c\u7ba1\u7406\u90fd\u6709\u7740\u975e\u5e38\u91cd\u8981\u7684\u610f\u4e49\u3002\u4e0b\u9762\u4f1a\u4eceWEB  [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":[],"categories":[2],"tags":[],"_links":{"self":[{"href":"http:\/\/blog.eolinker.com\/index.php?rest_route=\/wp\/v2\/posts\/2818"}],"collection":[{"href":"http:\/\/blog.eolinker.com\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"http:\/\/blog.eolinker.com\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"http:\/\/blog.eolinker.com\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"http:\/\/blog.eolinker.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=2818"}],"version-history":[{"count":9,"href":"http:\/\/blog.eolinker.com\/index.php?rest_route=\/wp\/v2\/posts\/2818\/revisions"}],"predecessor-version":[{"id":2875,"href":"http:\/\/blog.eolinker.com\/index.php?rest_route=\/wp\/v2\/posts\/2818\/revisions\/2875"}],"wp:attachment":[{"href":"http:\/\/blog.eolinker.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=2818"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"http:\/\/blog.eolinker.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=2818"},{"taxonomy":"post_tag","embeddable":true,"href":"http:\/\/blog.eolinker.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=2818"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}