API를 통해 업데이트, 삭제 및 실행
 |
이 항목의 예에서는 웹 개발 환경 또는 응용 프로그램에서 HTTP POSTS 실행에 대해 잘 알고 있다고 가정합니다.
|
다음 규칙은 수행되는 요청의 유형에 따라 필요한 사항을 이해하는 데 도움이 됩니다.
|
설명
|
샘플 URL
|
HTTP 작업
|
콘텐츠 유형
|
|||
|---|---|---|---|---|---|---|
|
UPDATE
|
업데이트도 엔티티 부분을 지정해야 합니다.
|
http://host/Thingworx/Things/thing_name
|
PUT
|
application/json 또는 text/xml
|
||
|
DELETE
|
삭제도 엔티티 부분을 지정해야 합니다.
|
http://host/Thingworx/Things/thing_name
|
DELETE
|
해당 없음
|
||
|
INVOKING SERVICES
|
서비스 호출에 특정 특성을 비롯한 전체 URL을 지정해야 합니다.
|
http://host/Thingworx/Things/MyThing/Services/myService
|
POST
|
application/json
|
HTTP 요청 실행
HTTP 요청을 실행할 때 UTF-8 인코딩을 사용하고, 필요한 경우 선택 사항인 포트 값을 지정하십시오.
 |
생산 중 또는 네트워크 무결성이 의심스러운 경우에는 HTTPS를 사용하는 것이 좋습니다.
|
HTTP 응답 코드 처리
대부분의 경우 콘텐츠 또는 상태 코드 200이 반환될 것으로 예상되며, 이는 정상입니다. 오류가 있는 경우 오류 메시지가 수신됩니다.
HTTP 콘텐츠 작업
HTTP 콘텐츠(JSON, XML, HTML(응답 전용))를 전송하거나 수신하는 경우 전송하는 HTTP 콘텐츠에 따라 요청 콘텐츠 유형 머리글을 적절한 값으로 설정하십시오.
|
메소드
|
|
|---|---|
|
GET
|
값을 읽어들입니다.
|
|
PUT
|
값을 쓰거나 새 사물 또는 속성을 생성합니다.
|
|
POST
|
서비스를 실행합니다.
|
|
DELETE
|
사물 또는 속성을 삭제합니다.
|
|
수락 머리글 값
|
|
|---|---|
|
JSON
|
application/json
|
|
XML
|
text/xml
|
|
HTML
|
text/html(또는 수락 머리글 생략)
|
|
CSV
|
text/csv
|
|
콘텐츠 유형 머리글 값
|
|
|---|---|
|
JSON
|
application/json
|
|
XML
|
text/xml
|
메타데이터
웹 브라우저에서 NameoftheThing/Metadata URL로 이동하여 작성한 특정 사물, 사물 템플릿 또는 형태의 메타데이터를 표시할 수 있습니다.
|
|
이 정보를 보려면 JSON으로 표시되어야 합니다.
|
REST API 호출로 인증 전달
가장 권장되는 방법은 응용 프로그램 키를 사용하는 것입니다. ThingWorx에서 응용 프로그램 키를 생성한 다음 HTTP 머리글 형태의 REST 호출로 전달할 수 있습니다.
머리글 값을 연결하려는 ThingWorx 인스턴스에 유효한 응용 프로그램 키로 대체합니다.
|
머리글 키
|
머리글 값 예
|
|---|---|
|
appKey
|
1x9256cf-9fe9-434e-adbe-9772c0c40261
|
ThingWorx REST API는 두 가지 인증 방법을 지원합니다.
• 기본 인증을 사용하면 사용자와 암호를 사용하여 인증할 수 있습니다.
• 응용 프로그램 키를 URL 매개 변수로 전달합니다. 이 방법은 보안상의 이유로 인해 권장되지 않으며 향후에는 사용되지 않습니다.
관련 링크