curl --request POST \
--url https://api.olostep.com/v1/maps \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"url": "https://docs.olostep.com"
}
'{
"id": "map_abc123",
"urls_count": 22,
"urls": [
"https://docs.olostep.com/api-reference/batches/create",
"https://docs.olostep.com/api-reference/batches/info",
"https://docs.olostep.com/api-reference/batches/items"
]
}创建地图
此端点允许用户获取某个网站上的所有网址。对于复杂的网站，可能需要长达 120 秒。对于大型网站，结果使用基于游标的分页进行分页。
curl --request POST \
--url https://api.olostep.com/v1/maps \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"url": "https://docs.olostep.com"
}
'{
"id": "map_abc123",
"urls_count": 22,
"urls": [
"https://docs.olostep.com/api-reference/batches/create",
"https://docs.olostep.com/api-reference/batches/info",
"https://docs.olostep.com/api-reference/batches/items"
]
}storage.expires_in 以使此地图的存储文件保留时间超过默认的 7 天。可选值：7d、10d、30d、60d、90d、180d、365d 或 never。详情请参见存储。授权
Bearer认证头格式为Bearer ，其中是你的认证令牌。
请求体
你想要获取链接的网站的 URL
控制此地图的存储文件（其结果和发现期间抓取的页面）保留多长时间。如果省略，则保留 7 天。实际生效的值在响应中以 storage.expires_in 返回。请参阅功能文档中的存储部分。无效值返回 400，代码为 invalid_storage_expires_in。
Show child attributes
Show child attributes
可选的搜索查询，以按搜索相关性对链接进行排序。
可选的数字，仅限于搜索查询的前 n 个链接。
包含给定 URL 的子域。默认值为 true。
使用 glob 语法包含的 URL 路径模式。例如：/blog/** 仅包含博客 URL。只有匹配这些模式的 URL 才会被返回。
使用 glob 语法排除的 URL 路径模式。例如：/careers/**。排除的 URL 将优先于包含的 URL。
可选：来自上一个响应的分页游标。如果提供，将返回从上一个请求因响应大小限制而中断的地方开始的下一组URL。
响应
成功响应，页面上找到的URL
当前响应中的 URL 数量
页面上找到的 URL 数组
应用于此地图存储文件的保留策略。
Show child attributes
Show child attributes
此地图的唯一标识符
分页游标，用于检索因10MB大小限制而受限的下一组URL。如果为null或不存在，则表示所有URL已被检索。
此请求消耗的积分数量。在执行完成后填充。积分是计费的真实来源。
此请求的估计成本（以美元计）。在执行完成后填充。根据消耗的积分和你的计划费率计算——99% 准确，但 credits_consumed 是权威值。
此页面对您有帮助吗？