Swagger wird auf der Webseite https://de.wikipedia.org/wiki/Swagger_(Software) wie folgt beschrieben:
Swagger ist eine Schnittstellenbeschreibungssprache zur Beschreibung von RESTful APIs, die mit JSON ausgedrückt werden. Swagger wird zusammen mit einer Reihe von Open-Source-Software-Tools verwendet, um RESTful-Webdienste zu entwerfen, zu erstellen, zu dokumentieren und zu verwenden. Swagger umfasst automatische Dokumentation, Codegenerierung (in vielen Programmiersprachen) und Testfallgenerierung.
Die vollständige Dokumentation finden Sie hier: https://swagger.io/docs/
Das vorherige json-Beispiel ist in Swagger JSON wie folgt spezifiziert:
{
"DeviceResult": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"$ref": "#/definitions/UUID"
},
"siteName": {
"type": "string"
},
"siteId": {
"$ref": "#/definitions/UUID"
},
"location": {
"type": "object",
"properties": {
"latitude": {
"type": "number",
"format": "float"
},
"longitude": {
"type": "number",
"format": "float"
},
"description": {
"type": "string"
}
}
},
"customFields": {
"description": "Custom fields.",
"type": "array",
"items": {
}
},
"status": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "device name"
},
"serial": {
"type": "string",
"description": "device serial number"
},
"mac": {
"type": "string",
"description": "device mac address"
},
"ip": {
"type": "string",
"description": "device ip address"
},
"model": {
"type": "string",
"description": "device model"
},
"heartbeatState": {
"type": "string",
"enum": [
"ACTIVE",
"INACTIVE",
"REDIRECTED",
"UNKNOWN",
"SHADOW"
]
}
}
}
}
}
}
|
|---|