{"id":2485,"date":"2019-08-19T14:57:00","date_gmt":"2019-08-19T06:57:00","guid":{"rendered":"http:\/\/blog.eolinker.com\/?p=2485"},"modified":"2019-08-19T14:57:00","modified_gmt":"2019-08-19T06:57:00","slug":"%e4%bd%bf%e7%94%a8openapi%e6%9e%84%e5%bb%ba%e6%9b%b4%e6%99%ba%e8%83%bd%e7%9a%84api","status":"publish","type":"post","link":"http:\/\/blog.eolinker.com\/?p=2485","title":{"rendered":"\u4f7f\u7528OpenAPI\u6784\u5efa\u66f4\u667a\u80fd\u7684API"},"content":{"rendered":"

<\/p>\n

OpenAPI\u53ef\u4ee5\u9a71\u52a8\u5f3a\u5927\u7684\u6d4b\u8bd5\u81ea\u52a8\u5316\uff0c\u5b83\u53ef\u4ee5\u7528\u4e8e\u751f\u6210\u6a21\u62df\u6570\u636e\uff0c\u4ece\u800c\u8ba9\u5f00\u53d1\u4eba\u5458\u4e2d\u66f4\u80fd\u5206\u6790\u51fa\u5176\u590d\u6742\u6027\u3002\u4f60\u53ef\u4ee5\u5229\u7528OpenAPI\u7684\u9690\u85cf\u4f18\u52bf\uff08\u5982\u94fe\u63a5\u548c\u56de\u8c03\uff09\u6765\u4f7f\u5f00\u53d1\u4eba\u5458\u8131\u79bb\u6587\u6863\u800c\u76f4\u63a5\u901a\u8fc7\u4ee3\u7801\u4e86\u89e3\u3002\u672c\u6587\u4e3b\u8981\u4ecb\u7ecd\u5982\u4f55\u4f7f\u7528OPENAPI\u6784\u5efa\u66f4\u667a\u80fd\u7684API\u3002<\/p>\n

<\/p>\n

\u6beb\u65e0\u7591\u95ee\uff0c\u5982\u4eca\u5df2\u7ecf\u662fAPI\u4e3b\u5bb0\u7684\u65f6\u4ee3\u3002\u5373\u4f7f\u662f\u4f20\u7edf\u800c\u975e\u6280\u672f\u516c\u53f8\uff08\u8fd9\u6837\u5355\u4e00\u4ea7\u4e1a\u7684\u516c\u53f8\u8d8a\u6765\u8d8a\u5c11\uff09\u4e5f\u5c06API\u89c6\u4e3a\u5173\u952e\u4ea7\u54c1\u3002\u8d8a\u6765\u8d8a\u591a\u7684\u516c\u53f8\u4f7f\u7528API\u4f5c\u4e3a\u6c9f\u901a\u624b\u6bb5\uff0c\u8fd9\u662f\u4e0d\u540c\u56e2\u961f\u4e4b\u95f4\u5206\u4eab\u5de5\u4f5c\u548c\u6c9f\u901a\u7684\u57fa\u672c\u5355\u4f4d\u3002\u8bb8\u591a\u4eba\u8bd5\u56fe\u6548\u4eff\u4e9a\u9a6c\u900a\u7684\u6210\u529f\uff0c\u4e9a\u9a6c\u900a\u7684\u5185\u90e8\u548c\u5916\u90e8API\u6570\u91cf\u548c\u8d28\u91cf\u90fd\u5728\u4e0d\u65ad\u4e0a\u5347\u3002<\/p>\n

\u8fd9\u662f\u6bd4\u8f83\u51c6\u786e\u7684OpenAPI\u5355\u884c\u63cf\u8ff0\uff1a\u201c\u00a0\u673a\u5668\u53ef\u8bfb\u53d6\u5230\u7684\u63a5\u53e3\u6587\u4ef6\u7684\u89c4\u8303\u201d\u3002\u5728\u8fd9\u4e2a\u63cf\u8ff0\u7684\u80cc\u540e\u9690\u85cf\u7740\u4e00\u4e9b\u975e\u5e38\u5b9e\u7528\u7684\u6280\u672f\uff0c\u5b83\u5141\u8bb8\u4f60\u4ee5\u673a\u5668\u53ef\u4ee5\u4f7f\u7528\u7684\u65b9\u5f0f\u63cf\u8ff0API\uff0c\u800c\u4e14\u673a\u5668\u53ef\u4ee5\u505a\u7684\u4e8b\u60c5\u5bf9\u4e8e\u6784\u5efaAPI\u7684\u56e2\u961f\u4ee5\u53ca\u8f6f\u4ef6\u5f00\u53d1\u4eba\u5458\u6765\u8bf4\u975e\u5e38\u6709\u7528\u3002<\/p>\n

<\/p>\n

REST API<\/h1>\n

\u4e25\u683c\u6765\u8bf4\uff0c\u4e13\u4e1a\u672f\u8bed\u201cAPI\u201d\u6db5\u76d6\u4e86\u5f88\u591a\u65b9\u9762\uff0c\u672c\u6587\u4e13\u6ce8\u7684\u662f\u57fa\u4e8eHTTP\u7684API\uff0c\u7b80\u79f0\u4e3aREST\u3002Web API\u7684\u6570\u91cf\u6b63\u5728\u4ee5\u524d\u6240\u672a\u6709\u7684\u901f\u5ea6\u6fc0\u589e\uff0c\u79c1\u4eba\u670d\u52a1\u5668\u4e2d\u7684API\u8d8a\u6765\u8d8a\u50cf\u7528\u4e8e\u4e91\u670d\u52a1\u7684API\uff0c\u5f00\u653e\u5728\u4e92\u8054\u7f51\u4e0a\u3002<\/p>\n

\u8bb8\u591a\u5f00\u53d1\u4eba\u5458\u4e0d\u518d\u9700\u8981\u751f\u6210\u4ee3\u7801\u4e2d\u5b9e\u9645\u5b58\u5728\u7684API\u63a5\u53e3\uff0c\u800c\u662f\u751f\u6210\u63d0\u4f9b\u7531\u6587\u6863\u3001\u6ce8\u518c\u4fe1\u606f\u3001\u4ee3\u7801\u751f\u6210\u7b49\u7ec4\u6210\u7684\u7f16\u7a0b\u63cf\u8ff0\u3002OpenAPI\u4e0d\u662f\u63cf\u8ff0API\u7684\u552f\u4e00\u89c4\u8303\uff0c\u4f46\u7684\u786e\u662f\u4e00\u4e2a\u4f18\u52bf\u8d8a\u6765\u8d8a\u7a81\u51fa\u7684\u6807\u51c6\u3002<\/p>\n

\u5728OpenAPI\u4e2d\u63cf\u8ff0API\u662f\u6240\u6709\u8fc7\u7a0b\u7684\u7b2c\u4e00\u6b65\u3002\u4eba\u5de5\u9605\u8bfb\u7684\u6587\u6863\u662f\u4e00\u4e2a\u660e\u663e\u7684\u8f93\u51fa\uff0cOpenAPI\u8fd8\u53ef\u4ee5\u6559\u80b2\u673a\u5668\u4f7f\u7528\u5df2\u6709\u7684API\u6765\u8fdb\u4e00\u6b65\u7b80\u5316\u4eba\u5de5\u7684\u5de5\u4f5c\u5e76\u81ea\u4e3b\u8fd0\u4f5c\u3002\u968f\u7740\u5411OpenAPI\u63d0\u4f9b\u8d8a\u6765\u8d8a\u591a\u7684\u4fe1\u606f\uff0c\u53ef\u4ee5\u5f00\u59cb\u5c06\u4eba\u7684\u5de5\u4f5c\u8f6c\u79fb\u5230\u673a\u5668\u548c\u5de5\u5177\u4e0a\u3002\u67d0\u79cd\u610f\u4e49\u4e0aOpenAPI\u662f\u4e00\u79cd\u4ea7\u54c1\uff0c\u53ef\u4ee5\u51cf\u5c11\u5f00\u53d1\u4eba\u5458\u7684\u91cd\u590d\u5de5\u4f5c\u91cf\u3002<\/p>\n

<\/p>\n

OPENAPI \u793a\u4f8b<\/strong><\/h1>\n

\u53ef\u4ee5\u7528JSON\u6216YML\u6307\u5b9aOpenAPI\u6587\u4ef6\uff0c\u4e0b\u9762\u662fStrava OpenAPI\u6587\u6863\u7684\u4e00\u4e2a\u7247\u6bb5\uff1a<\/p>\n

“paths”: {<\/em><\/h5>\n
“\/athletes\/{id}\/stats”: {<\/em><\/h5>\n
“get”: {<\/em><\/h5>\n
“operationId”: “getStats”,<\/em><\/h5>\n
“summary”: “Get Athlete Stats”,<\/em><\/h5>\n
“description”: “Returns the activity stats of an athlete.”,<\/em><\/h5>\n
“parameters”: [<\/em><\/h5>\n
{<\/em><\/h5>\n
“name”: “id”,<\/em><\/h5>\n
“in”: “path”,<\/em><\/h5>\n
“description”: “The identifier of the athlete. Must match the authenticated athlete.”,<\/em><\/h5>\n
“required”: true,<\/em><\/h5>\n
“type”: “integer”<\/em><\/h5>\n
},<\/em><\/h5>\n
{<\/em><\/h5>\n
“$ref”: “#\/parameters\/page”<\/em><\/h5>\n
},<\/em><\/h5>\n
{<\/em><\/h5>\n
“$ref”: “#\/parameters\/perPage”<\/em><\/h5>\n
}<\/em><\/h5>\n
],<\/em><\/h5>\n
“tags”: [<\/em><\/h5>\n
“Athletes”<\/em><\/h5>\n
],<\/em><\/h5>\n

\u60a8\u53ef\u4ee5\u4f7f\u7528\u5de5\u5177\uff08\u6216\u624b\u52a8\uff09\u7f16\u5199\u6587\u6863\uff0c\u4e5f\u53ef\u4ee5\u4ece\u4ee3\u7801\uff08\u4f7f\u7528\u51e0\u4e4e\u4efb\u4f55\u8bed\u8a00\uff09\u4e2d\u751f\u6210\u6587\u6863\u3002\u4e0b\u9762\u662fJava\u4e2d\u7684\u4e00\u4e2a\u793a\u4f8b\uff0c\u5176\u4e2d\u5305\u62ecOpenAPI\u6ce8\u91ca\u4ee5\u53caJAX-RS\u6ce8\u91ca\u3002<\/p>\n

@GET<\/em><\/h5>\n
@Path(“\/{username}”)<\/em><\/h5>\n
@Operation(summary = “Get user by user name”,<\/em><\/h5>\n
responses = {<\/em><\/h5>\n
@ApiResponse(description = “The user”,<\/em><\/h5>\n
content = @Content(mediaType = “application\/json”,<\/em><\/h5>\n
schema = @Schema(implementation = User.class))),<\/em><\/h5>\n
@ApiResponse(responseCode = “400”, description = “User not found”)})<\/em><\/h5>\n
public Response getUserByName(<\/em><\/h5>\n
@Parameter(description = “The name that needs to be fetched. Use user1 for testing. “, required = true) @PathParam(“username”) String username)<\/em><\/h5>\n
throws ApiException {<\/em><\/h5>\n
User user = userData.findUserByName(username);<\/em><\/h5>\n
if (null != user) {<\/em><\/h5>\n
return Response.ok().entity(user).build();<\/em><\/h5>\n
} else {<\/em><\/h5>\n
throw new NotFoundException(404, “User not found”);<\/em><\/h5>\n
}<\/em><\/h5>\n
}<\/em><\/h5>\n

OpenAPI\u7684\u6700\u597d\u8f93\u51fa\u662f\u6587\u6863\u3002\u4e00\u4e2a\u597d\u5904\u662f\u8ba9\u5185\u5bb9\u4fdd\u6301\u6700\u65b0\uff0c\u8fc7\u65f6\u7684\u6587\u6863\u662f\u4ee4\u4eba\u5c34\u5c2c\u548c\u65e0\u52a9\u7684\u3002\u540c\u65f6OpenAPI\u8ba9\u6587\u6863\u53d8\u5f97\u66f4\u52a0\u7f8e\u89c2\uff0c\u53ef\u4ee5\u6dfb\u52a0\u6709\u7528\u7684\u7ec4\u4ef6\uff08\u5982\u4ea4\u4e92\u5f0f\u8d44\u6e90\u7ba1\u7406\u5668\uff09\u6216\u81ea\u52a8\u751f\u6210\u66f4\u6539\u65e5\u5fd7\uff0c\u800c\u4e0d\u4ec5\u4ec5\u662f\u63cf\u8ff0API\u7684\u8f93\u5165\u548c\u8f93\u51fa\u3002<\/p>\n

\u65e0\u9700\u4eba\u5de5\u7684\u5e72\u9884\uff0cOpenAPI\u53ef\u4ee5\u9a71\u52a8\u57fa\u4e8e\u6587\u6863\u5185\u5bb9\u53d1\u5e03API\u7684\u6a21\u62df\u670d\u52a1\u5668\u3002\u8fd9\u4e9b\u6a21\u62dfAPI\u53ef\u4ee5\u6839\u636e\u89c4\u8303\u4e2d\u7684\u6a21\u5f0f\u4ee5\u53ca\u4ee3\u7801\u7684\u7279\u5b9a\u793a\u4f8b\u8fdb\u884c\u54cd\u5e94\uff0c\u56e2\u961f\u5c31\u53ef\u4ee5\u5728API\u5b8c\u5168\u6784\u5efa\u4e4b\u524d\u5f00\u59cb\u542f\u52a8\uff0c\u5e76\u5141\u8bb8\u5916\u90e8\u5f00\u53d1\u4eba\u5458\u6d4b\u8bd5API\u7684\u4f7f\u7528\uff0c\u800c\u4e0d\u4f1a\u5411\u670d\u52a1\u5668\u53d1\u9001\u5783\u573e\u90ae\u4ef6\uff08\u6216\u8005\u5728\u83b7\u5f97\u7ecf\u8fc7\u8eab\u4efd\u9a8c\u8bc1\u7684\u8bbf\u95ee\u4e4b\u524d\uff09\u3002<\/p>\n

\u6700\u65e9\u4f7f\u7528OpenAPI\u7684\u4e00\u4e2a\u65b9\u6cd5\u662f\u751f\u6210\u672c\u5730\u4ee3\u7801\u7ed1\u5b9a\u3002\u6bd4\u5982\uff0c\u4e3a\u524d\u7aef\u751f\u6210TypeScript\u7ed1\u5b9a\uff0c\u4ee5\u4fbf\u4e0e\u540e\u7aef\u8fdb\u884c\u4ea4\u4e92\u3002\u8fd9\u5c06API\u5b66\u4e60\u8fc7\u7a0b\u4ece\u4ee3\u7801\u548c\u6587\u6863\u79fb\u5230\u4e86IDE\u4e2d\uff0c\u90a3\u5c31\u53ef\u4ee5\u4f9d\u9760\u7f16\u8f91\u5668\u5c55\u793a\u5404\u79cdAPI\u7684\u5185\u5bb9\uff0c\u5305\u62ec\u6b63\u786e\u7684\u7c7b\u578b\uff0c\u800c\u4e0d\u662f\u67e5\u770b\u670d\u52a1\u5668\u4ee3\u7801\u6765\u5f04\u6e05\u695a\u5b83\u662f\u5982\u4f55\u5de5\u4f5c\u7684\u3002\u53d1\u5e03API\u7684OpenAPI\u89c4\u8303\u5141\u8bb8\u5f00\u53d1\u4eba\u5458\u4f7f\u7528\u4ee3\u7801\u63a2\u7d22\u6280\u672f\u4e86\u89e3API\u3002<\/p>\n

<\/p>\n

OPENAPI3.0<\/strong><\/h1>\n

OpenAPI<\/span>\u5728\u4e00\u5e74\u591a\u524d\u53d1\u5e03\u4e863.0<\/span>\u7248\u672c\u3002\u5b83\u5305\u62ec\u4e00\u4e9b\u975e\u5e38\u9177\u4f46\u4ecd\u672a\u5145\u5206\u5229\u7528\u7684\u529f\u80fd\u3002\u6700\u91cd\u8981\u7684\u662f\uff0c\u5b83\u6269\u5c55\u4e86\u63cf\u8ff0API<\/span>\u7684\u80fd\u529b\u3002\u5f88\u9ad8\u5174\u770b\u5230OpenAPI<\/span>\u5728\u540e\u7eed\u7248\u672c\u4e2d\u52a0\u5f3a\u4e86\u8fd9\u4e00\u80fd\u529b\u30023.0<\/span>\u7248\u8fd8\u5f15\u5165\u4e86\u4e24\u4e2a\u5f88\u9177\u7684\u65b0\u6570\u636e\uff1aLINKS<\/span>\u548cCALLBACKS<\/span>\u3002<\/p>\n

    \n
  • LINKS<\/span>\uff08\u94fe\u63a5\uff09<\/li>\n<\/ul>\n

    \u901a\u5e38\uff0cAPI\u8c03\u7528\u7684\u7ed3\u679c\u53ef\u4ee5\u7528\u4f5c\u53e6\u4e00\u4e2aAPI\u8c03\u7528\u7684\u8f93\u5165\uff0c\u6700\u7b80\u5355\u7684\u4f8b\u5b50\u662f\u5728\u5176\u8fd4\u56de\u7ed3\u679c\u4e2d\u770b\u5230\u4e86\u5305\u542b\u6587\u5b57\u94fe\u63a5\u7684API\u3002OpenAPI\u7684\u94fe\u63a5\u529f\u80fd\u6dfb\u52a0\u4e86\u63cf\u8ff0\u4e0d\u540cAPI\u4e4b\u95f4\u94fe\u63a5\u7684\u9759\u6001\u5143\u6570\u636e\uff0c\u4ee5\u53ca\u5982\u4f55\u4f7f\u7528\u4e00\u4e2aAPI\u7684\u8f93\u51fa\u4f5c\u4e3a\u53e6\u4e00\u4e2aAPI\u7684\u8f93\u5165\u3002\u5f88\u9ad8\u5174\u770b\u5230\u66f4\u591a\u7684OpenAPI\u6587\u6863\u4f7f\u7528\u94fe\u63a5\u548c\u66f4\u597d\u7684\u5de5\u5177\u6765\u6307\u5b9a\u94fe\u63a5\u3002<\/p>\n

      \n
    • CALLBACKS<\/span>\uff08\u56de\u8c03\uff09<\/li>\n<\/ul>\n

      \u6ce8\u518cwebhook\u65f6\uff0c\u901a\u5e38\u4f1a\u5c06URL\u4f5c\u4e3a\u5b57\u7b26\u4e32\u4f20\u5165\uff0c\u7136\u540e\u8be5\u670d\u52a1\u5c06\u8c03\u7528\u8be5API\u3002OpenAPI 3.0\u5141\u8bb8\u63cf\u8ff0\u56de\u8c03\u7684\u7b7e\u540d\u4ee5\u53ca\u5b83\u5e94\u8be5\u5177\u6709\u7684\u53c2\u6570\u3002\u518d\u8005\uff0c\u8fd9\u975e\u5e38\u6709\u52a9\u4e8e\u8ba9\u5f00\u53d1\u4eba\u5458\u8131\u79bb\u6587\u6863\u5e76\u901a\u8fc7\u4ee3\u7801\u53d1\u73b0\u95ee\u9898\u3002<\/p>\n

      <\/p>\n

      \u66f4\u591a<\/strong><\/h1>\n

      \u91c7\u7528OpenAPI\u51cf\u8f7b\u4e86API\u521b\u5efa\u8005\u7684\u8d1f\u62c5\uff0c\u6807\u51c6\u5c31\u662f\u5f53\u5b83\u8ba9\u5f00\u53d1\u4eba\u5458\u4e0d\u4ec5\u5b66\u5f97\u66f4\u597d\u800c\u5b66\u4e60\u66f4\u5feb\u65f6\uff0c\u5b83\u5c31\u662f\u6700\u6709\u6548\u7684\u3002OpenAPI\u53ef\u4ee5\u505a\u66f4\u591a\u7684\u5de5\u4f5c\u6765\u4e13\u6ce8\u4e8e\u5de5\u5177\u672c\u8eab\u3002\u4f8b\u5982\uff0c\u4ee5\u4e0b\u662fGoogle Calendar API\u6559\u4f1a\u7528\u6237\u5bf9\u65e5\u5386\u4e8b\u4ef6\u8fdb\u884c\u5206\u9875\u7684\u65b9\u6cd5\uff1a<\/p>\n

        \n
      • \u8f93\u5165\uff1a<\/li>\n<\/ul>\n

        pageToken\uff1a<\/em>Token specifying which result page to return<\/em><\/p>\n

          \n
        • \u8f93\u51fa\uff1a<\/li>\n<\/ul>\n

          nextPageToken\uff1a<\/em>Token used to access the next page of this result. Omitted if no further results are available, in which case nextSyncToken is provided<\/em><\/p>\n

          \u4ed4\u7ec6\u9605\u8bfb\u7684\u8bdd\uff0c\u53ef\u4ee5\u770b\u51fa\u6211\u4eec\u5e94\u8be5\u4ecenextPageToken\u83b7\u53d6\u8f93\u51fa\u5e76\u5c06\u5176\u63d2\u5165\u5230\u6bcf\u4e2a\u8fde\u7eed\u8c03\u7528\u7684pageToken\u8f93\u5165\u4e2d\uff0c\u4f46\u662f\u5728OpenAPI\uff08\u6216Google\u7684\u4e13\u6709\u53d1\u73b0\u6587\u6863\u683c\u5f0f\uff09\u4e2d\u65e0\u6cd5\u8868\u8fbe\u8be5\u8bed\u4e49\u3002<\/p>\n

          \u603b\u7ed3<\/strong><\/h1>\n

          \u5982\u679c\u5df2\u6784\u5efaAPI\u6216\u6b63\u5728\u6784\u5efa\u65b0API\uff0c\u8bf7\u5f00\u59cb\u4f7f\u7528API\u63cf\u8ff0\u89c4\u8303\u3002OpenAPI\u4f1a\u662f\u8d8a\u6765\u8d8a\u53d7\u6b22\u8fce\u7684\u9009\u62e9\u3002\u5bf9\u4e8e\u5951\u7ea6\u4f18\u5148\u7684\u7406\u8bba\uff0cAPI\u89c4\u8303\u5e94\u8be5\u662fAPI\u9879\u76ee\u5f00\u59cb\u7684\u5730\u65b9\uff0c\u6709\u4e00\u4e9b\u5e38\u7528\u7684Web\u6846\u67b6\u5de5\u5177\u53ef\u4ee5\u4ece\u4ee3\u7801\u4e2d\u63d0\u53d6\u89c4\u8303\uff08\u5728\u67d0\u4e9b\u60c5\u51b5\u4e0b\u7531\u9644\u52a0\u7684\u6ce8\u91ca\u6216\u5907\u6ce8\u8f85\u52a9\uff09\u3002<\/p>\n

          \u65e0\u8bba\u662f\u5951\u7ea6\u4f18\u5148\u8fd8\u662f\u4ee3\u7801\u4f18\u5148\uff0c\u5b83\u5b9e\u9645\u4e0a\u53d6\u51b3\u4e8e\u5f00\u53d1\u65f6\u7684\u6d41\u7a0b\u3002\u5bf9\u4e8e\u5927\u578b\u7ec4\u7ec7\u800c\u8a00\uff0c\u5951\u7ea6\u4f18\u5148\u53ef\u80fd\u662f\u5728\u540c\u4e00\u9875\u9762\u4e0a\u660e\u786e\u5730\u83b7\u53d6\u670d\u52a1\u5668\u548c\u5ba2\u6237\u56e2\u961f\u7684\u6b63\u786e\u65b9\u6cd5\u3002\u5728\u7f16\u5199\u670d\u52a1\u5668\u4ee3\u7801\u65f6\uff0c\u5ba2\u6237\u7aef\u56e2\u961f\u53ef\u4ee5\u9488\u5bf9\u81ea\u52a8\u751f\u6210\u7684\u6a21\u62df\u8fdb\u884c\u7f16\u5199\u3002\u5bf9\u4e8e\u5ba2\u6237\u7aef\u548c\u670d\u52a1\u5668\u4e00\u8d77\u5f00\u53d1\u7684\u6216API\u672c\u8eab\u5c31\u662f\u4ea7\u54c1\u7684\u9879\u76ee\uff0c\u4ee3\u7801\u53ef\u80fd\u5c31\u8db3\u591f\u4e86\u3002<\/p>\n

          \u63a5\u4e0b\u6765\u5e94\u8be5\u505a\u7684\u6700\u91cd\u8981\u7684\u4e8b\u60c5\u5c31\u662f\u53d1\u5e03\u5b83\uff0c\u5e76\u4f7f\u5176\u4fdd\u6301\u6700\u65b0\u3002\u901a\u8fc7\u53d1\u5e03API\u6587\u6863\uff0c\u53ef\u4ee5\u4e86\u89e3\u5f00\u53d1\u4eba\u5458\u4f7f\u7528API\u7684\u5de5\u5177\u3002\u6a21\u62df\u6d4b\u8bd5\u610f\u5473\u7740\u5f00\u53d1\u4eba\u5458\u53ef\u4ee5\u82b1\u66f4\u5c11\u7684\u65f6\u95f4\u6765\u4e86\u89e3API\u7684\u7ec6\u8282\u5e76\u4e14\u82b1\u5145\u8db3\u7684\u65f6\u95f4\u6784\u5efa\u3002\u968f\u7740OpenAPI\u53ca\u5176\u5de5\u5177\u751f\u6001\u7cfb\u7edf\u7684\u53d1\u5c55\uff0c\u968f\u7740\u6846\u67b6\u548c\u5e73\u53f0\u53d8\u5f97\u66f4\u52a0\u667a\u80fd\uff0cAPI\u7684\u4f5c\u7528\u6b63\u53d8\u5f97\u8d8a\u6765\u8d8a\u5168\u9762\u3002<\/p>\n

           <\/p>\n

          \u53c2\u8003\u8d44\u6599\uff1a<\/em>Adam Leventhal\uff0cUsing OpenAPI to Build Smart APIs for Dumb Machines<\/em><\/p>\n

          \u539f\u6587\u5730\u5740\uff1a<\/em>https:\/\/www.infoq.com\/articles\/openapi\/?useSponsorshipSuggestions<\/em><\/p>\n","protected":false},"excerpt":{"rendered":"

          OpenAPI\u53ef\u4ee5\u9a71\u52a8\u5f3a\u5927\u7684\u6d4b\u8bd5\u81ea\u52a8\u5316\uff0c\u5b83\u53ef\u4ee5\u7528\u4e8e\u751f\u6210\u6a21\u62df\u6570\u636e\uff0c\u4ece\u800c\u8ba9\u5f00\u53d1\u4eba\u5458\u4e2d\u66f4\u80fd\u5206\u6790\u51fa\u5176\u590d\u6742\u6027\u3002\u4f60\u53ef\u4ee5\u5229\u7528 […]<\/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\/2485"}],"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=2485"}],"version-history":[{"count":26,"href":"http:\/\/blog.eolinker.com\/index.php?rest_route=\/wp\/v2\/posts\/2485\/revisions"}],"predecessor-version":[{"id":2732,"href":"http:\/\/blog.eolinker.com\/index.php?rest_route=\/wp\/v2\/posts\/2485\/revisions\/2732"}],"wp:attachment":[{"href":"http:\/\/blog.eolinker.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=2485"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"http:\/\/blog.eolinker.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=2485"},{"taxonomy":"post_tag","embeddable":true,"href":"http:\/\/blog.eolinker.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=2485"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}