Informationen zur Software "Swagger"

Die LMC-API verwendet Swagger/OpenAPI zur Spezifikation/Dokumentation der API-Schnittstelle.

Die Swagger index.json ist hier zu finden: https://cloud.lancom.de/<micro-service>/api-docs/index.json

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"
                        ]
                    }
                }
            }
        }
    }
}

Seitenhierarchie

Service & Support

Links