请求

发起请求

主机

Web API v1 请求的主机始终为 https://api.iafcertsearch.org/api/client/v1

所有请求必须使用 HTTPS。API 不支持 HTTP。

授权头

您必须提供一个如 Authentication 中所述的授权头。

HTTP 动词

  • GET 检索资源或一组资源

  • POST 创建新资源

  • PUT 更新现有资源

  • DELETE 删除现有资源

  • OPTIONS 查看针对特定资源的允许动词

接受头

API 提供 JSON 响应。目前不需要接受头,但将来可能需要。如果未设置,API 将使用 application/json

GET https://api.iafcertsearch.org/api/client/v1/endpoint HTTP/1.1
Accept: application/json

数据数组

当您在 GET 请求中发送一个数据数组时,您需要在 URL 上多次包含该参数。参数名称不需要括号。

GET https://api.iafcertsearch.org/api/client/v1/endpoint?parameter=data1&parameter=data2 HTTP/1.1

格式化请求

请求主体

通过 POSTPUT 向资源提交数据时,必须使用 JSON 提交有效负载。

POST https://api.iafcertsearch.org/api/client/v1/example/ HTTP/1.1
Content-Type: application/json
{
  "name": "new example name"
}

分页

某些 GET 资源允许以批处理的方式检索信息。适用时,我们将在资源文档中提供查询参数。

当请求多个项目时,我们将默认请求限制为 20 个项目。您可以使用 limit 参数指定不同的限制。我们接受 limit 参数的最大值为 100

下面是一个API请求的示例,该示例根据 limit=100offset=0 参数检索了前 100 条记录。

要检索下一批记录,请将偏移参数增加 1

GET https://api.iafcertsearch.org/api/client/v1/resource?limit=100&offset=0 HTTP/1.1

成功的请求

动词

返回的资源对象

GET

返回单个资源对象或一组资源对象

PATCH

返回更新后的资源对象

PUT

返回更新后的资源对象

DELETE

不返回任何内容

POST

返回新创建的资源对象

Last updated