9. 指示截断的响应 (Indicating Truncated Responses)
在需要限制响应数据或需要省略部分数据的情况下,响应被视为"截断"。截断的响应仍然是有效的 JSON,但搜索集中的某些结果或对象中的某些数据不由服务器提供。服务器可以通过在响应对象中包含类型化通知来指示这一点。
以下是已截断的搜索响应的省略示例。
{
"rdapConformance" :
[
"rdap_level_0"
],
"notices" :
[
{
"title" : "Search Policy",
"type" : "result set truncated due to authorization",
"description" :
[
"Search results are limited to 25 per day per querying IP."
],
"links" :
[
{
"value" : "https://example.net/help",
"rel" : "alternate",
"type" : "text/html",
"href" : "https://www.example.com/search_policy.html"
}
]
}
],
"domainSearchResults" :
[
...
]
}
图 32
类似的技术可以与类型化备注一起使用,其中返回单个对象并且该对象中的数据已被截断。这样的示例可能是仅包含与其关联的 IP 网络的部分集合的实体对象。