> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brightdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 截止期限功能

> 本指南向您展示如何限制数据集触发请求等待时间，当快照可能需要很长时间完成时。

<Steps titleSize="h3">
  <Step title="前置条件" icon="list-check" iconType="duotone">
    * 具体任务：为快照运行添加时间限制，以防其无限期等待。
    * 相关设置：`deadline`（查询参数）
  </Step>

  <Step title="设置截止期限查询参数" stepNumber={1}>
    将deadline添加到您的触发请求查询字符串中：

    * 如果您想等待一个固定时长，请设置一个时长，例如3m、15min、2h。
    * 如果您想让请求等待到特定时刻，请设置一个ISO时间戳，例如`2022-01-12T18:58:43.149Z`。

    > **示例：** `&deadline=3m`

    **预期结果：** 触发请求将等待到指定的限制。如果运行在此之前未完成，它将返回错误/超时响应，而不是继续等待。
  </Step>

  <Step title="发送带有截止期限的触发请求" stepNumber={2}>
    使用您通常使用的相同触发调用并附加deadline。

    ```sh highlight={20} theme={null}
    curl \
      -H "Authorization: Bearer TOKEN" \
      -H "Content-Type: application/json" \
      -d '{
        "input": [
          { "url": "https://www.linkedin.com/in/elad-moshe-05a90413/" },
          { "url": "https://www.linkedin.com/in/jonathan-myrvik-3baa01109" },
          { "url": "https://www.linkedin.com/in/aviv-tal-75b81/" },
          { "url":"https://www.linkedin.com/in/bulentakar/" }
        ] 
      }' \
      "https://api.brightdata.com/datasets/v3/trigger" \
      "?dataset_id=gd_l1viktl72bvl7bjuj0" \
      "&endpoint=https%3A%2F%2Fwebhook.site%2Fc6aee479-3dae-44bb-9b44-09a7cd823efe" \
      "&notify=false" \
      "&format=json" \
      "&uncompressed_webhook=true" \
      "&force_deliver=false" \
      "&include_errors=true" \
      "&deadline=3m"
    ```

    `deadline` 必须是：

    * ISO格式（`2022-01-12T18:58:43.149Z`）
    * 时长格式（`1s`、`15min`、`2h`、`3d`）。

    **预期结果：**

    * 如果运行在3m内完成，您将收到结果（或您的webhook收到输出有效负载）。
    * 如果运行在3m内未完成，触发调用超时/返回错误响应。
  </Step>

  <Step title="检查您的webhook有效负载以了解成功或错误" stepNumber={3}>
    如果您配置了webhook端点，请验证有效负载：

    <CodeGroup>
      ```json ✅ 成功 theme={null}
      [
        {
          "url": "https://www.amazon.com/Solar-Eclipse-Glasses-Certified-Viewing/dp/B08GB3QC1H",
          "product_name": "Soluna Solar Eclipse Glasses AAS Approved 2024 - Made in the USA CE and ISO Certified Safe Shades for Direct Sun Viewing (2 Pack)",
          "product_rating": 4.6,
          "review_id": "R3LKES0U7C9BGB",
          "badge": "Verified Purchase"
        }
      ]
      ```

      ```json ❌ 错误（达到截止期限） theme={null}
      [
        {
          "timestamp": "2026-02-23T08:54:26.645Z",
          "input": {
            "url": "https://www.amazon.com/Solar-Eclipse-Glasses-Certified-Viewing/dp/B08GB3QC1H",
            "reviews_to_not_include": []
          },
          "error": "Crawl aborted on job cancel",
          "error_code": "aborted_page"
        }
      ]
      ```
    </CodeGroup>
  </Step>
</Steps>