비즈니스 항목 서비스 가이드

이전 다음

표준 쿼리 매개 변수

비즈니스 항목 서비스 REST API는 표준 쿼리 매개 변수를 사용하여 결과 필터링, 페이지 지정 및 확장을 수행합니다.

물음표(?)를사용하여 쿼리 매개 변수를 다른 매개 변수와 구분하십시오. 쿼리 매개 변수는 등호 기호로 구분된 키-값 쌍입니다. 앰퍼샌드(&)를 사용하여 쿼리 매개 변수의 시퀀스를 구분하십시오.

다음 REST 요청 URL은 쿼리 매개 변수를 사용하는 방법을 보여 줍니다.

/Person/123/Phone/SFA:456/PhoneUse?recordsToReturn=100&recordStates=ACTIVE,PENDING

다음 표준 쿼리 매개 변수를 사용하십시오.

매개 변수	설명
recordsToReturn	반환할 행 수를 지정합니다. 기본값은 10입니다.
firstRecord	결과의 첫 번째 행을 지정합니다. 기본값은 1입니다. 추가 페이지를 읽기 위해 후속 호출에서 사용됩니다.
searchToken	이전 요청과 함께 반환되는 검색 토큰을 지정합니다. 검색 토큰을 사용하여 검색 결과의 후속 페이지를 가져올 수 있습니다. 예를 들어 다음 쿼리는 첫 번째 페이지를 나열합니다. /Person/123/Phone 다음 쿼리는 두 번째 페이지를 반환합니다. /Person/123/Phone?searchToken=SVR1.AZAM5&firstRecord=10
returnTotal	true로 설정된 경우 결과의 레코드 수가 반환됩니다. 기본값은 false입니다.
depth	결과에 포함시킬 하위 수준 수를 지정합니다.

피드백 보내기