> For the complete documentation index, see [llms.txt](https://developers.oxylabs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.oxylabs.io/products/cn/web-scraper-api/integration-methods.md).

# 集成方法

了解 Oxylabs 网页爬虫API 的三种集成方法（Realtime、Push-Pull、Proxy Endpoint），并学习它们在任务提交、格式和工作流上的差异。

网页爬虫API 支持 **三种集成方式，** 每一种都有其独特的优势：

* [**Realtime**](/products/cn/web-scraper-api/integration-methods/realtime.md)。这种方式是同步的。这意味着，在发送作业提交请求后， **你将需要保持连接打开** ，直到我们成功完成你的作业或返回错误。对于需要立即响应的实时数据提取，这种集成方式最适合。你可以发送包含爬取和解析参数的 JSON 负载，而 API 会自动处理代理管理、重试和爬虫流量管理。
* [**Push-Pull**](/products/cn/web-scraper-api/integration-methods/push-pull.md) **（支持批量查询）**。这种集成方式是 **异步的**。这意味着，在提交作业后，我们会迅速向你返回一个包含作业信息的 JSON，其中包括用于下载结果/检查作业状态的 URL。等我们完成作业处理后，我们会 `POST` 向你的服务器发送作业完成通知，届时你就可以下载结果了。这种集成方式还支持将结果直接上传到你的 AWS S3、Google Cloud，或任何兼容 S3 的存储。

{% hint style="success" %}
Push-Pull 是我们推荐的集成方式，适合可靠处理大量数据。
{% endhint %}

* [**Proxy Endpoint**](/products/cn/web-scraper-api/integration-methods/proxy-endpoint.md)。这种方式也是同步的（与 Realtime 类似），但不是通过 RESTful 接口使用我们的服务，而是 **可以像代理一样使用我们的端点**。如果你以前用过代理，并且只想从我们这里获取可用的网页内容，请使用 Proxy Endpoint。

{% hint style="info" %}
存活时间（**TTL**）适用于所有 API 连接，设置为 **150 秒**。需要注意的是，在极少数情况下，连接可能会在收到响应之前超时。系统负载或极其复杂的作业提交等因素都可能导致超时。
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://developers.oxylabs.io/products/cn/web-scraper-api/integration-methods.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.