您正在查看的是 Apigee Edge 文档。
转到 Apigee X 文档。 信息
在本教程中,您将创建 OpenAPI 规范,以便为调用目标服务器的 API 建模。目标服务器由一个非常简单、基于 Node.js 的服务器组成,您可以在自己的机器上创建和运行该服务器。完成本教程大约需要 10 分钟。
学习内容
在本教程中,您将了解如何:
- 创建一个简单的 Node.js 服务器
- 创建 OpenAPI 规范 ,为调用 Node.js 服务器的 API 建模
所需条件
在开始之前,您需要做好以下准备:
- Apigee Edge 帐号(请参阅创建 Apigee Edge 帐号)
- 最新版本的 Node.js
- curl 命令行工具
- 文本编辑器
创建一个简单的 Node.js 服务器
如需创建一个简单的 Node.js 服务器,请执行以下操作:
- 创建一个名为
index.js
的文件。 将以下 Node.js 代码复制到该文件中:
var express = require('express'); var app = express(); app.get('/v1/hello', function (req, res) { res.setHeader("Access-Control-Allow-Origin", "*"); res.send('Hello World!\n'); }); app.listen(3000, function () { console.log('Example app listening on port 3000!'); });
保存文件。
安装所需的 Express 模块:
npm install express
启动服务器:
node index.js
返回以下消息:
Example app listening on port 3000
通过发送以下 HTTP 请求来测试 API。
curl localhost:3000/v1/hello
该 API 会返回:Hello World!
创建 OpenAPI 规范
创建一个 OpenAPI 规范,以便为调用 Node.js 服务器的 API 建模。
- 登录 apigee.com/edge。
- 在侧边导航栏中,依次选择 Develop > Specs。
系统随即会显示规范列表。 点击 + 规范,然后从下拉菜单中选择 New Spec。
复制以下 YAML 内容:
swagger: "2.0" info: version: "0.0.1" title: Hello World API host: 127.0.0.1:3000 basePath: /v1 schemes: - http consumes: - application/json produces: - application/json paths: '/hello': get: description: Returns greetings to the caller operationId: hello responses: "200": description: Success schema: $ref: "#/definitions/HelloWorldResponse" default: description: Error schema: $ref: "#/definitions/ErrorResponse" definitions: HelloWorldResponse: required: - message properties: message: type: string age: type: number ErrorResponse: required: - message properties: message: type: string
将 YAML 内容粘贴到编辑器的左侧窗格中(覆盖当前内容)。
点击保存。
系统会提示您为规范命名。为该规范输入一个名称,例如:simple-spec。
点击继续。
系统会保存规范。点击 Close(关闭)可关闭规范并返回到规范列表。
新规范便会显示在规范列表中。
后续步骤
恭喜!您已创建了您的第一个 OpenAPI 规范,用于对调用目标服务器的 API 建模。
接下来,了解如何根据 OpenAPI 规范创建 API 代理。