웹 사물(WoT) 프로파일

Property 값을 읽을 때 사용할 property 리소스의 URL은 Thing Description에서 해당 PropertyAffordance 내부의 다음 조건을 만족하는 Form을 찾아 얻어야 MUST 합니다:

• 기본값이 적용된 후, 그 op 멤버가 readproperty 값을 포함합니다
• 해당되는 경우 base URL을 기준으로 확인된 후, 그 href 멤버 값의 URI scheme [RFC3986]이 http 또는 https입니다
• 기본값이 적용된 후, 그 contentType 멤버의 값이 application/json입니다

Property 값을 읽으려면, Consumer는 다음과 같은 HTTP 요청을 Web Thing에 보내야 MUST 합니다:

• 메서드는 GET으로 설정
• URL은 property 리소스의 URL로 설정
• Accept 헤더는 application/json으로 설정

Web Thing이 위 형식을 따르는 HTTP 요청을 수신하고, Consumer가 해당 Property를 읽을 권한이 있으면, Property 값을 성공적으로 읽은 후 다음과 같은 HTTP 응답을 보내야 MUST 합니다:

• 상태 코드는 200으로 설정
• Content-Type 헤더는 application/json으로 설정
• JSON으로 직렬화된 property 값을 포함하는 본문

Property 값을 쓸 때 사용할 property 리소스의 URL은 Thing Description에서 해당 PropertyAffordance 내부의 다음 조건을 만족하는 Form을 찾아 얻어야 MUST 합니다:

• 기본값이 적용된 후, 그 op 멤버가 writeproperty 값을 포함합니다
• 해당되는 경우 base URL을 기준으로 확인된 후, 그 href 멤버 값의 URI scheme [RFC3986]이 http 또는 https입니다
• 기본값이 적용된 후, 그 contentType 멤버의 값이 application/json입니다

Property 값을 쓰려면, Consumer는 다음과 같은 HTTP 요청을 Web Thing에 보내야 MUST 합니다:

• 메서드는 PUT으로 설정
• URL은 property 리소스의 URL로 설정
• Content-Type 헤더는 application/json으로 설정
• JSON으로 직렬화된 property의 요청된 새 값을 포함하는 본문

Web Thing이 위 형식을 따르는 HTTP 요청을 수신하고, Consumer가 해당 Property를 쓸 권한이 있으면, property 값을 성공적으로 쓴 후 다음과 같은 HTTP 응답을 보내야 MUST 합니다:

• 상태 코드는 204로 설정

모든 Properties 값을 한 번에 읽을 때 사용할 properties 리소스의 URL은 Thing Description에서 최상위 forms 멤버 내부의 다음 조건을 만족하는 Form을 찾아 얻어야 MUST 합니다:

• 그 op 멤버가 readallproperties 값을 포함합니다
• 해당되는 경우 base URL을 기준으로 확인된 후, 그 href 멤버 값의 URI scheme [RFC3986]이 http 또는 https입니다
• 기본값이 적용된 후, 그 contentType 멤버의 값이 application/json입니다

모든 Properties 값을 읽으려면, Consumer는 다음과 같은 HTTP 요청을 Web Thing에 보내야 MUST 합니다:

• 메서드는 GET으로 설정
• URL은 properties 리소스의 URL로 설정
• Accept 헤더는 application/json으로 설정

Web Thing이 위 형식을 따르는 HTTP 요청을 수신하면, Consumer가 접근 권한을 가진 모든 읽기 가능한 Properties 값을 성공적으로 읽은 후, 다음과 같은 HTTP 응답을 보내야 MUST 합니다:

• 상태 코드는 200으로 설정
• Content-Type 헤더는 application/json으로 설정
• 모든 읽기 가능한 properties의 값을 property 이름을 키로 하는 객체로 JSON 직렬화한 본문

여러 Properties 값을 한 번에 쓸 때 사용할 properties 리소스의 URL은 Thing Description에서 최상위 forms 멤버 내부의 다음 조건을 만족하는 Form을 찾아 얻어야 MUST 합니다:

• 그 op 멤버가 writemultipleproperties 값을 포함합니다
• 해당되는 경우 base URL을 기준으로 확인된 후, 그 href 멤버 값의 URI scheme [RFC3986]이 http 또는 https입니다
• 기본값이 적용된 후, 그 contentType 멤버의 값이 application/json입니다

여러 properties 값을 한 번에 쓰려면, Consumer는 다음과 같은 HTTP 요청을 Web Thing에 보내야 MUST 합니다:

• 메서드는 PUT으로 설정
• URL은 Properties 리소스의 URL로 설정
• Content-Type 헤더는 application/json으로 설정
• 쓰기 가능한 Properties의 요청된 새 값을 property 이름을 키로 하는 객체로 JSON 직렬화한 본문

Web Thing이 위 형식을 따르는 HTTP 요청을 수신하면, 요청된 쓰기 가능한 Properties 값을 성공적으로 쓴 후 다음과 같은 HTTP 응답을 보내야 MUST 합니다:

• 상태 코드는 204로 설정

Action을 호출할 때 사용할 action 리소스의 URL은 Thing Description에서 해당 ActionAffordance 내부의 다음 조건을 만족하는 Form을 찾아 얻어야 MUST 합니다:

• 기본값이 적용된 후, 그 op 멤버의 값이 invokeaction입니다
• 해당되는 경우 base URL을 기준으로 확인된 후, 그 href 멤버 값의 URI scheme [RFC3986]이 http 또는 https입니다
• 기본값이 적용된 후, 그 contentType 멤버의 값이 application/json입니다

Web Thing에서 Action을 호출하려면, Consumer는 다음과 같은 HTTP 요청을 Web Thing에 보내야 MUST 합니다:

• 메서드는 POST로 설정
• URL은 action 리소스의 URL로 설정
• Accept 헤더는 application/json으로 설정
• Content-Type 헤더는 application/json으로 설정(action에 입력이 있는 경우에만)
• 있는 경우 action에 대한 입력을 JSON으로 직렬화한 본문

Web Thing이 위 형식을 따르는 HTTP 요청을 수신하면 세 가지 응답 형식 중 하나로 응답해야 MUST 합니다:

1. 동기식 액션 응답
2. 비동기식 액션 응답
3. 오류 응답

action 요청의 상태를 질의하려면, Consumer는 다음과 같은 HTTP 요청을 Web Thing에 보내야 MUST 합니다:

• 메서드는 GET으로 설정
• URL은 ActionStatus 리소스의 URL로 설정
• Accept 헤더는 application/json으로 설정

Web Thing이 위 형식을 따르는 HTTP 요청을 수신하고, Consumer가 해당 ActionStatus 리소스를 질의할 권한이 있으면, action 요청의 상태를 성공적으로 읽은 후 다음과 같은 HTTP 응답을 보내야 MUST 합니다:

• 상태 코드는 200으로 설정
• Content-Type 헤더는 application/json으로 설정
• action 요청의 현재 상태를 나타내는 ActionStatus 객체를 JSON 직렬화하여 포함하는 본문

action 요청을 취소하려면, Consumer는 다음과 같은 HTTP 요청을 Web Thing에 보내야 MUST 합니다:

• 메서드는 DELETE로 설정
• URL은 ActionStatus 리소스의 URL로 설정

Web Thing이 위 형식을 따르는 HTTP 요청을 수신하고, Consumer가 해당 action 요청을 취소할 권한이 있으면, action을 성공적으로 취소한 후 다음과 같은 HTTP 응답을 보내야 MUST 합니다:

• 상태 코드는 204로 설정

진행 중인 모든 action 요청의 상태를 질의할 때 사용할 actions 리소스의 URL은 Thing Description에서 최상위 forms 멤버 내부의 다음 조건을 만족하는 Form을 찾아 얻어야 MUST 합니다:

• 그 op 멤버가 queryallactions 값을 포함합니다
• 해당되는 경우 base URL을 기준으로 확인된 후, 그 href 멤버 값의 URI scheme [RFC3986]이 http 또는 https입니다
• 기본값이 적용된 후, 그 contentType 멤버의 값이 application/json입니다

진행 중인 모든 action 요청의 상태를 질의하려면, Consumer는 다음과 같은 HTTP 요청을 Web Thing에 보내야 MUST 합니다:

• 메서드는 GET으로 설정
• URL은 actions 리소스의 URL로 설정
• Accept 헤더는 application/json으로 설정

Web Thing이 위 형식을 따르는 HTTP 요청을 수신하면, Consumer가 접근 권한을 가진 진행 중인 모든 action 요청의 상태를 성공적으로 검색한 후, 다음과 같은 HTTP 응답을 보내야 MUST 합니다:

• 상태 코드는 200으로 설정
• Content-Type 헤더는 application/json으로 설정
• Action 이름을 키로 하는 객체를 포함하는 본문으로, 각 객체 멤버의 값은 action 요청을 나타내는 ActionStatus 객체들의 배열이며, JSON으로 직렬화됩니다.

property 값을 관찰할 때 사용할 Property 리소스의 URL은 Thing Description에서 해당 PropertyAffordance 내부의 다음 조건을 만족하는 Form을 찾아 얻어야 MUST 합니다:

• 그 op 멤버가 observeproperty 값을 포함합니다
• 해당되는 경우 base URL을 기준으로 확인된 후, 그 href 멤버 값의 URI scheme [RFC3986]이 http 또는 https입니다
• 그 subprotocol 멤버의 값이 sse입니다
• 기본값이 적용된 후, 그 contentType 멤버의 값이 application/json입니다

Web Thing의 모든 properties 변경을 관찰할 때 사용할 properties 리소스의 URL은 Thing Description에서 Thing Description의 최상위 forms 멤버 내부의 다음 조건을 만족하는 Form을 찾아 얻어야 MUST 합니다:

• 그 op 멤버가 observeallproperties 값을 포함합니다
• 해당되는 경우 base URL을 기준으로 확인된 후, 그 href 멤버 값의 URI scheme [RFC3986]이 http 또는 https입니다
• 그 subprotocol 멤버의 값이 sse입니다
• 기본값이 적용된 후, 그 contentType 멤버의 값이 application/json입니다

Event를 구독할 때 사용할 event 리소스의 URL은 Thing Description에서 해당 EventAffordance 내부의 다음 조건을 만족하는 Form을 찾아 얻어야 MUST 합니다:

• 기본값이 적용된 후, 그 op 멤버가 subscribeevent 값을 포함합니다
• 해당되는 경우 base URL을 기준으로 확인된 후, 그 href 멤버 값의 URI scheme [RFC3986]이 http 또는 https입니다
• 그 subprotocol 멤버의 값이 sse입니다
• 기본값이 적용된 후, 그 contentType 멤버의 값이 application/json입니다

Web Thing이 내보내는 모든 Events를 구독할 때 사용할 events 리소스의 URL은 Thing Description에서 Thing Description의 최상위 forms 멤버 내부의 다음 조건을 만족하는 Form을 찾아 얻어야 MUST 합니다:

• 그 op 멤버가 subscribeallevents 값을 포함합니다
• 해당되는 경우 base URL을 기준으로 확인된 후, 그 href 멤버 값의 URI scheme [RFC3986]이 http 또는 https입니다
• 그 subprotocol 멤버의 값이 sse입니다
• 기본값이 적용된 후, 그 contentType 멤버의 값이 application/json입니다

Property 값을 관찰할 때 사용할 property 리소스의 URL은 Thing Description [wot-thing-description11]에서 해당 PropertyAffordance 내부의 다음 조건을 만족하는 Form을 찾아 얻어야 MUST 합니다:

• 그 op 멤버가 observeproperty 값을 포함합니다
• 해당되는 경우 base URL을 기준으로 확인된 후, 그 href 멤버 값의 URI scheme [RFC3986]이 http 또는 https입니다
• 기본값이 적용된 후, 그 contentType 멤버의 값이 application/json입니다
• 그 subprotocol 멤버의 값이 webhook입니다

Property를 관찰하려면, Consumer는 다음과 같은 HTTP 요청을 Web Thing에 보내야 MUST 합니다:

• 메서드는 POST로 설정
• URL은 property 리소스의 URL로 설정
• Content-Type 헤더는 application/json으로 설정
• 다음 멤버를 포함하는 JSON 객체가 들어 있는 본문:
  • callbackURL 멤버는 Thing이 property 변경 알림을 Consumer에 보내는 데 사용해야 하는 callback URL로 설정됩니다.

Web Thing이 위 형식을 따르는 HTTP 요청을 수신하고 Consumer가 해당 Property를 관찰할 권한이 있으면, callback URL을 성공적으로 등록한 후 Consumer에게 다음과 같은 HTTP 응답을 보내야 MUST 합니다:

• 상태 코드는 201 Created로 설정
• Location 헤더는 개별 property 관찰 구독을 나타내는 고유 URL로 설정되며, 나중에 Consumer가 Property 관찰을 취소할 때 사용합니다.

property 관찰 구독이 등록되어 있는 동안, 관찰 중인 Property 값이 변경될 때마다, Web Thing은 관찰 중인 Consumer에게 다음과 같은 HTTP 요청을 보내야 MUST 합니다:

• 메서드는 POST로 설정
• URL은 관찰을 등록할 때 Consumer가 제공한 callback URL로 설정
• Content-Type 헤더는 application/json으로 설정
• Link 헤더는 URL을 해당 property 리소스의 URL로 설정하고, rel을 self로 설정
• Date 헤더는 user agent에 의해 property 변경 시각으로 자동 설정되며, [rfc9110]의 HTTP Date 형식을 사용합니다
• Property의 새 값을 포함하는 본문으로, JSON으로 직렬화되고 Property Affordance의 데이터 스키마를 준수합니다

Consumer가 유효한 callback URL로 위 형식을 따르는 HTTP 요청을 수신하면, Web Thing에게 다음과 같은 HTTP 응답을 보내야 MUST 합니다:

• 상태 코드는 200 OK로 설정

property의 관찰 구독을 취소하려면, Consumer는 다음과 같은 HTTP 요청을 Web Thing에 보내야 MUST 합니다:

• 메서드는 DELETE로 설정
• URL은 observeproperty 작업 중 HTTP 응답의 Location 헤더에 제공된 subscription URL로 설정

Web Thing이 위 형식을 따르는 HTTP 요청을 수신하고, 제공된 URL을 가진 property 관찰 구독이 존재하면, 구독을 성공적으로 취소한 후 Consumer에게 다음과 같은 HTTP 응답을 보내야 MUST 합니다:

• 상태 코드는 204 No Content로 설정

Web Thing의 모든 Properties 값을 관찰할 때 사용할 properties 리소스의 URL은 Thing Description [wot-thing-description11]에서 Thing Description의 최상위 forms 멤버 내부의 다음 조건을 만족하는 Form을 찾아 얻어야 MUST 합니다:

• 그 op 멤버가 observeallproperties 값을 포함합니다
• 해당되는 경우 base URL을 기준으로 확인된 후, 그 href 멤버 값의 URI scheme [RFC3986]이 http 또는 https입니다
• 기본값이 적용된 후, 그 contentType 멤버의 값이 application/json입니다
• 그 subprotocol 멤버의 값이 webhook입니다

Web Thing의 모든 Properties 변경을 관찰하려면, Consumer는 다음과 같은 HTTP 요청을 Web Thing에 보내야 MUST 합니다:

• 메서드는 POST로 설정
• URL은 properties 리소스의 URL로 설정
• Content-Type 헤더는 application/json으로 설정
• 다음 멤버를 포함하는 JSON 객체가 들어 있는 본문:
  • callbackURL 멤버는 Thing이 property 변경 알림을 Consumer에 보내는 데 사용해야 하는 callback URL로 설정됩니다.

Web Thing이 위 형식을 따르는 HTTP 요청을 수신하고 Consumer가 Thing의 Properties를 관찰할 권한이 있으면, callback URL을 성공적으로 등록한 후 Consumer에게 다음과 같은 HTTP 응답을 보내야 MUST 합니다:

• 상태 코드는 201 Created로 설정
• Location 헤더는 개별 관찰 구독을 나타내는 고유 URL로 설정되며, 나중에 Consumer가 모든 Properties의 관찰을 취소할 때 사용합니다.

properties 관찰 구독이 등록되어 있는 동안, 관찰 가능한 Property 값이 변경될 때마다, Web Thing은 관찰 중인 Consumer에게 다음과 같은 HTTP 요청을 보내야 MUST 합니다:

• 메서드는 POST로 설정
• URL은 관찰 구독을 등록할 때 Consumer가 제공한 callback URL로 설정
• Content-Type 헤더는 application/json으로 설정
• Link 헤더는 URL을 해당 PropertyAffordance의 URL로 설정하고, rel을 self로 설정
• Date 헤더는 user agent에 의해 property 변경 시각으로 자동 설정되며, [rfc9110]의 HTTP Date 형식을 사용합니다
• Property의 새 값을 포함하는 본문으로, JSON으로 직렬화되고 PropertyAffordance의 데이터 스키마를 준수합니다

Consumer가 유효한 callback URL로 위 형식을 따르는 HTTP 요청을 수신하면, Web Thing에게 다음과 같은 HTTP 응답을 보내야 MUST 합니다:

• 상태 코드는 200 OK로 설정

모든 Properties의 관찰을 취소하려면, Consumer는 다음과 같은 HTTP 요청을 Web Thing에 보내야 MUST 합니다:

• 메서드는 DELETE로 설정
• URL은 observeallproperties 작업 중 HTTP 응답의 Location 헤더에 제공된 subscription URL로 설정

Web Thing이 위 형식을 따르는 HTTP 요청을 수신하고, 제공된 URL을 가진 properties 관찰 구독이 존재하면, 관찰 구독을 성공적으로 취소한 후 Consumer에게 다음과 같은 HTTP 응답을 보내야 MUST 합니다:

• 상태 코드는 204 No Content로 설정

Event를 구독할 때 사용할 event 리소스의 URL은 Thing Description [wot-thing-description11]에서 해당 EventAffordance 내부의 다음 조건을 만족하는 Form을 찾아 얻어야 MUST 합니다:

• 그 op 멤버가 subscribeevent 값을 포함합니다
• 해당되는 경우 base URL을 기준으로 확인된 후, 그 href 멤버 값의 URI scheme [RFC3986]이 http 또는 https입니다
• 기본값이 적용된 후, 그 contentType 멤버의 값이 application/json입니다
• 그 subprotocol 멤버의 값이 webhook입니다

Event를 구독하려면, Consumer는 다음과 같은 HTTP 요청을 Web Thing에 보내야 MUST 합니다:

• 메서드는 POST로 설정
• URL은 event 리소스의 URL로 설정
• Content-Type 헤더는 application/json으로 설정
• 다음 멤버를 포함하는 JSON 객체가 들어 있는 본문:
  • callbackURL 멤버는 Thing이 event 알림을 Consumer에 보내는 데 사용해야 하는 callback URL로 설정됩니다.

Web Thing이 위 형식을 따르는 HTTP 요청을 수신하고 Consumer가 해당 Event를 구독할 권한이 있으면, callback URL을 성공적으로 등록한 후 Consumer에게 다음과 같은 HTTP 응답을 보내야 MUST 합니다:

• 상태 코드는 201 Created로 설정
• Location 헤더는 개별 event 구독을 나타내는 고유 URL로 설정되며, 나중에 Consumer가 구독을 취소할 때 사용합니다.

event 구독이 등록되어 있는 동안, 모니터링되는 Event의 인스턴스가 발생할 때마다, Web Thing은 구독한 Consumer에게 다음과 같은 HTTP 요청을 보내야 MUST 합니다:

• 메서드는 POST로 설정
• URL은 Event를 구독할 때 Consumer가 제공한 callback URL로 설정
• Content-Type 헤더는 application/json으로 설정(event에 data payload가 있는 경우에만)
• Link 헤더는 URL을 해당 event 리소스의 URL로 설정하고, rel을 self로 설정
• Date 헤더는 user agent에 의해 event 발생 시각으로 자동 설정되며, [rfc9110]의 HTTP Date 형식을 사용합니다
• event의 data payload가 있는 경우 이를 포함하는 본문으로, JSON으로 직렬화되고 EventAffordance의 데이터 스키마를 준수합니다

Consumer가 유효한 callback URL로 위 형식을 따르는 HTTP 요청을 수신하면, Web Thing에게 다음과 같은 HTTP 응답을 보내야 MUST 합니다:

• 상태 코드는 200 OK로 설정

Event 구독을 취소하려면, Consumer는 다음과 같은 HTTP 요청을 Web Thing에 보내야 MUST 합니다:

• 메서드는 DELETE로 설정
• URL은 subscribeevent 작업 중 HTTP 응답의 Location 헤더에 제공된 subscription URL로 설정

Web Thing이 위 형식을 따르는 HTTP 요청을 수신하고, 제공된 URL을 가진 event 구독이 존재하면, 구독을 성공적으로 취소한 후 Consumer에게 다음과 같은 HTTP 응답을 보내야 MUST 합니다:

• 상태 코드는 204 No Content로 설정

Web Thing의 모든 Events를 구독할 때 사용할 events 리소스의 URL은 Thing Description [wot-thing-description11]에서 Thing Description의 최상위 forms 멤버 내부의 다음 조건을 만족하는 Form을 찾아 얻어야 MUST 합니다:

• 그 op 멤버가 subscribeallevents 값을 포함합니다
• 해당되는 경우 base URL을 기준으로 확인된 후, 그 href 멤버 값의 URI scheme [RFC3986]이 http 또는 https입니다
• 기본값이 적용된 후, 그 contentType 멤버의 값이 application/json입니다
• 그 subprotocol 멤버의 값이 webhook입니다

Web Thing의 모든 Events를 구독하려면, Consumer는 다음과 같은 HTTP 요청을 Web Thing에 보내야 MUST 합니다:

• 메서드는 POST로 설정
• URL은 events 리소스의 URL로 설정
• Content-Type 헤더는 application/json으로 설정
• 다음 멤버를 포함하는 JSON 객체가 들어 있는 본문:
  • callbackURL 멤버는 Thing이 event 알림을 Consumer에 보내는 데 사용해야 하는 callback URL로 설정됩니다.

Web Thing이 위 형식을 따르는 HTTP 요청을 수신하고 Consumer가 Thing의 Events를 구독할 권한이 있으면, callback URL을 성공적으로 등록한 후 Consumer에게 다음과 같은 HTTP 응답을 보내야 MUST 합니다:

• 상태 코드는 201 Created로 설정
• Location 헤더는 개별 event 구독을 나타내는 고유 URL로 설정되며, 나중에 Consumer가 구독을 취소할 때 사용합니다.

events 구독이 등록되어 있는 동안, event가 발생할 때마다 Web Thing은 구독한 Consumer에게 다음과 같은 HTTP 요청을 보내야 MUST 합니다:

• 메서드는 POST로 설정
• URL은 구독을 등록할 때 Consumer가 제공한 callback URL로 설정
• Content-Type 헤더는 application/json으로 설정(event에 data payload가 포함된 경우에만)
• Link 헤더는 URL을 해당 event 리소스의 URL로 설정하고, rel을 self로 설정
• Date 헤더는 user agent에 의해 event 발생 시각으로 자동 설정되며, [rfc9110]의 HTTP Date 형식을 사용합니다
• event data payload가 있는 경우 이를 포함하는 본문으로, JSON으로 직렬화되고 EventAffordance의 데이터 스키마를 준수합니다

Consumer가 유효한 callback URL로 위 형식을 따르는 HTTP 요청을 수신하면, Web Thing에게 다음과 같은 HTTP 응답을 보내야 MUST 합니다:

• 상태 코드는 200 OK로 설정

모든 Events에 대한 구독을 취소하려면, Consumer는 다음과 같은 HTTP 요청을 Web Thing에 보내야 MUST 합니다:

• 메서드는 DELETE로 설정
• URL은 subscribeallevents 작업 중 HTTP 응답의 Location 헤더에 제공된 subscription URL로 설정

Web Thing이 위 형식을 따르는 HTTP 요청을 수신하고, 제공된 URL을 가진 events 구독이 존재하면, events 구독을 성공적으로 취소한 후 Consumer에게 다음과 같은 HTTP 응답을 보내야 MUST 합니다:

• 상태 코드는 204 No Content로 설정