{"id":15057,"date":"2024-11-25T05:48:53","date_gmt":"2024-11-25T05:48:53","guid":{"rendered":"https:\/\/onhee.com\/?p=15057"},"modified":"2024-12-20T11:07:01","modified_gmt":"2024-12-20T11:07:01","slug":"api%e9%9b%86%e6%88%90%e6%a8%a1%e5%bc%8f","status":"publish","type":"post","link":"https:\/\/onhee.com\/?p=15057","title":{"rendered":"API\u96c6\u6210\u6a21\u5f0f"},"content":{"rendered":"<p>Click:<a href=\"http:\/\/www.sodea.com.cn\/\">\u5168\u56fd\u697c\u51e4\u8bba\u575b<\/a><br \/><span><\/p>\n<h2>\u4ecb\u7ecd<\/h2>\n<p>API \u53ef\u4ee5\u5728\u4efb\u4f55\u73af\u5883\u4e2d\u90e8\u7f72\uff0c\u4ece\u672c\u5730\u548c SaaS \u5e94\u7528\u7a0b\u5e8f\u5230\u7b2c\u4e09\u65b9\u3002\u9996\u5148\u9700\u8981\u6e05\u6670\u4e86\u89e3\u5c06\u4f7f\u7528\u54ea\u4e9b API\uff0c\u624d\u80fd\u6df1\u5165\u7814\u7a76\u8bbe\u8ba1\u548c\u4f7f\u7528\u6a21\u5f0f\u3002API \u7ba1\u7406\u89e3\u51b3\u65b9\u6848\u7684\u90e8\u7f72\u67b6\u6784\u4e5f\u4f9d\u8d56\u4e8e\u6b64\u3002\u5982\u679c\u5927\u591a\u6570\u4ea4\u6613\u5728\u672c\u5730\u8fdb\u884c\uff0c\u5219 API \u7ba1\u7406\u5fc5\u987b\u5728\u672c\u5730\u5b8c\u6210\uff1b\u5982\u679c\u4ea4\u6613\u53d1\u751f\u5728\u4e91\u7aef\uff0c\u540c\u6837\u9002\u7528\u3002\u5982\u679c\u4e24\u8005\u517c\u5177\uff0c\u5219\u53ef\u4ee5\u9009\u62e9\u4e91\u90e8\u7f72\u6216\u4e91\u4e0e\u672c\u5730\u7684\u6df7\u5408\u67b6\u6784\u3002<\/p>\n<h2>\u5173\u4e8e API \u96c6\u6210<\/h2>\n<p>\u5728 API \u7ba1\u7406\u9879\u76ee\u542f\u52a8\u65f6\uff0c\u7b2c\u4e09\u65b9 API \u7684\u673a\u4f1a\u5e76\u4e0d\u603b\u88ab\u5145\u5206\u8003\u8651\uff0c\u8fd9\u4f7f\u5f97\u90e8\u7f72\u91cd\u70b9\u503e\u5411\u4e8e\u4e91\u7aef\u3002\u7136\u800c\uff0c\u73b0\u6709 API \u7684\u591a\u6837\u6027\u975e\u5e38\u5e7f\u6cdb\uff0c\u80fd\u591f\u4e3a\u4e1a\u52a1\u5e26\u6765\u72ec\u7279\u7684\u529f\u80fd\u3002\u8fd9\u4e9b\u7b2c\u4e09\u65b9 API \u53ef\u4ee5\u901a\u8fc7\u6d4f\u89c8\u5668\u3001\u516c\u53f8\u7f51\u7ad9\u6216 API \u7ba1\u7406\u89e3\u51b3\u65b9\u6848\uff08\u5305\u62ec API \u7ec4\u5408\uff09\u76f4\u63a5\u8c03\u7528\u3002\u7279\u522b\u662f\u5bf9\u4e8e\u7b2c\u4e09\u65b9 API\uff0c\u5b9a\u4ef7\u6a21\u578b\u548c\u670d\u52a1\u7ea7\u522b\u534f\u8bae (SLA) \u7684\u8003\u8651\u81f3\u5173\u91cd\u8981\uff0c\u56e0\u4e3a\u5982\u679c\u671f\u671b API \u7684 SLA \u8fbe\u5230 99.9%\uff0c\u5219\u4e0d\u80fd\u4f9d\u8d56\u4e8e SLA \u4ec5\u4e3a 99.5% \u7684\u670d\u52a1\u3002<\/p>\n<p>\u4e00\u65e6\u786e\u5b9a\u4e86\u96c6\u6210\u7b56\u7565\uff0c\u4fbf\u53ef\u4ee5\u8bbe\u8ba1 API \u96c6\u6210\uff0c\u540c\u65f6\u9075\u5faa\u5e94\u9075\u5b88\u7684\u5173\u952e\u57fa\u7840\u6a21\u5f0f\u3002<\/p>\n<h2>API \u96c6\u6210\u6a21\u5f0f<\/h2>\n<p>\u8fde\u63a5\u5230 API \u5f88\u5bb9\u6613\uff0c\u4f46\u63d0\u4f9b\u65e0\u7f1d\u3001\u8f7b\u677e\u4e14\u9ad8\u6027\u80fd\u7684\u7528\u6237\u4f53\u9a8c\u7684\u5b89\u5168\u96c6\u6210\u5374\u975e\u5e38\u56f0\u96be\u3002\u6bcf\u4e2a API \u90fd\u72ec\u4e00\u65e0\u4e8c\uff1b\u7814\u7a76\u548c\u6784\u5efa\u96c6\u6210\u9700\u8981\u5265\u79bb\u5c42\u5c42\u7ec6\u5fae\u5dee\u522b\uff0c\u5305\u62ec SOAP \u4e0e REST\u3001XML \u4e0e JSON\u3001\u4e0d\u540c\u7684\u8eab\u4efd\u9a8c\u8bc1\u673a\u5236\u3001\u8fc1\u79fb\u89e3\u51b3\u65b9\u6848\u3001Webhooks \u4e0e\u4e8b\u4ef6\u8f6e\u8be2\u3001\u72ec\u7279\u7684\u9519\u8bef\u4ee3\u7801\u53ca\u6709\u9650\u7684\u641c\u7d22\u548c\u53d1\u73b0\u7b49\u3002\u6b64\u5916\uff0c\u6bcf\u4e2a\u6570\u636e\u6a21\u578b\u540c\u6837\u72ec\u7279\uff0c\u5f00\u53d1\u4eba\u5458\u9700\u89e3\u51b3\u590d\u6742\u7684\u6570\u636e\u6620\u5c04\u548c\u8f6c\u6362\u95ee\u9898\u3002<\/p>\n<p>\u8003\u8651\u5230\u8fd9\u4e9b\u6311\u6218\uff0c\u63a5\u4e0b\u6765\u5c06\u56de\u987e\u5728\u6784\u5efa\u548c\u7ef4\u62a4 API \u96c6\u6210\u65f6\u5e94\u9075\u5faa\u7684\u5173\u952e\u6a21\u5f0f\u3002<\/p>\n<h3>\u9519\u8bef\u4ee3\u7801<\/h3>\n<p>\u5728\u521b\u5efa\u96c6\u6210\u65f6\uff0c\u4e86\u89e3\u53ef\u80fd\u4ece\u5e94\u7528\u7a0b\u5e8f\u63d0\u4f9b\u5546\u83b7\u5f97\u7684\u9519\u8bef\u4ee3\u7801\u975e\u5e38\u91cd\u8981\u3002\u5f53\u5f00\u59cb\u53d1\u9001\u8bf7\u6c42\u65f6\uff0c\u6e05\u695a\u4f55\u65f6\u64cd\u4f5c\u6709\u6548\uff0c\u4ee5\u53ca\u4e3a\u4f55\u64cd\u4f5c\u65e0\u6548\u540c\u6837\u5173\u952e\u3002\u901a\u8fc7\u96c6\u6210\uff0c\u56e0\u65e0\u6cd5\u8bbf\u95ee\u5927\u5c0f\u9650\u5236\u800c\u4ea7\u751f\u7684\u9519\u8bef\u4ee3\u7801\u53ef\u4ee5\u5e2e\u52a9\u6307\u5bfc\u5e94\u7528\u7a0b\u5e8f\u7684\u4e1a\u52a1\u903b\u8f91\u3002<\/p>\n<p><strong>\u6a21\u5f0f\uff1a\u5c0a\u91cd HTTP \u9519\u8bef\u4ee3\u7801<\/strong><\/p>\n<p>\u7531\u4e8e\u5927\u591a\u6570 HTTP \u9519\u8bef\u4ee3\u7801\u90fd\u7531 RFC \u6807\u51c6\u5316\uff0c\u56e0\u6b64\u5c0a\u91cd\u8fd9\u4e9b\u4ee3\u7801\u5e76\u62e5\u6709\u4e00\u4efd\u8be6\u5c3d\u3001\u51c6\u786e\u7684\u5217\u8868\u975e\u5e38\u91cd\u8981\u3002\u4e0b\u8868\u63cf\u8ff0\u4e86\u4e3b\u8981\u7684 HTTP \u9519\u8bef\u4ee3\u7801\uff0c\u5efa\u8bae\u4f9d\u8d56\u5b8c\u6574\u4e14\u6700\u65b0\u7684\u5217\u8868\uff0c\u4f8b\u5982\u6765\u81ea Mozilla \u7684\u5217\u8868\uff1aMozilla HTTP \u72b6\u6001\u5217\u8868\u3002<\/p>\n<h3>\u8868 1\uff1a\u9519\u8bef\u4ee3\u7801\u548c\u63cf\u8ff0<\/h3>\n<p>\u4ee5\u4e0a\u662f\u4e3b\u8981\u7684\u9519\u8bef\u4ee3\u7801\u53ca\u5176\u63cf\u8ff0\uff0c\u4f9b\u53c2\u8003\u548c\u4f7f\u7528\u3002<\/p>\n<p>\u638c\u63e1\u9519\u8bef\u4ee3\u7801\u56fa\u7136\u91cd\u8981\uff0c\u4f46\u4ec5\u6b64\u5e76\u4e0d\u8db3\u591f\u3002\u6d88\u8d39\u8005\u4e0d\u5e94\u731c\u6d4b\u5728 API \u4e2d\u5b9e\u73b0\u7684\u6240\u6709\u9519\u8bef\u4ee3\u7801\u3002\u5efa\u8bae\u76f4\u63a5\u5728 Swagger \u63cf\u8ff0\u6587\u4ef6\u7684\u5b9a\u4e49\u4e2d\u8bb0\u5f55\u6240\u5b9e\u73b0\u7684\u9519\u8bef\u3002\u4ee5\u4e0b\u662f\u63cf\u8ff0\u54cd\u5e94\u7684\u793a\u4f8b\uff0c\u5c55\u793a\u4e86\u5982\u4f55\u8bb0\u5f55\u9519\u8bef\u4ee3\u7801\uff1a<\/p>\n<p><code>responses:<br \/>&nbsp;&nbsp;'200':<br \/>&nbsp;&nbsp;&nbsp;&nbsp;description:&nbsp;OK.<br \/>&nbsp;&nbsp;'400':<br \/>&nbsp;&nbsp;&nbsp;&nbsp;description:&nbsp;Bad&nbsp;request.&nbsp;Parameter&nbsp;should&nbsp;be&nbsp;a&nbsp;string.<br \/>&nbsp;&nbsp;'401':<br \/>&nbsp;&nbsp;&nbsp;&nbsp;description:&nbsp;Authorization&nbsp;failed.<br \/>&nbsp;&nbsp;'404':<br \/>&nbsp;&nbsp;&nbsp;&nbsp;description:&nbsp;Not&nbsp;found.<br \/>&nbsp;&nbsp;'5XX':<br \/>&nbsp;&nbsp;&nbsp;&nbsp;description:&nbsp;Internal&nbsp;error.<\/code><\/pre>\n<p>\u6b64\u5916\uff0c\u81f3\u5c11\u51fa\u4e8e\u8c03\u8bd5\u539f\u56e0\uff0c\u5e94\u8be5\u6dfb\u52a0\u4e00\u4e2a\u9519\u8bef\u7ed3\u6784\uff0c\u5373\u52a8\u6001\u9519\u8bef\u6d88\u606f\u548c\u4ee3\u7801\u5305\u542b\u5728\u4e13\u7528\u7ed3\u6784\u4e2d\uff1a<\/p>\n<p><code>responses:<br \/>&nbsp;&nbsp;'400':<br \/>&nbsp;&nbsp;&nbsp;&nbsp;description:&nbsp;Bad&nbsp;request<br \/>&nbsp;&nbsp;&nbsp;&nbsp;content:<br \/>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;application\/json:<br \/>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;schema:<br \/>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;$ref:&nbsp;'#\/components\/schemas\/Error'<\/code><\/pre>\n<p>\u8fd9\u6837\u7684\u8bb0\u5f55\u65b9\u5f0f\u80fd\u66f4\u6e05\u6670\u5730\u5e2e\u52a9\u6d88\u8d39\u8005\u7406\u89e3\u53ef\u80fd\u51fa\u73b0\u7684\u9519\u8bef\u60c5\u51b5\u3002<\/p>\n<h3>\u7c92\u5ea6\u548c KISS \u539f\u5219<\/h3>\n<p><strong>\u6a21\u5f0f\uff1a\u4fdd\u6301 API \u7b80\u5355\u6613\u8bfb\uff1b\u4ee5\u4e2d\u7c92\u5ea6\u8d44\u6e90\u4e3a\u76ee\u6807<\/strong><\/p>\n<p>\u7c92\u5ea6\u548c KISS \u539f\u5219\u76f8\u8f85\u76f8\u6210\u3002KISS\uff0c\u4ee3\u8868\u201c\u4fdd\u6301\u7b80\u5355*\uff01\u201d\u5c06\u4fc3\u4f7f\u5b9a\u4e49\u4e00\u79cd\u7c92\u5ea6\u7b56\u7565\uff0c\u65e8\u5728\u4e3a\u6700\u7ec8\u7528\u6237\uff08\u5f00\u53d1\u4eba\u5458\uff09\u63d0\u4f9b\u6700\u7b80\u4fbf\u7684\u4f7f\u7528\u4f53\u9a8c\u3002\u4ee5\u4e0b\u662f KISS \u4e0b\u7684\u8bbe\u8ba1\u8303\u5f0f\uff1a<\/p>\n<ul>\n<li>\u8bbe\u8ba1 API \u65f6\u8981\u8003\u8651\u5ba2\u6237\u548c\u5f00\u53d1\u4eba\u5458\uff0c\u907f\u514d\u590d\u5236\/\u7c98\u8d34\u81ea\u5df1\u7684\u6570\u636e\u6a21\u578b\uff08\u81f3\u5c11\u51fa\u4e8e\u5b89\u5168\u539f\u56e0\uff09\u3002<\/li>\n<li>\u9996\u5148\u8bbe\u8ba1\u4e3b\u8981\u7528\u4f8b\uff0c\u7136\u540e\u518d\u8003\u8651\u5176\u4ed6\u7528\u4f8b\u3002<\/li>\n<li>\u4f7f\u7528\u901a\u7528\u672f\u8bed\u800c\u975e\u5546\u4e1a\u7528\u8bed\u8fdb\u884c\u8bbe\u8ba1\u3002<\/li>\n<li>\u8bbe\u8ba1\u65f6\u5e94\u786e\u4fdd\u5f00\u53d1\u4eba\u5458\u53ea\u6709\u4e00\u79cd\u5b9e\u73b0\u529f\u80fd\u7684\u65b9\u6cd5\u3002<\/li>\n<\/ul>\n<p>\u5728\u8fd9\u79cd\u601d\u7ef4\u6a21\u5f0f\u4e0b\uff0c\u7ec6\u7c92\u5ea6\u548c\u7c97\u7c92\u5ea6\u7684 API \u5e76\u4e0d\u534f\u8c03\u3002\u7ec6\u7c92\u5ea6 API \u4f1a\u589e\u52a0\u989d\u5916\u7684\u590d\u6742\u6027\uff0c\u800c\u7c97\u7c92\u5ea6 API \u5219\u53ef\u80fd\u5bfc\u81f4\u6df7\u4e71\uff0c\u56e0\u4e3a\u540c\u4e00\u7ea7\u522b\u7684\u8d44\u6e90\u53ef\u80fd\u5f7c\u6b64\u65e0\u5173\u3002\u4ee5\u4e0b\u662f\u5ba0\u7269\u5e97\u7684\u793a\u4f8b\uff1a<\/p>\n<p><strong>\u4e0d\u5efa\u8bae\uff1a<\/strong><\/p>\n<p><code>\/\/ \u7ec6\u7c92\u5ea6<br \/>GET \/animals\/mammals\/omnivores\/cats<\/p>\n<p>\/\/ \u7c97\u7c92\u5ea6<br \/>GET \/cats<br \/>GET \/payments<\/code><\/pre>\n<p>\u5e94\u7784\u51c6\u4e2d\u7b49\u7c92\u5ea6\u7684 API\uff0c\u901a\u5e38\u7ed3\u6784\u5e94\u4e0d\u8d85\u8fc7\u4e24\u4e2a\u7ea7\u522b\u7684 API \u8d44\u6e90\uff0c\u8fd9\u662f\u9002\u5408\u7684\u7c92\u5ea6\u7ea7\u522b\u3002<\/p>\n<p>\u5bf9\u4e8e\u5ba0\u7269\u5e97\uff0c\u53ef\u4ee5\u6267\u884c\u4ee5\u4e0b\u64cd\u4f5c\uff1a<\/p>\n<p><code>GET \/animals\/cats<\/code><\/pre>\n<p>\u6216\uff1a<\/p>\n<p><code>GET \/animals\/42<br \/>{<br \/>    \"id\": \"42\",<br \/>    \"animalType\": \"cat\",<br \/>    \"cat\": {<br \/>        \"mustacheSize\": \"7\",<br \/>        \"cuteness\": \"maximum\"<br \/>    }<br \/>}<\/code><\/pre>\n<p>\u6700\u7ec8\u76ee\u6807\u662f\u8ba9\u4efb\u4f55\u4eba\u90fd\u80fd\u4f7f\u7528 API\uff0c\u800c\u65e0\u9700\u53c2\u8003\u6587\u6863\u3002<\/p>\n<h3>\u7f51\u5740<\/h3>\n<p><strong>\u6a21\u5f0f\uff1a\u4f7f\u7528\u540d\u8bcd\u800c\u4e0d\u662f\u52a8\u8bcd\uff0c\u5efa\u7acb\u5c42\u6b21\u7ed3\u6784\uff0c\u7ef4\u62a4\u547d\u540d\u7ea6\u5b9a\uff0c\u5305\u542b\u7248\u672c\uff0c\u5e76\u4f7f\u7528\u6b63\u786e\u7684 HTTP \u65b9\u6cd5<\/strong><\/p>\n<h4>\u5355\u6570\u548c\u590d\u6570\u540d\u8bcd<\/h4>\n<p>\u4e0e SOAP \u7406\u5ff5\u76f8\u53cd\uff0cREST \u539f\u5219\u56f4\u7ed5\u8d44\u6e90\u8bbe\u8ba1\uff0c\u901a\u5e38\u5e94\u4f7f\u7528\u540d\u8bcd\u3002<\/p>\n<p><strong>\u793a\u4f8b\uff1a<\/strong><\/p>\n<p><code>\u505a\uff1a<br \/>GET \/orders<\/code><\/pre>\n<p><strong>\u4e0d\u5efa\u8bae\uff1a<\/strong><\/p>\n<p><code>\u4e0d\uff1a<br \/>GET \/Getorders<\/code><\/pre>\n<p>\u4f7f\u7528\u590d\u6570\u540d\u8bcd\u53ef\u540c\u65f6\u5904\u7406\u8d44\u6e90\u96c6\u5408\u548c\u5355\u4e2a\u8d44\u6e90\uff1a<\/p>\n<p><strong>\u793a\u4f8b\uff1a<\/strong><\/p>\n<p><code>\u505a\uff1a<br \/>GET \/orders<br \/>GET \/orders\/042<\/code><\/pre>\n<p><strong>\u4e0d\u5efa\u8bae\uff1a<\/strong><\/p>\n<p><code>\u4e0d\uff1a<br \/>GET \/Getorders<\/code><\/pre>\n<p>\u8fd9\u6837\u53ef\u4ee5\u4fdd\u6301\u4e00\u81f4\u4e14\u6613\u4e8e\u4f7f\u7528\u7684\u7ed3\u6784\u3002<\/p>\n<h4>\u5c42\u6b21\u7ed3\u6784<\/h4>\n<p>\u8d44\u6e90\u5e94\u6709\u7ed3\u6784\uff0c\u4f7f\u7528 URL \u8def\u5f84\u83b7\u53d6\u8be6\u7ec6\u4fe1\u606f\u3002\u4f8b\u5982\uff0c\u5ba2\u6237\u7531 ID\u3001\u59d3\u540d\u548c\u5730\u5740\u5b9a\u4e49\uff0c\u53ef\u4ee5\u5c06\u5ba2\u6237\u7f16\u53f7\u79f0\u4e3a\u201cid\u201d\uff0c\u518d\u4f7f\u7528\u201caddresses\u201d\uff1a<\/p>\n<p><code>GET \/customers\/042\/addresses<\/code><\/pre>\n<h4>\u4e00\u81f4\u6027<\/h4>\n<p>\u5fc5\u987b\u5b9a\u4e49\u547d\u540d\u7ea6\u5b9a\uff0c\u5c24\u5176\u662f\u201c\u5927\u5c0f\u5199\u7b56\u7565\u201d\uff0c\u4ee5\u786e\u4fdd\u8d44\u6e90\u4e2d\u5b57\u6bcd\u5927\u5c0f\u5199\u7684\u4e00\u81f4\u6027\u3002\u5bf9\u4e8e\u53c2\u6570\uff0c\u5e38\u7528 snake_case \u548c camelCase\u3002\u867d\u7136\u6ca1\u6709\u7edd\u5bf9\u7406\u7531\u504f\u5411\u67d0\u79cd\u65b9\u5f0f\uff0c\u4f46\u5f00\u53d1\u4eba\u5458\u901a\u5e38\u66f4\u504f\u597d\u9a7c\u5cf0\u547d\u540d\u6cd5\uff0c\u56e0\u4e3a\u5b83\u5728 Java \u4e2d\u88ab\u5e7f\u6cdb\u4f7f\u7528\uff0c\u800c\u86c7\u547d\u540d\u6cd5\u66f4\u6613\u4e8e\u975e\u6280\u672f\u4eba\u5458\u9605\u8bfb\u3002\u540c\u65f6\uff0cURL \u901a\u5e38\u4f7f\u7528\u810a\u9ad3\u5927\u5c0f\u5199\uff0c\u56e0\u4e3a\u67d0\u4e9b\u670d\u52a1\u5668\u4e0d\u533a\u5206\u5927\u5c0f\u5199\u3002<\/p>\n<p>\u4ee5\u4e0b\u662f\u6bcf\u79cd\u60c5\u51b5\u7684\u793a\u4f8b\uff1a<\/p>\n<ul>\n<li>\u9a7c\u5cf0\u547d\u540d\u6cd5\uff1a<code>GET \/customers?countryCode=US<\/code><\/li>\n<li>\u86c7\u547d\u540d\u6cd5\uff1a<code>GET \/customers?country_code=US<\/code><\/li>\n<li>\u810a\u9ad3\u5927\u5c0f\u5199\uff1a<code>GET \/vip-customers<\/code><\/li>\n<\/ul>\n<h4>\u7248\u672c\u63a7\u5236<\/h4>\n<p>\u7248\u672c\u5fc5\u987b\u5305\u542b\u5728 URL \u4e2d\uff0c\u4ee5\u5e2e\u52a9\u5f00\u53d1\u4eba\u5458\u8f7b\u677e\u4ece\u4e00\u4e2a\u7248\u672c\u8fc1\u79fb\u5230\u53e6\u4e00\u4e2a\u7248\u672c\u3002\u8fd9\u4e5f\u80fd\u907f\u514d\u7834\u574f\u5ba2\u6237\u7aef\u96c6\u6210\u3002\u7248\u672c\u63a7\u5236\u81f3\u5173\u91cd\u8981\uff0c\u6700\u7b80\u5355\u7684\u65b9\u6cd5\u662f\u5c06\u5176\u5305\u542b\u5728 URL \u4e2d\u3002\u8fd9\u6837\uff0cAPI \u8c03\u7528\u4f1a\u8bb0\u5f55\u5728\u670d\u52a1\u5668\u4e0a\uff0c\u4fbf\u4e8e\u67e5\u770b\u8c03\u7528\u4e86\u54ea\u4e2a\u7248\u672c\u7684 API\u3002<\/p>\n<p>\u5e94\u4fdd\u6301\u5411\u540e\u517c\u5bb9\u6027\uff0c\u652f\u6301\u81f3\u5c11\u4e24\u4e2a\u4ee5\u524d\u7684\u7248\u672c\uff1a<\/p>\n<p><code>GET \/v1\/customers<br \/>GET \/v2\/customers<\/code><\/pre>\n<h4>HTTP \u65b9\u6cd5<\/h4>\n<p>\u5fc5\u987b\u5c06 HTTP \u65b9\u6cd5\uff08\u52a8\u8bcd\uff09\u7528\u4e8e\u5176\u6307\u5b9a\u76ee\u7684\u3002HTTP \u8bbe\u8ba1\u521d\u8877\u662f\u56f4\u7ed5\u8d44\u6e90\uff0c\u63cf\u8ff0 HTTP \u65b9\u6cd5\u4ee5\u5bf9\u8d44\u6e90\u6267\u884c\u7279\u5b9a\u64cd\u4f5c\u3002<\/p>\n<ul>\n<li><strong>GET<\/strong> \u68c0\u7d22\u8d44\u6e90\u6570\u636e\uff1a\n<ul>\n<li>\u5bf9\u4e8e\u96c6\u5408\uff1a<code>GET \/customers<br \/>200 OK<br \/>[{\"id\":\"42\", \"name\":\"John Doe\"}, {\"id\":\"43\", \"name\":\"Elisa Re\"}]<br \/><\/code><\/li>\n<li>\u5bf9\u4e8e\u5355\u4e2a\u5b9e\u4f8b\uff1a<code>GET \/customers\/42<br \/>200 OK<br \/>{\"id\":\"42\", \"name\":\"John Doe\"}<br \/><\/code><\/li>\n<\/ul>\n<\/li>\n<li><strong>POST<\/strong> \u521b\u5efa\u65b0\u8d44\u6e90\uff1a\n<ul>\n<li>\u5bf9\u4e8e\u96c6\u5408\uff1a<code>POST \/customers {\"name\":\"John Doe\", \"countryCode\":\"US\"}<br \/>201 Created<br \/>Location: https:\/\/myapi.com\/customers\/42<br \/><\/code><\/li>\n<\/ul>\n<\/li>\n<li><strong>PUT<\/strong> \u66ff\u6362\u6216\u521b\u5efa\u8d44\u6e90\uff1a\n<ul>\n<li>\u5bf9\u4e8e\u5355\u4e2a\u5b9e\u4f8b\uff1a<code>PUT \/customers\/42 {\"name\":\"John Si\", \"countryCode\":\"US\"}<br \/>200 OK<br \/><\/code><\/li>\n<\/ul>\n<\/li>\n<li><strong>PATCH<\/strong> \u5bf9\u8d44\u6e90\u8fdb\u884c\u90e8\u5206\u66f4\u65b0\uff1a\n<ul>\n<li>\u5bf9\u4e8e\u5355\u4e2a\u5b9e\u4f8b\uff1a<code>PATCH \/customers\/42 {\"countryCode\":\"UK\"}<br \/>200 OK<br \/><\/code><\/li>\n<\/ul>\n<\/li>\n<li><strong>DELETE<\/strong> \u5220\u9664\u73b0\u6709\u8d44\u6e90\uff1a\n<ul>\n<li>\u5bf9\u4e8e\u5355\u4e2a\u5b9e\u4f8b\uff1a<code>DELETE \/customers\/42<br \/>204 OK<br \/><\/code><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<h3>\u9a8c\u8bc1<\/h3>\n<p>\u5bf9\u6b63\u786e\u6570\u636e\u7684\u6b63\u786e\u8bbf\u95ee\u662f\u4efb\u4f55\u96c6\u6210\u9879\u76ee\u7684\u57fa\u7840\uff0c\u4f46\u8eab\u4efd\u9a8c\u8bc1\u53ef\u80fd\u662f\u6700\u56f0\u96be\u7684\u90e8\u5206\u4e4b\u4e00\u3002\u8eab\u4efd\u9a8c\u8bc1\u7684\u6838\u5fc3\u5728\u4e8e\u8bc1\u660e\u5e94\u7528\u7a0b\u5e8f\u8eab\u4efd\u7684\u80fd\u529b\u3002\u5e94\u7528\u7a0b\u5e8f\u53ef\u4ee5\u901a\u8fc7\u591a\u79cd\u4e0d\u540c\u65b9\u5f0f\u5411\u5f00\u53d1\u4eba\u5458\u6388\u4e88\u8bbf\u95ee\u6743\u9650\u4ee5\u521b\u5efa\u96c6\u6210\u3002<\/p>\n<p><strong>\u6a21\u5f0f\uff1a\u6839\u636e\u4e1a\u52a1\u9700\u6c42\u9075\u5faa\u884c\u4e1a\u8ba4\u53ef\u7684\u8eab\u4efd\u9a8c\u8bc1\u548c\u8eab\u4efd\u534f\u8bae<\/strong><\/p>\n<h4>API \u5bc6\u94a5<\/h4>\n<p>API \u5bc6\u94a5\u7684\u4f7f\u7528\u4ecd\u7136\u5f88\u666e\u904d\uff0c\u5e76\u4e14\u5bf9\u4e8e API \u8bbf\u95ee\u800c\u8a00\u975e\u5e38\u5e38\u89c1\u3002\u8fd9\u662f\u4e00\u79cd\u5feb\u901f\u3001\u7b80\u5355\u7684\u5e10\u6237\u8eab\u4efd\u9a8c\u8bc1\u65b9\u6cd5\uff0c\u4e14\u5bf9\u4e8e\u63d0\u4f9b\u5546\u6765\u8bf4\u5f00\u9500\u76f8\u5bf9\u8f83\u4f4e\uff0c\u56e0\u4e3a\u4ed6\u4eec\u53ef\u4ee5\u8f7b\u677e\u521b\u5efa\u548c\u64a4\u9500 API \u5bc6\u94a5\u3002API \u5bc6\u94a5\u662f\u4e00\u7ec4\u552f\u4e00\u751f\u6210\u7684\u5b57\u7b26\uff0c\u6709\u65f6\u662f\u968f\u673a\u7684\uff0c\u901a\u5e38\u4ee5\u4e00\u5bf9\u5f62\u5f0f\u53d1\u9001\uff0c\u5373\u7528\u6237\u548c\u79d8\u5bc6\u3002\u6536\u5230 API \u5bc6\u94a5\u540e\uff0c\u5efa\u8bae\u5c06\u5176\u590d\u5236\u5e76\u5b58\u50a8\u5728\u5bc6\u7801\u7ba1\u7406\u5668\u4e2d\uff0c\u5e76\u50cf\u5bf9\u5f85\u5176\u4ed6\u5bc6\u7801\u4e00\u6837\u8c28\u614e\u5904\u7406\u3002<\/p>\n<h4>OAuth 2.0 \u548c OpenID Connect<\/h4>\n<p>OAuth \u4e0e API \u5bc6\u94a5\u6709\u6240\u4e0d\u540c\uff0c\u56e0\u4e3a\u5b83\u662f\u57fa\u4e8e\u4ee4\u724c\u7684\u3002OAuth \u5305\u542b\u4e09\u4e2a\u4e3b\u8981\u7ec4\u4ef6\uff1a\u7528\u6237\u3001\u6d88\u8d39\u8005\uff08\u96c6\u6210\u5e94\u7528\u7a0b\u5e8f\uff09\u4ee5\u53ca\u670d\u52a1\u63d0\u4f9b\u8005\u3002\u5728\u6b64\u8fc7\u7a0b\u4e2d\uff0c\u7528\u6237\u5728\u4ece API \u8bbf\u95ee\u6570\u636e\u4e4b\u524d\uff0c\u901a\u8fc7 OAuth \u7aef\u70b9\u4ea4\u6362\u4ee4\u724c\uff0c\u4ece\u800c\u6388\u4e88\u6d88\u8d39\u8005\u5bf9\u670d\u52a1\u63d0\u4f9b\u5546\u7684\u8bbf\u95ee\u6743\u9650\u3002<\/p>\n<p>OAuth \u662f\u9996\u9009\u7684\u8eab\u4efd\u9a8c\u8bc1\u65b9\u6cd5\uff0c\u56e0\u4e3a\u5b83\u5141\u8bb8\u7528\u6237\u51b3\u5b9a\u96c6\u6210\u5e94\u7528\u7a0b\u5e8f\u53ef\u4ee5\u62e5\u6709\u7684\u8bbf\u95ee\u7ea7\u522b\uff0c\u5e76\u80fd\u8bbe\u7f6e\u57fa\u4e8e\u65f6\u95f4\u7684\u9650\u5236\u3002\u4e00\u4e9b API \u7684\u65f6\u95f4\u9650\u5236\u8f83\u77ed\uff0c\u9700\u8981\u4f7f\u7528\u5237\u65b0\u4ee4\u724c\u3002OpenID Connect \u662f OAuth 2.0 \u7684\u6807\u51c6\u5316\u6269\u5c55\uff0c\u589e\u52a0\u4e86\u4e00\u5c42\u6807\u51c6\u5316\u7684\u7b2c\u4e09\u65b9\u8eab\u4efd\u548c\u7528\u6237\u8eab\u4efd\u9a8c\u8bc1\u3002\u5e76\u975e\u6240\u6709 API \u63d0\u4f9b\u5546\u90fd\u8981\u6c42\u4f7f\u7528 OpenID Connect\uff0c\u4f46\u5982\u679c\u9700\u8981\u7ec6\u7c92\u5ea6\u7684\u6388\u6743\u63a7\u5236\u5e76\u7ba1\u7406\u591a\u4e2a\u8eab\u4efd\u63d0\u4f9b\u5546\uff0c\u5219\u5efa\u8bae\u4f7f\u7528\u5b83\u3002<\/p>\n<h4>Webhook<\/h4>\n<p>Webhook \u5141\u8bb8\u5b9e\u65f6\u83b7\u53d6\u66f4\u65b0\uff0c\u56e0\u4e3a\u5b83\u4eec\u662f\u57fa\u4e8e\u63a8\u9001\u800c\u975e\u62c9\u53d6\u7684\u3002\u5728\u6b64\u65b9\u6cd5\u4e2d\uff0c\u5f53\u5e94\u7528\u7a0b\u5e8f\u53d1\u751f\u66f4\u65b0\u65f6\uff0c\u4f1a\u5c06\u6570\u636e\u53d1\u9001\u5230\u4e3a\u5e94\u7528\u7a0b\u5e8f\u6307\u5b9a\u7684 URL\u3002\u8fd9\u79cd\u57fa\u4e8e\u63a8\u9001\u7684\u4fe1\u606f\u66f4\u65b0\u4f7f\u5e94\u7528\u7a0b\u5e8f\u80fd\u591f\u5b9e\u65f6\u66f4\u65b0\uff0c\u4ece\u800c\u521b\u5efa\u52a8\u6001\u7528\u6237\u4f53\u9a8c\u3002\u6b64\u5916\uff0cWebhook \u662f\u9996\u9009\u6a21\u5f0f\uff0c\u56e0\u4e3a\u5b9e\u73b0\u53ea\u9700\u4e00\u4e2a URL\uff0c\u800c\u8f6e\u8be2\u5219\u9700\u8981\u521b\u5efa\u4e00\u4e2a\u6846\u67b6\u6765\u7ba1\u7406\u6240\u9700\u4fe1\u606f\u7684\u63a5\u6536\u9891\u7387\u548c\u8303\u56f4\u3002\u4f8b\u5982\uff0cMarketo \u7684\u8f6e\u8be2\u6846\u67b6\u9700\u8981 239 \u884c\u4ee3\u7801\uff0c\u800c\u76f8\u5e94\u7684 Webhook \u5b9e\u73b0\u4ec5\u9700 5 \u884c\u4ee3\u7801\u3002<\/p>\n<h3>\u67e5\u8be2<\/h3>\n<p><strong>\u6a21\u5f0f\uff1a\u5728\u53c2\u6570\u4e2d\u4f7f\u7528\u901a\u7528\u7684\u5173\u952e\u5b57\u548c\u5b57\u7b26\u6765\u67e5\u8be2\u3001\u641c\u7d22\u548c\u5206\u9875<\/strong><\/p>\n<p>\u867d\u7136\u6570\u636e\u79fb\u52a8\u5df2\u5b9e\u73b0\u81ea\u52a8\u5316\uff0c\u4f7f\u96c6\u6210\u5b9e\u65f6\u6d41\u7545\uff0c\u4f46\u5e38\u5e38\u53ea\u9700\u83b7\u53d6\u5bf9\u5e94\u7528\u7a0b\u5e8f\u64cd\u4f5c\u6709\u7528\u7684\u4e00\u5c0f\u90e8\u5206\u6570\u636e\u3002\u56e0\u6b64\uff0c\u9700\u8981\u8bbe\u7f6e\u67e5\u8be2\u53c2\u6570\u4ee5\u8fc7\u6ee4\u6389\u4e0d\u5fc5\u8981\u7684\u6570\u636e\u3002<\/p>\n<p>\u67e5\u8be2\u662f API \u7aef\u70b9\u6216\u8def\u5f84\u7684\u6700\u540e\u4e00\u90e8\u5206\uff0c\u7528\u4e8e\u6307\u793a\u8c03\u7528\u4ec5\u63d0\u53d6\u6240\u9700\u7684\u6570\u636e\uff1a<\/p>\n<p><code>GET&nbsp;\/widgets?query_parameter_here<\/code><\/pre>\n<p>\u641c\u7d22\u6570\u636e\u5e93\u548c\u76ee\u6807\u5e94\u7528\u7a0b\u5e8f\u7684\u80fd\u529b\u81f3\u5173\u91cd\u8981\uff0c\u8fd9\u4f7f\u5f97\u53ef\u4ee5\u6d4b\u8bd5\u548c\u786e\u8ba4\u54cd\u5e94\uff0c\u5e76\u68c0\u67e5\u8fd4\u56de\u5185\u5bb9\u4e0e\u6587\u6863\u6570\u636e\u7ed3\u6784\u4e4b\u95f4\u7684\u5dee\u5f02\u3002\u67e5\u8be2\u5141\u8bb8\u4fee\u6539\u8bf7\u6c42\u7684\u952e\u503c\u5bf9\u3002\u67e5\u8be2\u4ee5\u95ee\u53f7\uff08?\uff09\u5f00\u5934\uff0c\u5e76\u7528\u4e0e\u53f7\uff08&amp;\uff09\u5206\u9694\u3002\u4f8b\u5982\uff1a<\/p>\n<p><code>GET&nbsp;\/widgets?type=best&amp;date=yesterday<\/code><\/pre>\n<p>\u8981\u6d4b\u8bd5\u7aef\u70b9\uff0c\u5e38\u7528\u7684\u9009\u9879\u53d6\u51b3\u4e8e\u6240\u7528\u8bed\u8a00\uff0c\u5927\u591a\u6570 API \u6587\u6863\u4f1a\u5f15\u7528 curl \u547d\u4ee4\u3002\u6253\u5f00\u7ec8\u7aef\u5e76\u590d\u5236\/\u7c98\u8d34 curl \u547d\u4ee4\uff0c\u4ee5\u67e5\u770b\u8fd4\u56de\u7684\u54cd\u5e94\u3002\u8c03\u6574\u952e\u503c\u5bf9\u4ee5\u83b7\u53d6\u76ee\u6807\u7aef\u70b9\u6240\u9700\u7684\u4fe1\u606f\u65f6\uff0c\u8bb0\u5f97\u5728\u67e5\u8be2\u7684\u95ee\u53f7\u524d\u6dfb\u52a0\u53cd\u659c\u6760\uff08\/\uff09\uff0c\u56e0\u4e3a ? \u548c &amp; \u662f\u7279\u6b8a\u5b57\u7b26\u3002<\/p>\n<p>\u901a\u8fc7\u8c03\u6574\u8fd9\u4e9b\u5bf9\uff0c\u53ef\u4ee5\u51cf\u5c11\u5e94\u7528\u7a0b\u5e8f\u7684\u9884\u671f\u5927\u5c0f\u548c\u5f00\u9500\u3002\u53ef\u4ee5\u589e\u52a0\u6570\u636e\u91cf\uff08\u5c24\u5176\u662f\u5728\u6d4b\u8bd5\u4e2d\uff09\u4ee5\u67e5\u770b\u6f5c\u5728\u9519\u8bef\u3002<\/p>\n<h4>\u8fc7\u6ee4\u5668<\/h4>\n<p>\u4f7f\u7528 ? \u6765\u8fc7\u6ee4\u8d44\u6e90\uff0c&amp; \u4f5c\u4e3a\u53c2\u6570\u4e4b\u95f4\u7684\u5206\u9694\u7b26\uff1a<\/p>\n<p><code>GET&nbsp;\/widgets?type=best&amp;date=yesterday<\/code><\/pre>\n<h4>\u641c\u7d22<\/h4>\n<p>\u641c\u7d22\u8d44\u6e90\u7684\u9996\u9009\u6a21\u5f0f\u901a\u5e38\u662f\u4f7f\u7528\u5173\u952e\u5b57\uff0c\u5982\u540c Google \u641c\u7d22\u3002\u4f8b\u5982\uff0c\u641c\u7d22\u7279\u5b9a\u8d44\u6e90\u65f6\uff1a<\/p>\n<p><code>GET&nbsp;\/customers\/search?type=vip<\/code><\/pre>\n<p>\u641c\u7d22\u591a\u4e2a\u8d44\u6e90\u65f6\uff1a<\/p>\n<p><code>GET&nbsp;\/search?q=customers+vip<\/code><\/pre>\n<h4>\u7b2c\u4e00\u4e2a\u3001\u6700\u540e\u4e00\u4e2a\u548c\u8ba1\u6570\u5173\u952e\u5b57<\/h4>\n<p>\u4f7f\u7528 first\u3001last \u548c count \u83b7\u53d6\u96c6\u5408\u4e2d\u7684\u7b2c\u4e00\u4e2a\u9879\u76ee\u3001\u6700\u540e\u4e00\u4e2a\u9879\u76ee\u548c\u9879\u76ee\u6570\uff1a<\/p>\n<p><code>GET&nbsp;\/customers\/first<br \/>GET&nbsp;\/customers\/last<br \/>GET&nbsp;\/customers\/count<\/code><\/pre>\n<h4>\u6392\u5e8f\u548c\u6392\u5e8f<\/h4>\n<p>\u83b7\u53d6\u6240\u9700\u4fe1\u606f\u7684\u4e00\u90e8\u5206\u662f\u6570\u636e\u7684\u5448\u73b0\u65b9\u5f0f\uff0c\u8fd9\u5bf9\u4e8e UI \u6d4b\u8bd5\u548c\u6570\u636e\u5c55\u793a\u5c24\u5176\u91cd\u8981\u3002\u8bb8\u591a API \u652f\u6301\u5728 URL \u4e2d\u4f7f\u7528 sort\u3001sort_by \u6216 order \u53c2\u6570\uff0c\u4ee5\u66f4\u6539\u6570\u636e\u7684\u5347\u5e8f\u6216\u964d\u5e8f\u3002\u4f8b\u5982\uff1a<\/p>\n<p><code>GET&nbsp;\/widgets?sort_by=desc(created)<\/code><\/pre>\n<h3>\u5206\u9875<\/h3>\n<p><strong>\u6a21\u5f0f\uff1a\u5bf9 Web \u524d\u7aef\u548c\u79fb\u52a8\u5e94\u7528\u4f7f\u7528\u5206\u9875\u65b9\u6cd5<\/strong><\/p>\n<p>\u5206\u9875\u4f9d\u8d56\u4e8e\u4e00\u4e2a\u6216\u591a\u4e2a\u5b57\u6bb5\u7684\u9690\u542b\u987a\u5e8f\uff0c\u5982\u552f\u4e00 ID\u3001\u521b\u5efa\u65e5\u671f\u548c\u4fee\u6539\u65e5\u671f\u3002\u53ef\u4ee5\u5b9e\u65bd\u51e0\u79cd\u4e0d\u540c\u7c7b\u578b\u7684\u5206\u9875\u7b56\u7565\u3002<\/p>\n<h4>\u90e8\u5206\u54cd\u5e94<\/h4>\n<p>\u5728\u67d0\u4e9b\u60c5\u51b5\u4e0b\uff0c\u4e0d\u9700\u8981\u83b7\u53d6\u5b9a\u4e49\u5bf9\u8c61\u7684\u6240\u6709\u5b57\u6bb5\u3002\u90e8\u5206\u54cd\u5e94\u5728\u79fb\u52a8\u7528\u4f8b\u4e2d\u7279\u522b\u6709\u7528\uff0c\u80fd\u4f18\u5316\u5e26\u5bbd\u3002\u4f7f\u7528 <code>fields<\/code> \u5173\u952e\u5b57\u83b7\u53d6\u7279\u5b9a\u5b57\u6bb5\uff1a<\/p>\n<p><code>GET&nbsp;\/customers\/42?fields=name,status<\/code><\/pre>\n<h4>\u62b5\u6d88<\/h4>\n<p>\u62b5\u6d88\u5206\u9875\u662f\u6700\u5e38\u89c1\u7684\u65b9\u6cd5\uff0c\u4f7f\u7528 <code>LIMIT<\/code> \u6765\u6307\u5b9a\u8981\u8fd4\u56de\u7684\u884c\u6570\uff0c<code>OFFSET<\/code> \u6765\u6307\u5b9a\u7ed3\u679c\u7684\u8d77\u70b9\u3002\u4f8b\u5982\uff1a<\/p>\n<p><code>GET&nbsp;\/widgets?limit=10<br \/>GET&nbsp;\/widgets?limit=10&amp;offset=10<\/code><\/pre>\n<p>\u4f46\u662f\uff0c\u5bf9\u4e8e\u5927\u578b\u6570\u636e\u96c6\uff0c\u6027\u80fd\u53ef\u80fd\u4f1a\u964d\u4f4e\uff0c\u56e0\u4e3a\u5728\u8fd4\u56de\u8bf7\u6c42\u7684\u9650\u5236\u4e4b\u524d\uff0c\u7cfb\u7edf\u9700\u8981\u8df3\u8fc7\u524d\u9762\u7684\u884c\u3002<\/p>\n<h4>\u6309\u952e\u8bbe\u7f6e<\/h4>\n<p>\u952e\u96c6\u5206\u9875\u4f7f\u7528\u6700\u540e\u4e00\u9875\u7ed3\u679c\u7684\u8fc7\u6ee4\u5668\u503c\u4f5c\u4e3a\u4e0b\u4e00\u9875\u7ed3\u679c\u7684\u8d77\u70b9\uff0c\u907f\u514d\u5904\u7406\u5927\u91cf\u6570\u636e\u3002\u4f8b\u5982\uff0c\u7b2c\u4e00\u4e2a\u8c03\u7528\u53ef\u4ee5\u662f\uff1a<\/p>\n<p><code>GET&nbsp;\/widgets?limit=10<\/code><\/pre>\n<p>\u7b2c\u4e8c\u4e2a\u8c03\u7528\u53ef\u80fd\u662f\uff1a<\/p>\n<p><code>GET&nbsp;\/widgets?limit=10&amp;created:lte:2019-09<\/code><\/pre>\n<h4>\u56fa\u5b9a\u6570\u636e\u9875<\/h4>\n<p>\u8fd9\u79cd\u65b9\u6cd5\u8f83\u4e3a\u7b80\u5355\uff0c\u901a\u8fc7\u6dfb\u52a0\u67e5\u8be2\u53c2\u6570\u6307\u5b9a\u8fd4\u56de\u7684\u6570\u636e\u9875\u3002\u4f8b\u5982\uff0c\u8fd4\u56de\u7b2c\u56db\u9875\u7ed3\u679c\uff1a<\/p>\n<p><code>GET&nbsp;\/widgets?page=4<\/code><\/pre>\n<p>\u5982\u679c\u4e0d\u786e\u5b9a\u7b2c\u56db\u9875\u7684\u5185\u5bb9\uff0c\u4f7f\u7528\u6b64\u65b9\u6cd5\u53ef\u80fd\u4f1a\u5e26\u6765\u56f0\u60d1\u3002<\/p>\n<h4>\u7075\u6d3b\u7684\u6570\u636e\u9875<\/h4>\n<p>\u4e0e\u56fa\u5b9a\u6570\u636e\u9875\u7c7b\u4f3c\uff0c\u4f46\u53ef\u4ee5\u6307\u5b9a\u9875\u9762\u5927\u5c0f\uff1a<\/p>\n<p><code>GET&nbsp;\/widgets?page=4&amp;page_size=25<\/code><\/pre>\n<p>\u8fd9\u5728\u6784\u5efa UI \u65f6\u5c24\u5176\u6709\u7528\uff0c\u786e\u4fdd\u8fd4\u56de\u7684\u7ed3\u679c\u7b26\u5408\u4e00\u5b9a\u5927\u5c0f\u7684\u8981\u6c42\u3002<\/p>\n<h3>\u6279\u91cf\u64cd\u4f5c<\/h3>\n<p>\u5230\u76ee\u524d\u4e3a\u6b62\uff0cAPI \u96c6\u6210\u4e3b\u8981\u5173\u6ce8\u7279\u5b9a\u7684\u6570\u636e\u96c6\uff0c\u4f46\u662f\u5f53\u60a8\u9700\u8981\u5c06\u5927\u91cf\u6570\u636e\u4ece\u4e00\u4e2a\u7cfb\u7edf\u79fb\u52a8\u5230\u53e6\u4e00\u4e2a\u7cfb\u7edf\u65f6\u4f1a\u53d1\u751f\u4ec0\u4e48\uff1f\u4e00\u4e9b\u5e94\u7528\u7a0b\u5e8f\u901a\u8fc7\u6279\u91cf API \u516c\u5f00\u4e86\u6b64\u529f\u80fd\u3002\u6279\u91cf API \u5141\u8bb8\u60a8\u4e00\u6b21\u66f4\u65b0\u3001\u63d2\u5165\u548c\u5220\u9664\u5927\u91cf\u8bb0\u5f55\u3002\u5f53\u5c06\u5927\u578b\u8bb0\u5f55\u7cfb\u7edf\uff08\u4f8b\u5982\uff0c\u8425\u9500\u81ea\u52a8\u5316\u3001CRM\u3001ERP\uff09\u4ece\u4e00\u4e2a\u63d0\u4f9b\u5546\u8f6c\u79fb\u5230\u53e6\u4e00\u63d0\u4f9b\u5546\u65f6\uff0c\u8fd9\u4e00\u70b9\u5c24\u5176\u6709\u7528\u3002<\/p>\n<p>\u6a21\u5f0f\uff1a\u5bf9\u5927\u91cf\u6570\u636e\u4f7f\u7528\u6279\u91cf\u6570\u636e\u4f20\u8f93<\/p>\n<p>\u5f53\u6279\u91cf\u4f5c\u4e1a\u7684\u8bf7\u6c42\u53d1\u9001\u5230\u5e94\u7528\u7a0b\u5e8f\u63d0\u4f9b\u5546\u65f6\uff0c\u6279\u91cf\u64cd\u4f5c\u4f1a\u5728\u591a\u6279\u6570\u636e\u96c6\u4e2d\u8fdb\u884c\u64cd\u4f5c\u3002\u5e94\u7528\u7a0b\u5e8f\u63d0\u4f9b\u5546\u5c06\u5f02\u6b65\u53d1\u9001\u6279\u6b21\u4ee5\u5b8c\u6210\u4f5c\u4e1a\u3002\u6839\u636e\u6570\u636e\u96c6\u7684\u5927\u5c0f\uff0c\u4f5c\u4e1a\u8fd8\u5c06\u5411\u60a8\u53d1\u9001\u4e00\u4e2a\u552f\u4e00\u6807\u8bc6\u7b26\uff0c\u4ee5\u68c0\u67e5\u4f5c\u4e1a\u72b6\u6001\u5e76\u5728\u5b8c\u6210\u540e\u5173\u95ed\u4f5c\u4e1a\u3002\u8bf7\u52a1\u5fc5\u4ed4\u7ec6\u68c0\u67e5\u6279\u91cf API \u5c06\u63d0\u4f9b\u7684\u6587\u4ef6\u7c7b\u578b &#8211; CSV\u3001JSON \u6216 XML\u3002\u6b64\u5916\uff0c\u5982\u679c\u60a8\u6ca1\u6709\u83b7\u53d6\u5b8c\u6574\u7684\u6570\u636e\u96c6\uff0c\u8bf7\u52a1\u5fc5\u68c0\u67e5\u9002\u7528\u7684\u4efb\u4f55 API \u901f\u7387\u9650\u5236\uff0c\u56e0\u4e3a\u5927\u6570\u636e\u4f20\u8f93\u53ef\u80fd\u4f1a\u8d85\u51fa\u8fd9\u4e9b\u9650\u5236\u3002<\/p>\n<h3>\u8f6f\u4ef6\u5f00\u53d1\u5de5\u5177\u5305<\/h3>\n<p>\u8bb8\u591a API \u63d0\u4f9b\u5546\u63d0\u4f9b SDK \u6765\u5e2e\u52a9\u7528\u6237\u8f7b\u677e\u96c6\u6210\u5b83\u4eec\uff0c\u5176\u4e2d\u5305\u62ec\u8bbe\u7f6e API \u7684\u63a5\u53e3\u3001\u65b9\u6cd5\u3001\u9519\u8bef\u5904\u7406\u3001\u8bbf\u95ee\u5b89\u5168\u6027\u7b49\u3002\u968f\u7740 API \u7684\u4fee\u6539\uff0c\u7528\u6237\u5fc5\u987b\u7ba1\u7406\u4ee3\u7801\u7684\u66f4\u6539\uff1b\u56e0\u6b64\uff0cSDK \u7684\u66f4\u65b0\u901f\u5ea6\u5fc5\u987b\u4e0e API \u672c\u8eab\u76f8\u540c\uff0c\u66f4\u4e0d\u7528\u8bf4\u5bf9\u7248\u672c\u5347\u7ea7\u3001\u8c03\u8bd5\u548c\u5f00\u53d1\u4eba\u5458\u9519\u8bef\u7684\u652f\u6301\u3002<\/p>\n<p>\u6a21\u5f0f\uff1a\u63d0\u4f9b\u4e00\u4e2a SDK \u6765\u5e2e\u52a9\u5f00\u53d1\u4eba\u5458\u4f7f\u7528\u60a8\u7684 API<\/p>\n<p>SDK \u8fd8\u5141\u8bb8\u60a8\u52a0\u5bc6\u6570\u636e\u5e76\u52a0\u5f3a\u5b89\u5168\u8981\u6c42\uff08\u4f8b\u5982\uff0c\u5b58\u50a8\u5bc6\u7801\uff09\u3002\u7279\u522b\u662f\u5bf9\u4e8e\u533b\u7597\u548c\u91d1\u878d\u9886\u57df\uff0cSDK \u53ef\u4ee5\u5e2e\u52a9\u5f3a\u5236\u7528\u6237\u9075\u5b88\u76f8\u5173\u6cd5\u89c4\u3002\u4ee5\u4e0b\u662f\u5f00\u53d1 SDK \u7684\u51e0\u79cd\u505a\u6cd5\uff1a<\/p>\n<ol>\n<li>\u5c3d\u53ef\u80fd\u5728\u540c\u4e00\u4e2a HTTP \u8c03\u7528\u4e2d\u4ee5\u6279\u91cf\u5f62\u5f0f\u8fdb\u884c\u4e92\u64cd\u4f5c\uff0c\u56e0\u4e3a\u4f1a\u8bdd\u548c\u8fde\u63a5\u7684\u6253\u5f00\u662f\u975e\u5e38\u8017\u65f6\u7684\u3002\u5f53\u4e0d\u9700\u8981\u540c\u65f6\u63a5\u6536\u8c03\u7528\u65f6\uff0c\u53ef\u4ee5\u8bbe\u7f6e\u6392\u961f\u7cfb\u7edf\u3002<\/li>\n<li>\u538b\u7f29\u6709\u6548\u8d1f\u8f7d\uff1b\u8c03\u7528 API \u65f6\u5f88\u5bb9\u6613\u5fd8\u8bb0\u8fd9\u4e00\u70b9\uff0c\u60a8\u6700\u597d\u4e0d\u8981\u5728 SDK \u4e2d\u5ffd\u89c6\u5b83\u3002<\/li>\n<li>\u5728 User-Agent \u6807\u5934\u4e2d\u586b\u5199 SDK \u7248\u672c\u53f7\u548c SDK \u8bed\u8a00\uff0c\u8fd9\u5c06\u63d0\u4f9b\u6709\u5173\u91c7\u7528\u65b0\u7248\u672c SDK \u7684\u4fe1\u606f\u3002<\/li>\n<li>\u8bbe\u7f6e API \u5206\u6790\u6765\u8861\u91cf\u4f7f\u7528\u60c5\u51b5\u548c\u6027\u80fd\uff0c\u5e76\u67e5\u770b\u53ef\u4ee5\u5bf9 SDK \u8fdb\u884c\u54ea\u4e9b\u6539\u8fdb\u3002<\/li>\n<li>\u63d0\u4f9b\u6700\u6d41\u884c\u7684\u8bed\u8a00\uff0c\u5c24\u5176\u662f API \u7684\u76ee\u6807\u5f00\u53d1\u4eba\u5458\u6700\u5e38\u4f7f\u7528\u7684\u8bed\u8a00\u3002<\/li>\n<li>\u5168\u9762\u8bb0\u5f55 SDK\uff0c\u5305\u62ec\u5b8c\u6574\u7684\u53d8\u66f4\u65e5\u5fd7\u53ca\u5176\u53c2\u6570\u5316\u3002<\/li>\n<\/ol>\n<h2>\u7ed3\u8bba<\/h2>\n<p>\u5f53\u7ec4\u7ec7\u5b9e\u65bd\u672c\u53c2\u8003\u5361\u4e2d\u7684 API \u96c6\u6210\u6a21\u5f0f\u65f6\uff0c\u7ba1\u7406\u5065\u5168\u7684 API \u7ba1\u7406\u539f\u5219\u662f API \u65c5\u7a0b\u4e2d\u7684\u4e0b\u4e00\u4e2a\u6210\u719f\u5ea6\u7ea7\u522b\u3002API \u7ba1\u7406\u901a\u5e38\u662f\u73b0\u6709 API \u4e4b\u4e0a\u7684\u4e00\u5c42\uff0c\u5141\u8bb8\u7ec4\u7ec7\u5b9e\u65bd\u66f4\u6df1\u5165\u7684\u5b89\u5168\u6027\u548c\u6cbb\u7406\uff0c\u4ece\u800c\u66f4\u597d\u5730\u63a7\u5236 API \u7684\u4f7f\u7528\u5bf9\u8c61\u548c\u65b9\u5f0f\u3002\u8fd9\u4e9b\u505a\u6cd5\u5305\u62ec\u9650\u5236\u5ba2\u6237\u7aef\u5728\u7ed9\u5b9a\u65f6\u95f4\u6bb5\u5185\u53d1\u51fa\u7684 API \u8bf7\u6c42\u6570\u91cf\u3001\u901a\u8fc7\u4fee\u6539\u8bf7\u6c42\u6216\u54cd\u5e94\u6b63\u6587\u6765\u5141\u8bb8\u6d41\u91cf\u6574\u5f62\u3001\u6dfb\u52a0\u9ad8\u7ea7\u8eab\u4efd\u9a8c\u8bc1\u548c\u6388\u6743\u3001\u5728\u5f00\u53d1\u4eba\u5458\u95e8\u6237\u4e2d\u516c\u5f00 API\uff0c\u4ee5\u53ca\u901a\u8fc7\u53ef\u89c2\u5bdf\u6027\u548c\u5206\u6790\u63d0\u4f9b\u66f4\u9ad8\u7684\u900f\u660e\u5ea6\u3002<\/p>\n<p>\u539f\u6587\u94fe\u63a5\uff1aAPI Integration Patterns<\/p>\n<p><\/span><\/p>\n<div style=\"padding: 10px 0\">\n<p>Keyword: <a href=\"https:\/\/www.explinks.com\/api\/knowledge_google_reverse_image_search\">\u53cd\u5411\u56fe\u50cf\u641c\u7d22\u5f15\u64ce<\/a><\/p>\n<\/div>\n","protected":false},"excerpt":{"rendered":"<p>Click:\u5168\u56fd\u697c\u51e4\u8bba\u575b \u4ecb\u7ecd API \u53ef\u4ee5\u5728\u4efb\u4f55\u73af\u5883\u4e2d\u90e8\u7f72\uff0c\u4ece\u672c\u5730\u548c SaaS \u5e94\u7528\u7a0b\u5e8f\u5230\u7b2c\u4e09\u65b9\u3002\u9996\u5148\u9700\u8981\u6e05\u6670\u4e86\u89e3\u5c06\u4f7f\u7528\u54ea\u4e9b API\uff0c\u624d\u80fd\u6df1\u5165\u7814\u7a76\u8bbe\u8ba1\u548c\u4f7f\u7528\u6a21\u5f0f\u3002API \u7ba1\u7406\u89e3\u51b3\u65b9\u6848\u7684\u90e8\u7f72\u67b6\u6784\u4e5f\u4f9d\u8d56\u4e8e\u6b64\u3002\u5982\u679c\u5927\u591a\u6570\u4ea4\u6613\u5728\u672c\u5730\u8fdb\u884c\uff0c\u5219 API \u7ba1\u7406\u5fc5\u987b\u5728\u672c\u5730\u5b8c\u6210\uff1b\u5982\u679c\u4ea4\u6613\u53d1\u751f\u5728\u4e91\u7aef\uff0c\u540c\u6837\u9002\u7528\u3002\u5982\u679c\u4e24\u8005\u517c\u5177\uff0c\u5219\u53ef\u4ee5\u9009\u62e9\u4e91\u90e8\u7f72\u6216\u4e91\u4e0e\u672c\u5730\u7684\u6df7\u5408\u67b6\u6784\u3002 \u5173\u4e8e API \u96c6\u6210 \u5728 API \u7ba1\u7406\u9879\u76ee\u542f\u52a8\u65f6\uff0c\u7b2c\u4e09\u65b9 API \u7684\u673a\u4f1a\u5e76\u4e0d\u603b\u88ab\u5145\u5206\u8003\u8651\uff0c\u8fd9\u4f7f\u5f97\u90e8\u7f72\u91cd\u70b9\u503e\u5411\u4e8e\u4e91\u7aef\u3002\u7136\u800c\uff0c\u73b0\u6709 API \u7684\u591a\u6837\u6027\u975e\u5e38\u5e7f\u6cdb\uff0c\u80fd\u591f\u4e3a\u4e1a\u52a1\u5e26\u6765\u72ec\u7279\u7684\u529f\u80fd\u3002\u8fd9\u4e9b\u7b2c\u4e09\u65b9 API \u53ef\u4ee5\u901a\u8fc7\u6d4f\u89c8\u5668\u3001\u516c\u53f8\u7f51\u7ad9\u6216 API \u7ba1\u7406\u89e3\u51b3\u65b9\u6848\uff08\u5305\u62ec API \u7ec4\u5408\uff09\u76f4\u63a5\u8c03\u7528\u3002\u7279\u522b\u662f\u5bf9\u4e8e\u7b2c\u4e09\u65b9 API\uff0c\u5b9a\u4ef7\u6a21\u578b\u548c\u670d\u52a1\u7ea7\u522b\u534f\u8bae (SLA) \u7684\u8003\u8651\u81f3\u5173\u91cd\u8981\uff0c\u56e0\u4e3a\u5982\u679c\u671f\u671b API \u7684 SLA \u8fbe\u5230 99.9%\uff0c\u5219\u4e0d\u80fd\u4f9d\u8d56\u4e8e SLA \u4ec5\u4e3a 99.5% \u7684\u670d\u52a1\u3002 \u4e00\u65e6\u786e\u5b9a\u4e86\u96c6\u6210\u7b56\u7565\uff0c\u4fbf\u53ef\u4ee5\u8bbe\u8ba1 API \u96c6\u6210\uff0c\u540c\u65f6\u9075\u5faa\u5e94\u9075\u5b88\u7684\u5173\u952e\u57fa\u7840\u6a21\u5f0f\u3002 API \u96c6\u6210\u6a21\u5f0f \u8fde\u63a5\u5230 API \u5f88\u5bb9\u6613\uff0c\u4f46\u63d0\u4f9b\u65e0\u7f1d\u3001\u8f7b\u677e\u4e14\u9ad8\u6027\u80fd\u7684\u7528\u6237\u4f53\u9a8c\u7684\u5b89\u5168\u96c6\u6210\u5374\u975e\u5e38\u56f0\u96be\u3002\u6bcf\u4e2a API \u90fd\u72ec\u4e00\u65e0\u4e8c\uff1b\u7814\u7a76\u548c\u6784\u5efa\u96c6\u6210\u9700\u8981\u5265\u79bb\u5c42\u5c42\u7ec6\u5fae\u5dee\u522b\uff0c\u5305\u62ec SOAP \u4e0e REST\u3001XML \u4e0e JSON\u3001\u4e0d\u540c\u7684\u8eab\u4efd\u9a8c\u8bc1\u673a\u5236\u3001\u8fc1\u79fb\u89e3\u51b3\u65b9\u6848\u3001Webhooks \u4e0e\u4e8b\u4ef6\u8f6e\u8be2\u3001\u72ec\u7279\u7684\u9519\u8bef\u4ee3\u7801\u53ca\u6709\u9650\u7684\u641c\u7d22\u548c\u53d1\u73b0\u7b49\u3002\u6b64\u5916\uff0c\u6bcf\u4e2a\u6570\u636e\u6a21\u578b\u540c\u6837\u72ec\u7279\uff0c\u5f00\u53d1\u4eba\u5458\u9700\u89e3\u51b3\u590d\u6742\u7684\u6570\u636e\u6620\u5c04\u548c\u8f6c\u6362\u95ee\u9898\u3002 \u8003\u8651\u5230\u8fd9\u4e9b\u6311\u6218\uff0c\u63a5\u4e0b\u6765\u5c06\u56de\u987e\u5728\u6784\u5efa\u548c\u7ef4\u62a4 &hellip; <\/p>\n<p class=\"link-more\"><a href=\"https:\/\/onhee.com\/?p=15057\" class=\"more-link\">Read more<span class=\"screen-reader-text\"> &#8220;API\u96c6\u6210\u6a21\u5f0f&#8221;<\/span><\/a><\/p>\n","protected":false},"author":0,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[],"class_list":["post-15057","post","type-post","status-publish","format-standard","hentry","category-news"],"_links":{"self":[{"href":"https:\/\/onhee.com\/index.php?rest_route=\/wp\/v2\/posts\/15057","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/onhee.com\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/onhee.com\/index.php?rest_route=\/wp\/v2\/types\/post"}],"replies":[{"embeddable":true,"href":"https:\/\/onhee.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=15057"}],"version-history":[{"count":1,"href":"https:\/\/onhee.com\/index.php?rest_route=\/wp\/v2\/posts\/15057\/revisions"}],"predecessor-version":[{"id":15688,"href":"https:\/\/onhee.com\/index.php?rest_route=\/wp\/v2\/posts\/15057\/revisions\/15688"}],"wp:attachment":[{"href":"https:\/\/onhee.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=15057"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/onhee.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=15057"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/onhee.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=15057"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}