Создайте спецификацию OpenAPI

Вы просматриваете документацию Apigee Edge .
Перейдите к документации Apigee X. информация

В этом руководстве вы создадите спецификацию OpenAPI для моделирования API, который вызывает целевой сервер. Целевой сервер состоит из очень простого сервера на базе Node.js, который вы создаете и запускаете на своем компьютере. Выполнение этого урока займет около 10 минут.

Что вы узнаете

В этом уроке вы узнаете, как:

• Создайте простой сервер Node.js.
• Создайте спецификацию OpenAPI , которая моделирует API, вызывающий сервер Node.js.

Что вам понадобится

Вот что вам понадобится для начала:

• Учетная запись Apigee Edge (см. Создание учетной записи Apigee Edge )
• Последняя версия Node.js
• инструмент командной строки Curl
• Текстовый редактор

Создайте простой сервер Node.js.

Чтобы создать простой сервер Node.js:

1. Создайте файл с именем index.js .

2. Скопируйте в файл следующий код 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!');
   });
   

3. Сохраните файл.

4. Установите необходимый экспресс-модуль:

   npm install express

5. Запустите сервер:

   node index.js

   Возвращается следующее сообщение:
   Example app listening on port 3000

6. Проверьте API, отправив следующий HTTP-запрос.

   curl localhost:3000/v1/hello

   API возвращает: Привет, мир!

Создайте спецификацию OpenAPI

Создать спецификацию OpenAPI, моделирующую API, вызывающий сервер Node.js.

1. Войдите на сайт apigee.com/edge .
2. Выберите «Разработка» > «Спецификации» на боковой панели навигации.
   Отображается список технических характеристик.

3. Нажмите + Spec и выберите New Spec в раскрывающемся меню.

4. Скопируйте следующий контент 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
   

5. Вставьте содержимое YAML в левую панель редактора (перезаписав текущий контент).

6. Нажмите Сохранить .
   Вам будет предложено назвать спецификацию.

7. Введите имя спецификации, например: simple-spec .

8. Нажмите Продолжить .
   Спецификация сохранена.

9. Нажмите «Закрыть» , чтобы закрыть спецификацию и вернуться к списку спецификаций.

Новая спецификация отображается в списке спецификаций.

Что дальше?

Поздравляем! Вы создали свою первую спецификацию OpenAPI для моделирования API, который вызывает целевой сервер.

Далее узнайте, как создать прокси-сервер API на основе спецификации OpenAPI .