API Descriptions: Discharge (Water Consumption) Meter

Below bodies of responses to requests to the given URLs are presented, including the .well-known/core URL.

Response to GET /.well-known/core

• /
  • rt = http://schema.org/EntryPoint
• /dischargeValue
  • rt = http://external/doc#DischargeValue

Response to GET /

{
  "@context": "http://external/doc#",
  "@id": "coap://0.0.0.0/",
  "@type": "DischargeMeterDevice",
  "identifier": "e9704",
  "label": { "@value": "Discharge Meter Device", "@language": "en" },
  "location": {
    "@type": "Place",
    "label": "1010"
  },
  "temperature": "/dischargeValue"
}

PUT Request to /

{
  "@context": "coap://external/doc#",
  "@type": "doc:DischargeMeterDevice",
  "location": {
    "@type": "Place",
    "label": "366"
  }
}

Response to GET http://external/doc

{
  "@context": [
    "https://w3id.org/semiot/device/commoncontext#",
    { "doc": "http://external/doc#" }
  ],
  "@id": "doc:ApiDocumentation",
  "@type": "ApiDocumentation",
  "supportedClass": [
    {
      "@id": "doc:DischargeMeterDevice",
      "subClassOf": "Device",
      "supportedProperty": {
        "property": "location",
        "writable": "true",
        "label": "Location"
      },
      "supportedProperty": {
        "property": "label",
        "writable": "false",
        "label": "Label"
      },
      "supportedOperation": {
        "method": "PUT",
        "expects": "doc:DischargeMeterDevice",
        "returns": "doc:DischargeMeterDevice"
      }
    },
    {
      "@id": "doc:DischargeValue",
      "@type": "Link",
      "range": {
        "@id": "doc:DischargeValue",
        "subClassOf": "QuantitativeValue",
        "label": "Discharge (L)"
      }
    }
  ]
}

Response to GET /dischargeValue

{
  "@context": "coap://external/doc#",
  "@type": "doc:DischargeValue",
  "value": "42",
  "unitCode": "L"
}