휴식을 작동하는 방법

일반적으로 말해서, 휴식 요청이가 필요로 요청을 보내기에 특별 구매 (유사한을 무엇을 할 수있습니다으로 양식을 작성 후 표시를 사용하여 얻을 방법), 다음을받는 경우 문서가 들어있는 서버의 응답입니다. 가 응답은 다음을 구문 분석을하여 원하는 정보를 추출하여 행동하는 즉시합니다.

각각의 휴식을 요청 일반적으로이 여러 개의 공통 요소 :

• 종점 구매 -에 전체 주소를 원하는 스크립트가있습니다. 휴식 서비스를했을가 능성이있는 단지 하나의 스크립트를 처리하는 모든 요청 형식, 혹은 다른 스크립트에 대한 서로 다른 요청 유형입니다.

• 개발자가 id - 대부분의 나머지 서비스를 필요로 일종의 개발자가 id하거나 키를 눌러 각 요청과 함께 전송됩니다. 이 식별의 근원을 요청하고는 일반적에 대한 추적을 목적으로 사용됩니다. 일부 서비스는 검색어의 수를 제한이 값을 사용하여 주어진 기간 동안 실행됩니다.

• 원하는 작업 - 몇 서버에는 고유의 끝점에 대한 모든가능한를 요청합니다. 따라서, 그것은 일반적으로 필수를 포함하여 원하는 작업의 요청을합니다.

• 매개 변수 - 여러 매개 변수는 요청과 함께 포함시킬 필요가있다는 요청한 조치와 함께 제공하기 위해 일부 문맥 (예를 들어, 원하는 작업이 될 수가 검색; 매개 변수가 될 수 한 종류, 그리고의 키워드 값의 도서와 스타일)입니다.

이러한 요소를 염두에두고, 이론적 요청을 만들 수있습니다 :

여기에 요청이 보내 http://library.example.com/api.php을 종점으로 개발자가 키의 123입니다. 에서 원하는 작업은 검색 및 유형 및 키워드가 매개 변수가 포함되어있는 값의 도서와 스타일입니다. 주어진 것을 요청에 대한 응답은과 같이 표시됩니다 :

<? xml 버전 = "1.0"인코딩 = "utf - 8"? >
<libraryapi xmlns = "http://library.example.com/api/spec">
<요청>
<requestid> 123a456 </ requestid>
<매개 변수>
<인수 이름 = "devkey"값 = "123"/>
<인수 이름 = "작업"값 = "검색"/>
<인수 이름 = "유형"값 = "도서"/>

<인수 이름 = "키워드"값 = "스타일"/>
</ 매개 변수>
</ 요청>
<답변>
<resultcount>이 </ resultcount>
<항목>
<제목> 스타일의 책은 제 1 권 </ 제목>
<현황> 명 </ 상태>
<보류> 3 </ 보류>
<copiesonhand>이 </ copiesonhand>
<저자> jon doe </ 저자>
</ 항목>
<항목>
<제목> 스타일의 도서 권이 </ 제목>
<현황>에서 </ 상태>
<보류> 0 </ 보류>
<copiesonhand> 1 </ copiesonhand>
<저자> jon doe </ 저자>
</ 항목>
</ 응답>
</ libraryapi>

는 것을 알 수있습니다 반응이 여러 개의 구조적인 요소입니다. 먼저,이 선언 자체가 xml 1.0 및 사용 utf - 8에 대한 인코딩을합니다. 가 libraryapi 요소는이 문서의 루트 요소는 지정된 네임 스페이스를 포함하고있습니다. 두 번째로,이 요청 절; 그것은 일반적인 예를 휴식을 요청하는 모든 정보를 포함하려면이 요청에 응답과 함께 전송됩니다. 이 추가 명확하고 간편한 프로그래밍에 요청자의 최종 수있습니다. 여기에서 볼 수있습니다 각각의 4 개 요소로 전달되는 서비스가있습니다.

마지막으로, 검색을 좀 마무리를하면이 경우에 대한 응답이 반환되는 것을 확인할 일부 메타 데이터에 대한 결과를 그림과 resultcount 태그를 포함하여 결과를 항목 자체입니다. 이 요청에 대한 각각의 도서는 볼 수있습니다 캡슐 내에서 항목 요소를 설명하는 다섯 자녀가있는 도서의 구체적인 특성입니다.