> ## Documentation Index > Fetch the complete documentation index at: https://aisa.one/docs/llms.txt > Use this file to discover all available pages before exploring further. # OnPage API 瀑布图 > 此端点旨在提供页面速度分析信息。 ## OpenAPI ````yaml openapi/zh/dataforseo.json POST /dataforseo/on_page/waterfall openapi: 3.0.3 info: title: DataForSEO API version: 1.0.0 description: 通过 AIsa 统一网关提供的 DataForSEO API 端点。 servers: - url: https://api.aisa.one/apis/v1 security: - BearerAuth: [] paths: /dataforseo/on_page/waterfall: post: summary: OnPage API 瀑布图 description: 此端点用于提供页面速度分析。使用此功能，可以获取有关页面加载时间、建立安全连接所需时间、加载页面资源所需时间等详细信息。 operationId: post_dataforseo_on_page_waterfall requestBody: required: true content: application/json: schema: type: object properties: id: type: string description: >- 任务 ID，必填字段；您可以从 Task POST 端点的响应中获取此 ID。示例：“07131248-1535-0216-1000-17384017ad04” url: type: string description: 页面 URL 必填字段，用于指定要接收计时数据的页面 tag: type: string description: >- 用户定义的任务标识符。可选字段。字符数限制为 255。您可以使用此参数标识任务并将其与结果匹配；您将在响应的 data 对象中找到指定的 tag 值 required: - id - url responses: '200': description: 成功响应 content: application/json: schema: type: object properties: version: type: string description: API 的当前版本 status_code: type: integer description: 通用状态码；您可以在此处查看完整的响应码列表。注意：我们强烈建议设计必要的系统来处理相关异常或错误情况 status_message: type: string description: 常规信息消息；可在此处查看常规信息消息的完整列表 time: type: string description: 执行时间（秒） cost: type: number description: 任务总成本（美元） tasks_count: type: integer description: tasks 数组中的任务数量 tasks_error: type: integer description: 返回错误的 tasks 数组中的任务数量 tasks: type: array items: type: string description: 任务数组 tasks.id: type: string description: 任务标识符，系统中采用 UUID 格式的唯一任务标识符 tasks.status_code: type: integer description: DataForSEO 生成的任务状态码；范围为：10000-60000；完整响应代码列表可在此处查看 tasks.status_message: type: string description: 任务的信息性消息，你可以在此处查看通用信息性消息的完整列表 tasks.time: type: string description: 执行时间（秒） tasks.cost: type: number description: 任务成本（美元） tasks.result_count: type: integer description: 结果数组中的元素数量 tasks.path: type: array items: type: string description: URL 路径 tasks.data: type: object description: 包含您在 POST 请求中指定的相同参数 tasks.result: type: array items: type: string description: 结果数组 tasks.result.crawl_progress: type: string description: 抓取会话的状态，可能的值：in_progress、finished tasks.result.crawl_status: type: object description: 抓取会话的详细信息 tasks.result.crawl_status.max_crawl_pages: type: integer description: 最大抓取页面数，表示设置任务时指定的 max_crawl_pages 限制 tasks.result.crawl_status.pages_in_queue: type: integer description: 当前位于抓取队列中的页面数量 tasks.result.crawl_status.pages_crawled: type: integer description: 已抓取页面数 tasks.result.items_count: type: integer description: results 数组中的项目数量 tasks.result.items: type: array items: type: string description: items 数组 tasks.result.items.page_url: type: string description: 页面的 URL tasks.result.items.time_to_interactive: type: integer description: 可交互时间（TTI）指标，即用户能够与页面交互所需的时间（以毫秒为单位） tasks.result.items.dom_complete: type: integer description: 资源加载时间；下载页面及其所有子资源所需的时间（以毫秒为单位） tasks.result.items.connection_time: type: integer description: 连接服务器的时间，即与服务器建立连接所需的时间（以毫秒为单位） tasks.result.items.time_to_secure_connection: type: integer description: 建立安全连接的耗时，即与服务器建立安全连接所需的时间（以毫秒为单位） tasks.result.items.request_sent_time: type: integer description: 向服务器发送请求的时间，即请求发送至服务器所需的时间（以毫秒为单位） tasks.result.items.waiting_time: type: integer description: 首字节时间（TTFB），单位为毫秒 tasks.result.items.download_time: type: integer description: 浏览器接收响应所需的时间（以毫秒为单位） tasks.result.items.duration_time: type: integer description: 浏览器从服务器接收到完整响应所需的总时间（以毫秒为单位） tasks.result.items.fetch_start: type: integer description: 开始下载 HTML 资源的时间，即浏览器开始下载页面所需的时间 tasks.result.items.fetch_end: type: integer description: 完成 HTML 资源下载所需的时间，即浏览器完成页面下载所需的时间 tasks.result.items.resources: type: array items: type: string description: 特定于资源的计时信息，包含多个独立数组，分别记录页面上找到的每项资源的计时数据 tasks.result.items.resources.resource_type: type: string description: 返回资源的类型 tasks.result.items.resources.url: type: string description: 资源 URL tasks.result.items.resources.initiator: type: string description: 资源发起方 tasks.result.items.resources.duration_time: type: integer description: 浏览器从服务器接收到完整响应所需的总时间（以毫秒为单位） tasks.result.items.resources.fetch_start: type: integer description: 开始下载资源的时间，即浏览器开始下载资源所需的时间 tasks.result.items.resources.fetch_end: type: integer description: 资源下载完成时间，即浏览器完成资源下载所需的时间 tasks.result.items.resources.location: type: object description: 资源在文档中的位置，用于定义特定资源在文档 HTML 中位置的参数 tasks.result.items.resources.location.line: type: integer description: 行号，即资源所在的行编号 tasks.result.items.resources.location.offset_left: type: integer description: 行内位置，即资源之前的行内字符数；有时也称为列；注意：从 1 开始计数，即如果资源左侧没有任何字符，该值将为 1 tasks.result.items.resources.location.offset_top: type: integer description: 文档中的位置，即资源与 HTML 顶部之间的字符总数 tasks.result.items.resources.is_render_blocking: type: boolean description: 指示资源是否会阻塞渲染 '400': description: 错误请求 '401': description: 未授权 '429': description: 超出速率限制 '500': description: 内部服务器错误 components: securitySchemes: BearerAuth: type: http scheme: bearer ````