用例-动词-添加

背景

客户端请求将资源添加到服务器通常很方便。在下面的示例中，系统请求为给定员工添加考勤卡名词。

请求

POST https://application.domain.com/api/v1/employees/123/timecards

头：

Accept:application/vnd.hropen.timecard.v4+json
Accept-Encoding:gzip, deflate, sdch
Accept-Language:en-US,en;q=0.8
Cache-Control:no-cache
Connection:keep-alive
Content-Type:application/vnd.hropen.timecard.v4+json; profile=“http://hropenstandards.org/schema/timecard#”
Host:application.domain.com
Pragma:no-cache
Referer:https://application.domain.com
User-Agent:Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/44.0.2403.157 Safari/537.36
X-Auth-Token:
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJzdWJqZWN0IG9mIHRoZSB0b2tlbiIsIm5hbWUiOiJIUk9TIFVzZXIiLCJhdWQiOiJhdWRpZW5jZSBvZiB0aGUgdG9rZW4iLCJhZG1pbiI6dHJ1ZSwiaWQiOiJHVUlEIiwicmVsZWFzZUlkIjoiNF8xIiwidmVyc2lvbklkIjoiQm9kIHZlcnNpb24gdXNlZCAtIE5vdCBOZWVkZWQiLCJzY2VuYXJpb0lkIjoicHJvY2VzcyB0aGF0IGtpY2tlZCBvZmYgdGhpcyB0b2tlbiByZXF1ZXN0IiwiY29ycmVsYXRpb25JZCI6ImNvb3JlbGF0ZXMgdG8gc29tZSBvdGhlciBwcm9jZXNzIiwic3lzdGVtRW52aXJvbm1lbnQiOiJjYW4gZGV0ZXJtaW5lIHRlc3QgdnMgcHJvZCIsImlhdCI6InJlcGxhY2VzIG5lZWQgZm9yIGNyZWF0aW9uIERhdGUgVGltZSJ9.6VMsukuCFsi1h6S6lkKgNQwCrBsa0TzBlu07loHzFxE
X-Application:Receiving Application
X-...: Other BOD Item

身体：

名词

响应

头：

Cache-Control:no-cache
Content-Length:784
Content-Type:application/vnd.hropen.timecard.v4+json; profile=“http://hropenstandards.org/schema/timecard#”
Date:Thu, 03 Sep 2015 13:35:59 GMT
Expires:-1
Location: "https://application.domain.com/api/v1/employees/123/timecards"
Pragma:no-cache
Server:Microsoft-IIS/7.5
X-Application:Receiving Application
X-...: Other BOD Item

状态代码

HTTP/1.1 201 Created

身体：

没有

注意：

以前使用的 BOD 属性可以通过请求/响应消息中的标头发送，也可以在身份验证期间作为请求有效负载中的私有声明发送。