RESTful 서비스의 사용자 지정 동작

Question

잠시 동안 RESTful 서비스에 대한 기사를 읽었으며 리소스에 대해 VERBS를 사용하는 것이 중요하다는 것을 알고 있습니다.

그러나 내가 이해하지 못한 한 가지가 있습니다. CRUD의 일부가 아닌 특정 액션을 호출해야한다면 어떻게 될까요?

예를 들어, 나는 점프를하고 싶다고 생각해. 어떤 형식을 사용해야합니까?

다음 중 RESTful입니까?

http://host/cats/123/jump 

Answer 1

cats/123은 자원이 다음에 대해 이런 식으로 생각 나타내는 경우 : 해당 자원이 많은 상태를 가질 수 있습니다 (소변, 산책 이 점프, 수면, 식사, ...). REST 아키텍처 스타일을 사용하여 API를 디자인 할 때, 클라이언트 응용 프로그램이 상태를 변경할 수있는 자원에 대한 허용 가능한 요청을 허용 할 수 있습니다.

cats/123의 컨텍스트에서 자원 상태가 변경되는 일련의 POST 요청을 통해이를 수행 할 수 있습니다. REST에서 하이퍼 미디어 기능을 이용하면 아래와 같은 요청 및 응답과 같은 프로세스를 생성 할 수 있습니다. 허용 링크는 POST에 대한 응답으로 변경됩니다. 또한 클라이언트 응용 프로그램은 Href 속성에 포함 된 실제 URI가 아니라 Links 배열에 포함 된 속성을 코딩합니다.

요청 :

GET cats/123 

응답 :

{ 
    "Color" : "black", 
    "Age" : "2", 
    "Links":[ 
    { 
     "Food":"kibbles", 
     "Method":"POST", 
     "Href":"http://cats/123", 
     "Title":"Feed the cat" 
    }, 
    { 
     "Scare":"yell real loud", 
     "Method":"POST", 
     "Href":"http://cats/123", 
     "Title":"Scare the cat" 
    }] 
} 

요청 :

POST cats/123 

{ 
    "Food":"kibbles" 
} 

응답 :

{ 
    "Color" : "black", 
    "Age" : "2", 
    "Tummy" : "full" 
    "Links":[ 
    { 
     "Sleep":"lap", 
     "Method":"POST", 
     "Href":"http://cats/123", 
     "Title":"Pet the cat" 
    }, 
    { 
     "Scare":"yell real loud", 
     "Method":"POST", 
     "Href":"http://cats/123", 
     "Title":"Scare the cat" 
    }] 
}