action.devices.QUERY

이 인텐트는 기기가 온라인 상태이고 연결 가능한지를 포함하여 기기의 현재 상태에 대한 처리를 쿼리합니다.

QUERY 응답은 상태 정보만 반환해야 합니다. 기기의 속성 및 특성 업데이트는 SYNC 응답에 의해 처리됩니다.

자세한 내용은 쿼리 및 실행을 참고하세요.

요청 형식

필드	유형	설명
requestId	String	필수사항. 요청의 ID입니다.
inputs	배열	필수사항. 인텐트 요청과 일치하는 입력 목록
[item, ...]	객체	인텐트 요청과 연결된 유형 및 페이로드
intent		필수사항. (상수 값: "action.devices.QUERY") 인텐트 요청 유형입니다.
payload	객체	필수사항. QUERY 요청 페이로드
devices	배열	필수사항. 대상 기기 목록
[item, ...]	객체	쿼리할 기기 타겟입니다.
id	String	필수사항. 기기 ID(SYNC에서 제공한 ID 기준)
customData	객체	불투명한 커스텀 데이터 객체가 SYNC에서 제공되면 여기로 전송됩니다.

예

QUERY 인텐트 요청

{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "inputs": [
    {
      "intent": "action.devices.QUERY",
      "payload": {
        "devices": [
          {
            "id": "123",
            "customData": {
              "fooValue": 74,
              "barValue": true,
              "bazValue": "foo"
            }
          },
          {
            "id": "456",
            "customData": {
              "fooValue": 12,
              "barValue": false,
              "bazValue": "bar"
            }
          }
        ]
      }
    }
  ]
}

응답 형식

필드	유형	설명
requestId	String	필수사항. 해당 요청의 ID
payload	객체	필수사항. 인텐트 응답 페이로드
errorCode	String	인증 실패 및 개발자 시스템 사용 불가에 관한 전체 트랜잭션의 오류 코드입니다. 개별 기기 오류의 경우 기기 객체 내에서 errorCode를 사용합니다.
debugString	String	사용자에게 표시되지는 않지만 개발 중에 기록되거나 사용될 수 있는 자세한 오류입니다.
devices	객체	필수사항. 기기 지도 개발자 기기 ID를 상태 속성의 객체에 매핑합니다.
<string>	객체	기기 상태
online	Boolean	필수사항. 기기가 온라인 상태 (즉, 연결 가능)인지 여부를 나타냅니다.
status	String	필수사항. 쿼리 작업의 결과입니다. 지원 값: SUCCESS 쿼리가 성공했는지 확인합니다. OFFLINE 대상 기기가 오프라인 상태이거나 연결할 수 없습니다. EXCEPTIONS 검색어와 관련된 문제 또는 알림이 있습니다. 쿼리가 성공하거나 실패할 수 있습니다. 이 상태 유형은 일반적으로 연결된 다른 기기에 관한 추가 정보를 전송하려는 경우에 설정됩니다. ERROR 대상 기기를 쿼리할 수 없습니다.
errorCode	String	미리 설정된 오류 코드에서 필요한 경우 오류 상태를 펼칩니다. 그러면 사용자에게 표시되는 오류에 매핑됩니다.

예

QUERY 인텐트 응답

{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "devices": {
      "123": {
        "on": true,
        "online": true,
        "status": "SUCCESS"
      },
      "456": {
        "on": true,
        "online": true,
        "status": "SUCCESS",
        "brightness": 80,
        "color": {
          "spectrumRgb": 16711935
        }
      }
    }
  }
}