https://github.com/sfuhrm/openapi-examples

Examples for an OpenAPI talk in 2021
https://github.com/sfuhrm/openapi-examples

ionos java openapi rest-api talk

Last synced: about 1 month ago
JSON representation

Examples for an OpenAPI talk in 2021

• Host: GitHub
• URL: https://github.com/sfuhrm/openapi-examples
• Owner: sfuhrm
• License: gpl-3.0
• Created: 2021-07-07T15:33:23.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2021-07-20T14:56:59.000Z (about 4 years ago)
• Last Synced: 2025-04-09T11:50:17.487Z (6 months ago)
• Topics: ionos, java, openapi, rest-api, talk
• Language: Shell
• Homepage: https://techup.ionos.de/
• Size: 138 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

          
# OpenAPI Examples

[![Build examples](https://github.com/sfuhrm/openapi-examples/actions/workflows/generate.yml/badge.svg)](https://github.com/sfuhrm/openapi-examples/actions/workflows/generate.yml)

[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)

Some simple examples from an [OpenAPI talk](https://techup.ionos.de/) to show the usage of the OpenAPI specification.

Code generation is done using the [OpenAPI Generator](https://github.com/OpenAPITools/openapi-generator).

Reformatting the generated code is done using the

[Google Formatter](https://github.com/google/google-java-format/).

## Requirements

* Linux with Bash shell

* [JDK 11+](https://adoptopenjdk.net/)

* [Apache Maven 3.8+](https://maven.apache.org/download.cgi)

## Setup

* Download the OpenAPI Generator and Google Formatter:

```bash

./download.sh

```

* Then create the files you need using one of the scripts

  in the sub folders.

## Examples

### Daytime service

The service is inspired by the [daytime protocol](https://en.wikipedia.org/wiki/Daytime_Protocol),

but is not intended to replace it or use the date formats of that protocol.

The API documentation can be viewed [here](https://app.swaggerhub.com/apis-docs/sfuhrm.de/Daytime/0.0.3).

### Shopping cart service

A simple shopping cart that can be accessed using HTTP.

The API documentation can be viewed [here](https://app.swaggerhub.com/apis-docs/sfuhrm.de/ShoppingCart/0.1.0).

## License

This content is licensed under [GPL 3.0](LICENSE.txt).