Implementierung einer API für die esb-Plattform

Anforderungen an die Entwicklungsumgebung

docker
docker-compose

Anforderungen an die API

Laufzeitumgebung: freie Wahl
Datenbank: frei Wahl
Kommunikation nach innen: alles was geht
Kommunikation nach außen: nur REST+JSON mit HAL bzw HATEOAS

Laufzeitumgebung auswählen und vorbereiten

In diesem Beispiel: Node.js 14

## Installation
````
$ docker-compose run --rm cli
Creating network "adonis-esb-api_default" with the default driver
root@a0cfd1c96108:/usr/src/app# yarn create adonis-ts-app .
yarn create v1.22.5
[1/4] Resolving packages...
[2/4] Fetching packages...
[3/4] Linking dependencies...
[4/4] Building fresh packages...
success Installed "create-adonis-ts-app@4.0.2" with binaries:
      - create-adonis-ts-app
[###############################################################################################################################################################################################] 191/191    _       _             _         _
   / \   __| | ___  _ __ (_)___    | |___
  / _ \ / _` |/ _ \| '_ \| / __|_  | / __|
 / ___ \ (_| | (_) | | | | \__ \ |_| \__ \
/_/   \_\__,_|\___/|_| |_|_|___/\___/|___/

CUSTOMIZE PROJECT
❯ Select the project structure …  Press <ENTER> to select
▸ api   (Tailored for creating a REST API server)
  web   (Traditional web application with server rendered templates)
  slim  (A smallest possible AdonisJS application)
````

## /_doc
soll so aussehen (Beispiel):
````
{
  "swagger": "2.0",
  "info": {
    "version": "1.0.0",
    "title": "Swagger Petstore",
    "description": "A sample API that uses a petstore as an example to demonstrate features in the swagger-2.0 specification",
    "termsOfService": "http://swagger.io/terms/",
    "contact": {
      "name": "Swagger API Team"
    },
    "license": {
      "name": "MIT"
    }
  },
  "host": "petstore.swagger.io",
  "basePath": "/api",
  "schemes": [
    "http"
  ],
  "consumes": [
    "application/json"
  ],
  "produces": [
    "application/json"
  ],
  "paths": {
    "/pets": {
      "get": {
        "description": "Returns all pets from the system that the user has access to",
        "produces": [
          "application/json"
        ],
        "responses": {
          "200": {
            "description": "A list of pets.",
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/definitions/Pet"
              }
            }
          }
        }
      }
    }
  },
  "definitions": {
    "Pet": {
      "type": "object",
      "required": [
        "id",
        "name"
      ],
      "properties": {
        "id": {
          "type": "integer",
          "format": "int64"
        },
        "name": {
          "type": "string"
        },
        "tag": {
          "type": "string"
        }
      }
    }
  }
}
````