sdfobject-power_control.swagger.json

{
  "swagger": "2.0",
  "info": {
    "title": "OMA/IPSO Power Control (Object ID 3312)",
    "version": "2022-02-22",
    "license": {
      "name": "BSD-3-Clause",
      "x-copyright": "Copyright 2019 Open Mobile Alliance."
    }
  },
  "schemes": [
    "http"
  ],
  "consumes": [
    "application/json"
  ],
  "produces": [
    "application/json"
  ],
  "paths": {
    "/Omaipsopowercontrolobjectid3312ResURI": {
      "get": {
        "description": " This Object is used to control a power source, such as a Smart Plug.  It allows a power relay to be turned on or off and its dimmer setting to be control as a % between 0 and 100.",
        "parameters": [
          {
            "$ref": "#/parameters/interface"
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "schema": {
              "$ref": "#/definitions/Omaipsopowercontrolobjectid3312"
            }
          }
        }
      }
    }
  },
  "parameters": {
    "interface": {
      "in": "query",
      "name": "if",
      "type": "string",
      "enum": [
        "oic.if.s",
        "oic.if.baseline"
      ]
    }
  },
  "definitions": {
    "Omaipsopowercontrolobjectid3312": {
      "properties": {
        "rt": {
          "description": "The Resource Type.",
          "items": {
            "enum": [
              "oic.r.o.power.control"
            ],
            "type": "string"
          },
          "minItems": 1,
          "uniqueItems": true,
          "readOnly": true,
          "type": "array"
        },
        "n": {
          "$ref": "https://openconnectivityfoundation.github.io/core/schemas/oic.common.properties.core-schema.json#/definitions/n"
        },
        "if": {
          "description": "The OCF Interface set supported by this Resource.",
          "items": {
            "enum": [
              "oic.if.s",
              "oic.if.baseline"
            ],
            "type": "string"
          },
          "minItems": 1,
          "uniqueItems": true,
          "readOnly": true,
          "type": "array"
        },
        "On_Off": {
          "description": "On/off control. Boolean value where True is On and False is Off.",
          "x-label": "On/Off",
          "type": "boolean"
        },
        "Dimmer": {
          "description": "This resource represents a dimmer setting, which has an Integer value between 0 and 100 as a percentage.",
          "x-label": "Dimmer",
          "maximum": 100,
          "minimum": 0,
          "type": "integer",
          "x-unit": "/100"
        },
        "On_time": {
          "description": "The time in seconds that the device has been on. Writing a value of 0 resets the counter.",
          "x-label": "On time",
          "type": "integer",
          "x-unit": "s"
        },
        "Cumulative_active_power": {
          "description": "The cumulative active power since the last cumulative energy reset or device start.",
          "x-label": "Cumulative active power",
          "type": "number",
          "x-unit": "Wh",
          "readOnly": true
        },
        "Power_factor": {
          "description": "If applicable, the power factor of the current consumption.",
          "x-label": "Power factor",
          "type": "number",
          "readOnly": true
        },
        "Application_Type": {
          "description": "The application type of the sensor or actuator as a string depending on the use case.",
          "x-label": "Application Type",
          "type": "string"
        },
        "Timestamp": {
          "description": "The timestamp of when the measurement was performed.",
          "x-label": "Timestamp",
          "x-sdfType": "unix-time",
          "type": "number",
          "readOnly": true
        },
        "Fractional_Timestamp": {
          "description": "Fractional part of the timestamp when sub-second precision is used (e.g., 0.23 for 230 ms).",
          "x-label": "Fractional Timestamp",
          "maximum": 1,
          "minimum": 0,
          "type": "number",
          "x-unit": "s",
          "readOnly": true
        }
      },
      "type": "object",
      "required": [
        "On_Off"
      ]
    }
  }
}