Files
MSE-SoftwEng/gateway/src/docs/docs.go

216 lines
6.7 KiB
Go

// Package docs Code generated by swaggo/swag. DO NOT EDIT
package docs
import "github.com/swaggo/swag"
const docTemplate = `{
"schemes": {{ marshal .Schemes }},
"swagger": "2.0",
"info": {
"description": "{{escape .Description}}",
"title": "{{.Title}}",
"contact": {},
"version": "{{.Version}}"
},
"host": "{{.Host}}",
"basePath": "{{.BasePath}}",
"paths": {
"/ping": {
"get": {
"description": "get ping response",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"ping"
],
"summary": "Ping test endpoint",
"responses": {
"200": {
"description": "pong",
"schema": {
"type": "string"
}
}
}
}
},
"/raclette": {
"get": {
"security": [
{
"BasicAuth": []
}
],
"description": "Request data from InfluxDB for a specific device in a room",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"request"
],
"summary": "Request Influx data",
"parameters": [
{
"type": "string",
"example": "remi",
"description": "User name",
"name": "user",
"in": "query",
"required": true
},
{
"type": "string",
"example": "Bedroom",
"description": "Room name",
"name": "room",
"in": "query",
"required": true
},
{
"type": "string",
"example": "DoorSensor",
"description": "Device name",
"name": "device",
"in": "query",
"required": true
}
],
"responses": {
"200": {
"description": "Returns a map of field names to their latest values.",
"schema": {
"type": "object",
"additionalProperties": true
}
},
"500": {
"description": "Internal Server Error",
"schema": {
"$ref": "#/definitions/gin.H"
}
}
}
},
"post": {
"security": [
{
"BasicAuth": []
}
],
"description": "Publish a command to a specific device in a room",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"commands"
],
"summary": "Publish command",
"parameters": [
{
"type": "string",
"example": "remi",
"description": "User name",
"name": "user",
"in": "query",
"required": true
},
{
"type": "string",
"example": "Bedroom",
"description": "Room name",
"name": "room",
"in": "query",
"required": true
},
{
"type": "string",
"example": "DoorSensor",
"description": "Device name",
"name": "device",
"in": "query",
"required": true
},
{
"description": "Command to publish",
"name": "command",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/main.Command"
}
}
],
"responses": {
"200": {
"description": "status:ok",
"schema": {
"type": "object",
"additionalProperties": {
"type": "string"
}
}
},
"500": {
"description": "Internal Server Error",
"schema": {
"$ref": "#/definitions/gin.H"
}
}
}
}
}
},
"definitions": {
"gin.H": {
"type": "object",
"additionalProperties": {}
},
"main.Command": {
"description": "Command structure for publishing",
"type": "object",
"required": [
"command"
],
"properties": {
"command": {
"type": "string",
"example": "measure"
}
}
}
},
"securityDefinitions": {
"BasicAuth": {
"type": "basic"
}
}
}`
// SwaggerInfo holds exported Swagger Info so clients can modify it
var SwaggerInfo = &swag.Spec{
Version: "1.0",
Host: "rest.mse.kb28.ch",
BasePath: "/",
Schemes: []string{},
Title: "Swagger SoftwEng API",
Description: "REST API for the SoftwEng course in MSE",
InfoInstanceName: "swagger",
SwaggerTemplate: docTemplate,
LeftDelim: "{{",
RightDelim: "}}",
}
func init() {
swag.Register(SwaggerInfo.InstanceName(), SwaggerInfo)
}