用例-动词-更新

背景

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

身体:

没有