하이퍼 미디어 (HATEOAS)의 이점은 무엇입니까?

프로그램에서 사용하려는 API에 대한 HATEOAS의 이점을 이해하지 못합니다 (사람이 직접 API를 탐색하는 것과는 반대). 물론 고객은 URL 스키마에 바인딩되어 있지 않지만 내 마음에 같은 데이터 스키마에 바인딩되어 있습니다.

예를 들어 주문에서 항목을보고 싶다고 가정하고 이미 주문 URL을 발견했거나 알고 있다고 가정 해 봅시다.

증오 :

order = get(orderURL);
item = get(order.itemURL[5]);

비 증오심 :

order = get(orderURL);
item = get(getItemURL(order,5));

첫 번째 모델에서는 주문 객체에 itemURL 필드가 있다는 사실을 알아야합니다. 두 번째 모델에서는 아이템 URL을 구성하는 방법을 알아야합니다. 두 경우 모두 사전에 무언가를 "알아야"HATEOAS가 실제로 무엇을하고 있습니까?

한 가지 차이점은 스키마가 표준이되거나 최소한 다른 사람들이 재사용 할 수 있다는 것입니다.

예를 들어 Twitter API를 사용 중이고 StatusNet도 지원한다고 가정합니다 (또는 대신). Twitter와 동일한 데이터 모델을 사용하므로 API가 HATEOAS를 따르는 경우 이제 기본 URL 만 변경하면됩니다. 그렇지 않은 경우 이제 코드에서 각 단일 URL 을 변경 해야합니다.

물론 서비스의 진입 점 URL을 넣도록 코드를 변경해야하는 경우에는 그렇게 도움이되지 않을 수 있습니다. URL이 동적으로 삽입되면 정말 빛납니다. 예를 들어, Twillio와 같은 서비스를 구축하는 경우 사용자 고유의 API와 상호 작용합니다.

1. 탐색 가능한 API : 사소한 것처럼 들리지만 탐색 가능한 API의 성능을 과소 평가하지는 않습니다. 데이터를 탐색 할 수있는 기능을 통해 클라이언트 개발자는 API 및 해당 데이터 구조의 정신 모델을보다 쉽게 ​​구축 할 수 있습니다.

2. 인라인 문서 : URL을 링크 관계로 사용하면 클라이언트 개발자가 문서를 가리킬 수 있습니다.

3. 간단한 클라이언트 로직 : URL을 구성하는 대신 단순히 URL을 따르는 클라이언트는 구현 및 유지 관리가 쉬워야합니다.

4. 서버는 URL 구조의 소유권을 갖습니다. 하이퍼 미디어를 사용하면 서버에서 사용하는 URL 구조에 대한 클라이언트의 하드 코딩 된 지식이 제거됩니다.

5. 다른 서비스로 컨텐츠로드 오프로드 : 컨텐츠를 다른 서버 (예 : CDN)로 오프로드 할 때 Hypermedia가 필요합니다.

6. 링크를 사용한 버전 관리 : Hypermedia는 API 버전 관리를 도와줍니다.

7. 동일한 서비스의 여러 구현 : 하이퍼 미디어는 동일한 서비스의 여러 구현이 존재할 때 필요합니다 (한 클라이언트가 둘 이상의 액세스해야 함).

이 글 머리 기호에 대한 자세한 설명은 여기 ( http://soabits.blogspot.no/2013/12/selling-benefits-of-hypermedia.html) 에서 찾을 수 있습니다 .