# RID
/rids
端点旨在为客户端提供存储区域中的大量 RID(请求 ID)列表。该API支持通过滚动机制进行分页,从而实现大型数据集的高效数据检索。
# 参数
唯一需要的参数是 token
。请参阅下面用于高效 RID 拉取的附加参数:
limit
(可选):指定要返回的 RID 的最大数量。默认为 1k,最大允许值为 10k。使用此参数来控制返回数据的大小。scroll_id
(可选):来自先前请求响应的标识符,用于获取下一组 RID。该参数用于分页。scroll_order
(可选):确定返回的 RID 的顺序。可接受的值为asc
(升序)或desc
(降序)。默认顺序是desc
.
# 请求
要检索最新 100 个 RID:
curl 'https://api.crawlbase.com/storage/rids?token=_USER_TOKEN_&limit=100'
# 响应
成功的响应将返回一组 RID,以及 scroll_id
对于分页:
{
"rids": ["RID1", "RID2", ...],
"scroll_id": "dXVlcnlUaGVuRmV0Y2g7NTs1NDpDV..."
}
rids
:包含所请求的 RID 的数组。scroll_id
:用于检索下一组结果的令牌。该值对于分页至关重要,当更多数据超出当前请求的限制时提供。
#
为了有效利用 /rids
API请注意以下事项:
limit
参数上限为 10k,可确保最佳的服务器性能和资源管理。分页通过scroll_id
建议用于访问大型数据集。滚动会话在不活动一分钟后到期。要继续检索数据或更改检索顺序,请发起新的请求,而不需要
scroll_id
.