HTTP PATCH 메소드는 리소스의 부분적인 수정을 할 때에 사용됩니다.

HTTPPUT 메소드는 문서 전체의 완전한 교체만을 허용합니다. 반면PATCH 메소드는PUT 메소드와 달리 멱등성을 가지지 않는데, 이는 동일한 patch 요청이 다른 결과를 야기할 수도 있음을 뜻합니다. 하지만 PATCH를 PUT과 같은 방식으로 사용함으로써 멱등성을 가지게 할 수도 있습니다.

PATCH (혹은PUT)는 다른 리소스에게 부수효과(side-effects)를 일으킬 가능성이 있습니다.

서버가PATCH를 지원하는지 알 수 있게끔 하기 위해, 서버는Allow 리스트 혹은Access-Control-Allow-Methods (for CORS) 응답 헤더를 통해 이를 명시할 수 있습니다.

PATCH가 허용되는지 확인할 수 있는 또 다른 (암묵적인)지표로Accept-Patch의 존재 유무를 들 수 있는데, 이를 통해 patch 문서 양식이 서버에 받아 들여졌음을 알 수 있습니다.

Syntax

PATCH /file.txt HTTP/1.1

Example

Request

PATCH /file.txt HTTP/1.1Host: www.example.comContent-Type: application/exampleIf-Match: "e0023aa4e"Content-Length: 100[description of changes]

Response

성공적인 응답은 2xx 상태 코드를 통해서 확인할 수 있습니다.

아래의 예시에서는204 응답이 사용되었는데, 이는 응답이 유의미한 body를 전달하고 있지 않기 때문입니다. {HTTPStatus("200")}} 응답에서는 body에 유의미한 데이터가 포함되어 있음을 유추할 수 있습니다.

HTTP/1.1 204 No ContentContent-Location: /file.txtETag: "e0023aa4f"

명세서

See also

• 204
• Allow,Access-Control-Allow-Methods
• Accept-Patch – specifies the patch document formats accepted by the server.