질의 매개변수

일부 요청은 반환된 데이터를 수정하거나 개선할 선택적 질의 매개변수를 사용합니다. 자세한 내용은 각 리소스에 대한 설명서를 참조하십시오. 모든 리소스에서 모든 질의 매개변수를 지원하는 것은 아닙니다. 이 절에서는 리소스가 지정된 질의 매개변수를 구현할 때 사용될 일반 질의 매개변수에 대해서만 설명합니다.

표 2  일반 질의 매개변수

매개변수 설명 props=true 리소스에 대한 등록 정보 메타데이터를 나열합니다(기본값: false). limit=n 반환된 목록 요소 수를 제한합니다. start=n 반환된 요소 데이터를 시작하는 데 사용된 인덱스 번호 또는 시간입니다.

질의 매개변수: props

props 질의 매개변수는 단일 리소스 인스턴스를 반환하는 여러 GET 명령에 사용할 수 있습니다. 등록 정보 메타데이터 목록이 포함된 'props' 데이터 요소를 반환합니다.

표 3  등록 정보 메타데이터 값

등록 정보 설명 name 등록 정보 이름 label 등록 정보의 설명 immutable 등록 정보를 수정할 수 없음을 나타내는 플래그입니다. type 등록 정보 유형: String, Integer, Boolean... choices 열거된 등록 정보의 경우 사용 가능한 값 배열

질의 매개변수: limit

limit 질의는 많은 수의 요소를 반환할 수 있는 여러 GET 명령에 사용하여 반환될 최대 요소 수를 제한할 수 있습니다.

질의 매개변수: start

start 질의 매개변수는 limit 매개변수를 지원하는 동일한 명령에서 지원됩니다. 이는 반환된 데이터를 시작하는 데 사용되는 시작 인덱스를 제공합니다. 시간 값을 지원하는 리소스에 대해 인덱스는 "20130531T01:13:58"과 같은 시간 값일 수 있습니다.