CallThingServices - - Alibaba Cloud ドキュメントセンター

デバイス上のサービスを呼び出します。

リクエスト構文

POST /2019-09-30/things/ ProductKey/DeviceName/services HTTP/1.1
Cookie: Cookie

Payload

リクエストパラメーター

パラメーター	タイプ	必須	説明
ProductKey	文字列	はい	デバイスが属するプロダクトの一意の識別子です。このパラメーターの値は、IoT Platform コンソールから取得できます。
DeviceName	String	はい	デバイスの名前です。このパラメーターの値は、IoT Platform コンソールから取得できます。
Cookie	String	はい	CreateAuthCookie API 操作を呼び出すときに生成される認証クッキーです。
Payload	JSON	はい	呼び出されるサービスの名前とパラメーターです。サービスの名前とパラメーターは、IoT Platform のデバイスのプロダクト TSL で定義されているものと同じである必要があります。詳細については、リクエストのペイロード形式をご参照ください。

リクエストのペイロード形式は次のとおりです：

{
  "Services": [
    {
      "Name": "string",
      "Args": args // サービスのオプション引数。
    }
  ]
}

応答構文

HTTP/1.1 StatusCode
Content-Type: application/json

Payload

応答パラメーター

パラメーター	タイプ	説明
StatusCode	Number	操作の状態コードです。リクエストが成功した場合、200 が返されます。リクエストが失敗した場合、他の状態コードが返されます。詳細については、「状態コード」をご参照ください。
Payload	JSON	サービス呼び出しの応答です。

返されるペイロードの形式は次のとおりです：

{
  "Code": 200,
  "Message": "sucess|reason for failure",
  "Data": {
    "Services": [
      {
        "Name": "string",
        "Returns": {
          "Message": "success|reason for failure",
          "Data": string|boolean|number|array|object, // 基盤となるサービス呼び出しから返されるオプションのデータ。
        }
      }
    ],
      "Timestamp": 1568262117344
  }
}

例

$ curl -i -b token.cookie -d '{"Services":[{"Name":"setColor","Args": {"color":"red"}}]}' -k -X POST https://127.0.0.1:9999/2019-09-30/things/a1WabAEC***/N0hB9tiVWWZFMpALK***/services

HTTP/1.1 200 OK
Server: openresty/1.13.6.2
Date: Thu, 31 Oct 2019 11:17:47 GMT
Content-Type: application/json; charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive

{"Data":{"Services":[{"Name":"setColor","Returns":{"Message":"success","Data":[]}}],"Timestamp":1572520667899},"Code":200,"Message":"success"}