背景
PATCH 谓词用于请求消息,以请求服务器更新指定 URI 标识的资源。更新是部分更新或增量更新;在部分更新中,仅传达要更改的资源(资源)的属性。PATCH 消息可被视为实现命令消息模式。
下面的示例演示了对正时卡名词实例(即资源)的部分更新的请求和响应,该实例传达了付薪率的变化(更新值为 17.00 USD)。
请求
方法和 URI
PATCH https://application.domain.com/api/v1/employees/{employeeId}/timecards/{timecardId}
头
Accept:application/vnd.hropen.timecard.v4+json
Host: application.domain.com
Referer: https://application.domain.com/api/v1/employees/{employeeID}/timecards
Content-Type:application/vnd.hropen.timecard.v4+json; profile=“http://hropenstandards.org/schema/timecard#”
User-Agent: Chrome/44.0.2403.157
身体
考勤卡实例
{
"document": {
"id": {
"value": "113d6fb7-f2a2-42ea-bdc1-8ba63eba9061"
}
},
"person": {
"id": {
"value": "750111"
},
"name": {
"given": "John",
"family": "Doe"
}
},
"period": {
"start": "2014-07-21",
"end": "2014-07-27"
},
"payRates": [
{
"code": "P1",
"name": "Press 1",
"amount": {
"value": 17.00,
"currency": "USD"
}
}
]
}
响应:
头
Date: Fri, 04 Sep 2015 12:24:28 GMT
状态代码
HTTP/1.1 200 OK
身体:
没有