请求
表格内容类型(W3C)
默认情况下 Apiato 配置为的编码是简单的 text/ASCII 数据 x-www-form-urlencoded
.。当然 ,你也能修改他的类型。
ASCII 格式
你要告诉服务器你提交的数据是简单的 text/ASCII 格式(name=Mahmoud+Zalt&age=18
)的话 ,你需要在你的请求头内设置 Content-Type : x-www-form-urlencoded
。
JSON 格式
你要告诉服务器你提交的数据是JSON 格式({name : 'Mahmoud Zalt', age: 18})的话 。你需要在你的请求头内设置 Content-Type = application/json
。
(你可能希望在案例中返回json数据格式,你可以修改响应序列器 DataArraySerializer
为 JsonApiSerializer
,更多的信息请看响应的介绍)
HTTP 请求头
头 | 样例值 | 什么时候发送 |
---|---|---|
Accept | application/json |
在每个请求中发送 |
Content-Type | application/x-www-form-urlencoded |
传递数据时必须发送。 |
Authorization | Bearer {Access-Token-Here} |
必须在请求需要时发送(经过身份验证的用户) |
If-None-Match | 811b22676b6a4a0489c920073c0df914 |
可以发送以指示对此端点的先前请求的特定ETag。如果两个ETag匹配(即,相同),则返回HTTP 304(未修改)。 |
注意
通常情况下,你应该在调用JSON API 时HTTP头必须设置成为Accept : application/json
。然而,在 Apiato 中你可以强制用户发送,也可以不需要用户强制发送,这样取决于你在app/Ship/Configs/apiato.php
设置的'force-accept-header' => true,
这个参数 true 需要强制发送 false 不需要。
调用节点
请求未保护的节点
curl -X POST -H "Accept: application/json" -H "Content-Type: application/x-www-form-urlencoded; -F "email=admin@admin.com" -F "password=admin" -F "=" "http://api.domain.develop/v2/register"
请求受保护的节点
curl -X GET -H "Accept: application/json" -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..." -H "http://api.domain.develop/v1/users"
推荐文章: