{"id":5830,"date":"2022-05-26T23:42:52","date_gmt":"2022-05-26T15:42:52","guid":{"rendered":"https:\/\/damogame.cn:15443\/wordpress\/?p=5830"},"modified":"2022-05-26T23:42:52","modified_gmt":"2022-05-26T15:42:52","slug":"%e5%86%99api%e6%8e%a5%e5%8f%a3%e7%a5%9e%e5%99%a8%ef%bc%8d%ef%bc%8d%e5%b8%a6%e4%bd%a05%e5%88%86%e9%92%9f%e4%ba%86%e8%a7%a3swagger","status":"publish","type":"post","link":"https:\/\/i007.cc\/wordpress\/archives\/5830","title":{"rendered":"\u5199api\u63a5\u53e3\u795e\u5668\uff0d\uff0d\u5e26\u4f605\u5206\u949f\u4e86\u89e3swagger"},"content":{"rendered":"

\u539f\u6587\u5730\u5740<\/a><\/p>\n

<\/div>\n
\n
\n
\n
\n

\u968f\u7740\u4e92\u8054\u7f51\u6280\u672f\u7684\u53d1\u5c55\uff0c\u73b0\u5728\u7684\u7f51\u7ad9\u67b6\u6784\u57fa\u672c\u90fd\u7531\u539f\u6765\u7684\u540e\u7aef\u6e32\u67d3\uff0c\u53d8\u6210\u4e86\uff1a\u524d\u7aef\u6e32\u67d3\u3001\u5148\u540e\u7aef\u5206\u79bb\u7684\u5f62\u6001\uff0c\u800c\u4e14\u524d\u7aef\u6280\u672f\u548c\u540e\u7aef\u6280\u672f\u5728\u5404\u81ea\u7684\u9053\u8def\u4e0a\u8d8a\u8d70\u8d8a\u8fdc\u3002
\n\u524d\u7aef\u548c\u540e\u7aef\u7684\u552f\u4e00\u8054\u7cfb\uff0c\u53d8\u6210\u4e86API\u63a5\u53e3\uff1bAPI\u6587\u6863\u53d8\u6210\u4e86\u524d\u540e\u7aef\u5f00\u53d1\u4eba\u5458\u8054\u7cfb\u7684\u7ebd\u5e26\uff0c\u53d8\u5f97\u8d8a\u6765\u8d8a\u91cd\u8981\uff0cswagger<\/code>\u5c31\u662f\u4e00\u6b3e\u8ba9\u4f60\u66f4\u597d\u7684\u4e66\u5199API\u6587\u6863\u7684\u6846\u67b6\u3002<\/p>\n

<\/a>\u5176\u4ed6API\u6587\u6863\u5de5\u5177<\/h2>\n

\u6ca1\u6709API\u6587\u6863\u5de5\u5177\u4e4b\u524d\uff0c\u5927\u5bb6\u90fd\u662f\u624b\u5199API\u6587\u6863\u7684\uff0c\u5728\u4ec0\u4e48\u5730\u65b9\u4e66\u5199\u7684\u90fd\u6709\uff0c\u6709\u5728confluence<\/code>\u4e0a\u5199\u7684\uff0c\u6709\u5728\u5bf9\u5e94\u7684\u9879\u76ee\u76ee\u5f55\u4e0breadme.md<\/code>\u4e0a\u5199\u7684\uff0c\u6bcf\u4e2a\u516c\u53f8\u90fd\u6709\u6bcf\u4e2a\u516c\u53f8\u7684\u73a9\u6cd5\uff0c\u65e0\u6240\u8c13\u597d\u574f\u3002<\/p>\n

\u4e66\u5199API\u6587\u6863\u7684\u5de5\u5177\u6709\u5f88\u591a\uff0c\u4f46\u662f\u80fd\u79f0\u4e4b\u4e3a\u201c\u6846\u67b6\u201d\u7684\uff0c\u4f30\u8ba1\u4e5f\u53ea\u6709swagger<\/code>\u4e86\u3002
\n\u5728\u6b64\u5148\u4ecb\u7ecd\u4e00\u6b3e\u5176\u4ed6\u7684API\u6587\u6863\u5de5\u5177\uff0c\u53ebrap<\/a>\uff0c\u8fd9\u73a9\u610f\u513f\u7528\u4e00\u53e5\u8bdd\u5c31\u80fd\u6982\u62ec\uff1a\u89e3\u653e\u751f\u4ea7\u529b\uff0c\u4ee3\u66ff\u624b\u5199API\u7684web\u5de5\u5177\u3002
\nRAP<\/code>\u5199\u8d77\u6765\u786e\u5b9e\u6bd4\u624b\u5199\u6587\u6863\u8981\u5feb\uff0c\u770b\u770b\u56fe\u5c31\u77e5\u9053\uff1a
\n\u53ef\u4ee5\u9009\u62e9\u67d0\u4e2a\u9879\u76ee\uff0c\u5199\u9488\u5bf9\u67d0\u4e2a\u9879\u76ee\u7684API
\n\"\u8fd9\u91cc\u5199\u56fe\u7247\u63cf\u8ff0\"<\/p>\n

\u8bf7\u770b\uff0c\u53ef\u4ee5\u586b\u5199\u8bf7\u6c42\u548c\u76f8\u5e94\u7684\u5b57\u6bb5
\n\"\u8fd9\u91cc\u5199\u56fe\u7247\u63cf\u8ff0\"<\/p>\n

\u8fd8\u53ef\u4ee5\u9009\u62e9\u5b57\u6bb5\u5bf9\u5e94\u7684\u7c7b\u578b
\n\"\u8fd9\u91cc\u5199\u56fe\u7247\u63cf\u8ff0\"<\/p>\n

\u7c7b\u4f3c\u7684API\u6587\u6863\u5de5\u5177\u7f51\u4e0a\u8fd8\u6709\u5f88\u591a\uff0c\u4f46\u662f\u80fd\u62ff\u4e0a\u53f0\u9762\u7684\uff0c\u4e0d\u591a\u3002RAP<\/code>\u662f\u7531\u963f\u91cc\u5f00\u53d1\u7684\uff0c\u6574\u4e2a\u963f\u91cc\u90fd\u5728\u7528\uff0c\u8fd8\u4e0d\u9519\u3002github\u5730\u5740\u4e3a\uff1ahttps:\/\/github.com\/thx\/RAP<\/a>
\n\u5f53\u7136\u54af\uff0crap<\/code>\u4e0d\u53ef\u80fd\u53ea\u6709\u7ebf\u4e0a\u7248\u672c\uff0c\u80af\u5b9a\u53ef\u4ee5\u90e8\u7f72\u5230\u79c1\u670d\u4e0a\u3002
\nhttps:\/\/github.com\/thx\/RAP\/wiki\/deploy_manual_cn<\/a><\/p>\n

<\/a>swagger<\/h2>\n

rap<\/code>\u633a\u597d\u7684\uff0c\u4f46\u662f\u548cswagger\u6bd4\u8d77\u6765\u6709\u70b9\u8f7b\u91cf\u3002
\n\u5148\u770b\u770bswagger\u7684\u751f\u6001\u4f7f\u7528\u56fe\uff1a<\/p>\n

\"\u8fd9\u91cc\u5199\u56fe\u7247\u63cf\u8ff0\"
\n\u5176\u4e2d\uff0c\u7ea2\u989c\u8272\u7684\u662fswaggger<\/code>\u5b98\u7f51\u65b9\u63a8\u8350\u7684\u3002<\/p>\n

\u4e0b\u9762\u518d\u7ec6\u770b\u770bswagger\u7684\u751f\u6001\u7684\u5177\u4f53\u5185\u5bb9\uff1a<\/p>\n

<\/a>swagger-ui<\/h3>\n

\u8fd9\u73a9\u610f\u513f\u4ece\u540d\u5b57\u5c31\u80fd\u770b\u51fa\u6765\uff0c\u7528\u6765\u663e\u793aAPI\u6587\u6863\u7684\u3002\u548crap<\/code>\u4e0d\u540c\u7684\u662f\uff0c\u5b83\u4e0d\u53ef\u4ee5\u7f16\u8f91\u3002<\/p>\n

\"\u8fd9\u91cc\u5199\u56fe\u7247\u63cf\u8ff0\"<\/p>\n

\u70b9\u51fb\u67d0\u4e2a\u8be6\u7ec6API\u7684\u53ef\u4ee5\u8bd5\u3002<\/p>\n

\"\u8fd9\u91cc\u5199\u56fe\u7247\u63cf\u8ff0\"<\/p>\n

<\/a>swagger-editor<\/h3>\n

\u5c31\u662f\u4e00\u4e2a\u5728\u7ebf\u7f16\u8f91\u6587\u6863\u8bf4\u660e\u6587\u4ef6\uff08swagger.json\u6216swagger.yaml\u6587\u4ef6\uff09\u7684\u5de5\u5177\uff0c\u4ee5\u65b9\u4fbf\u751f\u6001\u4e2d\u7684\u5176\u4ed6\u5c0f\u5de5\u5177\uff08swagger-ui\uff09\u7b49\u4f7f\u7528\u3002
\n\u5de6\u8fb9\u7f16\u8f91\uff0c\u53f3\u8fb9\u7acb\u9a6c\u5c31\u663e\u793a\u51fa\u7f16\u8f91\u5185\u5bb9\u6765\u3002
\n\"\u8fd9\u91cc\u5199\u56fe\u7247\u63cf\u8ff0\"<\/p>\n

\u7f16\u8f91swagger\u8bf4\u660e\u6587\u4ef6\u4f7f\u7528\u7684\u662fyaml<\/code>\u8bed\u6cd5\u5177\u4f53\u7684\u5185\u5bb9\u53ef\u4ee5\u53bb\u5b98\u7f51\u67e5\u770b\u3002<\/p>\n

<\/a>\u5404\u79cd\u8bed\u8a00\u7248\u672c\u7684\u6839\u636eannotation\u6216\u8005\u6ce8\u91ca\u751f\u6210swagger\u8bf4\u660e\u6587\u6863\u7684\u5de5\u5177<\/h3>\n

\u76ee\u524d\u6700\u6d41\u884c\u7684\u505a\u6cd5\uff0c\u5c31\u662f\u5728\u4ee3\u7801\u6ce8\u91ca\u4e2d\u5199\u4e0aswagger\u76f8\u5173\u7684\u6ce8\u91ca\uff0c\u7136\u540e\uff0c\u5229\u7528\u5c0f\u5de5\u5177\u751f\u6210swagger.json\u6216\u8005swagger.yaml\u6587\u4ef6\u3002<\/p>\n

\u76ee\u524d\u5b98\u65b9\u6ca1\u6709\u63a8\u51fa\u3002github\u4e0a\u5404\u79cd\u8bed\u8a00\u5404\u79cd\u6846\u67b6\u5404\u79cd\u6709\uff0c\u53ef\u4ee5\u81ea\u5df1\u641c\u5427\u641c\u5427\uff0c\u8fd9\u91cc\u53ea\u8bf4\u4e00\u4e2aphp\u76f8\u5173\u7684\u3002
\nswagger-php<\/code>\u00a0:https:\/\/github.com\/zircote\/swagger-php<\/a><\/p>\n

<\/a>swagger-validator<\/h3>\n

\u8fd9\u4e2a\u5c0f\u5de5\u5177\u662f\u7528\u6765\u6821\u9a8c\u751f\u6210\u7684\u6587\u6863\u8bf4\u660e\u6587\u4ef6\u662f\u5426\u7b26\u5408\u8bed\u6cd5\u89c4\u5b9a\u7684\u3002\u7528\u6cd5\u975e\u5e38\u7b80\u5355\uff0c\u53ea\u9700url\u5730\u5740\u680f\uff0c\u6839\u8def\u5f84\u4e0b\u52a0\u4e0a\u4e00\u4e2a\u53c2\u6570url\uff0c\u53c2\u6570\u5185\u5bb9\u662f\u653eswagger\u8bf4\u660e\u6587\u4ef6\u7684\u5730\u5740\u3002\u5373\u53ef\u6821\u9a8c\u3002
\n\u4f8b\u5982\uff1a
\n\"\u8fd9\u91cc\u5199\u56fe\u7247\u63cf\u8ff0\"
\ndocker hub\u5730\u5740\u4e3a\uff1ahttps:\/\/hub.docker.com\/r\/swaggerapi\/swagger-validator\/<\/a>
\n\u53ef\u4ee5pull\u4e0b\u955c\u50cf\u6765\u81ea\u5df1\u73a9\u73a9\u3002<\/p>\n

<\/a>swagger-codegen<\/h3>\n

\u4ee3\u7801\u751f\u6210\u5668\uff0c\u811a\u624b\u67b6\u3002\u53ef\u4ee5\u6839\u636eswagger.json\u6216\u8005swagger.yml\u6587\u4ef6\u751f\u6210\u6307\u5b9a\u7684\u8ba1\u7b97\u673a\u8bed\u8a00\u6307\u5b9a\u6846\u67b6\u7684\u4ee3\u7801\u3002
\n\u6709\u4e00\u5b9a\u7528\u5904\uff0cJava\u7cfb\u7528\u7684\u633a\u591a\u3002\u5de5\u4e1a\u4e0a\u5e94\u8be5\u4e0d\u548b\u7528\u3002<\/p>\n

<\/a>mock server<\/h3>\n

\u8fd9\u4e2a\u76ee\u524d\u8fd8\u6ca1\u6709\u627e\u5230\u5f88\u5408\u9002\u7684mock\u5de5\u5177\uff0c\u5305\u62ecrap\u4e5f\u597d\uff0c\u5176\u4ed6API\u6587\u6863\u5de5\u5177\u4e5f\u597d\uff0c\u90fd\u505a\u7684\u4e0d\u591f\u5b8c\u5584\uff0c\u5927\u591a\u5c31\u662f\u6839\u636e\u8bf4\u660e\u6587\u4ef6\uff0c\u4f8b\u5982swagger.json\u7b49\u751f\u6210\u4e00\u4e9b\u6b7b\u7684\u9759\u6001\u7684mock\u6570\u636e\uff0c\u4e0d\u80fd\u591f\u6839\u636e\u9650\u5b9a\u6761\u4ef6\uff1a\u4f8b\u5982\u201c\u53ea\u80fd\u662f\u6570\u5b57\uff0c\u5fc5\u4f20\u201d\u7b49\u505a\u51fa\u5408\u7406\u7684\u56de\u5e94\u3002<\/p>\n<\/div>\n<\/div>\n

<\/div>\n
<\/div>\n
<\/div>\n
\n

\u4e2a\u4eba\u516c\u4f17\u53f7\u8c22\u8c22\u5404\u4f4d\u8001\u94c1\u652f\u6301<\/strong>
\n<\/a><\/p>\n

 <\/p>\n<\/div>\n<\/div>\n

QQ\uff1a1542385235 \uff08PHP\u3001Java\u3001\u5b89\u5353\u82f9\u679capp\u5236\u4f5c\u4fee\u6539\u3001\u9875\u9762\u5207\u56fe\u3001\u5404\u7c7b\u6a21\u677f\u4fee\u6539\u3001\u4eff\u7ad9\uff0c\u6570\u636e\u5e93\u4fee\u590d\u3001WAP\u5236\u4f5c\u4fee\u6539 \u3002\u6211\u4eec\u56e2\u961f\u662f\u4e13\u95e8\u505a\u7f51\u7ad9\u5f00\u53d1\u7684\uff0c\u90fd\u662f\u67093\u5e74\u4ee5\u4e0a\u5de5\u4f5c\u7ecf\u9a8c\u3002\u9700\u8981\u540e\u53f0\u7cfb\u7edf\u5f00\u53d1\uff0c\u7f51\u9875\u9875\u9762\u5236\u4f5c\uff0capp\u5236\u4f5c\uff0cui\u8bbe\u8ba1\u7684\u8bf7\u52a0\u6211qq\u8054\u7cfb\u3002\u975e\u8bda\u52ff\u6270\uff01\uff01\uff09 \u672c\u4ebaqq\u7fa4\u4e5f\u6709\u8bb8\u591a\u7684\u6280\u672f\u6587\u6863\uff0c\u5e0c\u671b\u53ef\u4ee5\u4e3a\u4f60\u63d0\u4f9b\u4e00\u4e9b\u5e2e\u52a9(\u975e\u6280\u672f\u7684\u52ff\u52a0\uff01)\u3002 QQ\u7fa4\uff1a 281442983 (\u70b9\u51fb\u94fe\u63a5\u52a0\u5165\u7fa4\uff1ahttp:\/\/jq.qq.com\/?_wv=1027&k=29LoD19)<\/div>\n<\/div>\n","protected":false},"excerpt":{"rendered":"

\u539f\u6587\u5730\u5740 \u968f\u7740\u4e92\u8054\u7f51\u6280\u672f\u7684\u53d1\u5c55\uff0c\u73b0\u5728\u7684\u7f51<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"colormag_page_container_layout":"default_layout","colormag_page_sidebar_layout":"default_layout","footnotes":""},"categories":[24],"tags":[121],"class_list":["post-5830","post","type-post","status-publish","format-standard","hentry","category-value_docs","tag-05-"],"_links":{"self":[{"href":"https:\/\/i007.cc\/wordpress\/wp-json\/wp\/v2\/posts\/5830","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/i007.cc\/wordpress\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/i007.cc\/wordpress\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/i007.cc\/wordpress\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/i007.cc\/wordpress\/wp-json\/wp\/v2\/comments?post=5830"}],"version-history":[{"count":0,"href":"https:\/\/i007.cc\/wordpress\/wp-json\/wp\/v2\/posts\/5830\/revisions"}],"wp:attachment":[{"href":"https:\/\/i007.cc\/wordpress\/wp-json\/wp\/v2\/media?parent=5830"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/i007.cc\/wordpress\/wp-json\/wp\/v2\/categories?post=5830"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/i007.cc\/wordpress\/wp-json\/wp\/v2\/tags?post=5830"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}