HTTPS listeners（HTTPS 监听器(HTTPS listeners)）¶
HTTPS listeners receive inbound webhook requests from external systems through HTTPS endpoints. Events are written to a stream, enabling processing through Automate, streaming pipelines, or batch processing using the stream's backing dataset.
When to use HTTPS listeners¶
You can use HTTPS listeners in the following situations:
- The external system supports outbound webhooks.
- You need to receive event notifications when something changes in the external system.
- The external system cannot authenticate with standard OAuth 2.0 or Foundry APIs.
Configure a listener¶
Navigate to Data Connection > Listeners to connect the Palantir platform to external systems and workflows. For information on securely configuring listeners and incoming data, refer to the HTTPS listener security documentation.
You can explore a listener's streaming dataset in Data Lineage to better understand data transformations and flows.
Throughput and limitations¶
Only low-throughput event streams should be pushed to HTTPS listeners. HTTPS listeners are rate-limited at approximately 100 requests per second, so integrations requiring substantially higher throughput should use streaming syncs or the public streaming API endpoints when possible.
If your use case requires a higher rate limit than what is currently provided, and listeners are the only appropriate integration option, contact Palantir Support to discuss increasing this limit.
Individual event and request payloads are limited to 1 MB in size, as this is the maximum row size in the output streaming dataset. Foundry rejects events that exceed this limit.
Supported HTTPS listeners¶
You can either configure a custom, basic authentication listener, or one of the following listeners:
| Listener, linked to external documentation | Platform setup guide |
|---|---|
| Airtable ↗ | |
| Apollo ↗ | |
| AWS SNS ↗ | |
| Azure Event Grid ↗ | |
| Bitbucket ↗ | |
| Cisco Meraki ↗ | |
| Dialpad ↗ | |
| FedEx ↗ | |
| GitLab ↗ | |
| GitHub ↗ | |
| Google Cloud Pub/Sub ↗ | Guide |
| ION Factory OS ↗ | |
| Jira ↗ and Jira Cloud Automation ↗ | Guide |
| Jotform ↗ | |
| Meta ↗ | |
| Microsoft Bot Framework ↗ | |
| PagerDuty ↗ | |
| PandaDoc ↗ | |
| project44 ↗ | |
| RevelocPlus | |
| ShipStation ↗ | |
| Shopify ↗ | |
| Skydio ↗ | |
| Slack ↗ | Guide |
| Stripe ↗ | |
| Twilio ↗ | |
| Twilio SendGrid ↗ | |
| Zendesk ↗ |
All product names, logos, and brands mentioned are trademarks of their respective owners. All company, product, and service names used in this document are for identification purposes only.
中文翻译¶
HTTPS 监听器(HTTPS listeners)¶
HTTPS 监听器通过 HTTPS 端点接收来自外部系统的入站 Webhook 请求。事件会被写入流(stream)，从而支持通过自动化(Automate)、流式管道(streaming pipelines)进行处理，或使用流的后端数据集进行批处理。
何时使用 HTTPS 监听器¶
您可以在以下场景中使用 HTTPS 监听器：
- 外部系统支持出站 Webhook。
- 当外部系统发生变更时，您需要接收事件通知。
- 外部系统无法通过标准 OAuth 2.0 或 Foundry API 进行身份验证。
配置监听器¶
导航至 数据连接(Data Connection) > 监听器(Listeners)，将 Palantir 平台连接到外部系统和工作流。有关安全配置监听器和传入数据的详细信息，请参阅 HTTPS 监听器安全文档。
您可以在数据沿袭(Data Lineage)中探索监听器的流式数据集，以更好地理解数据转换和数据流。
吞吐量与限制¶
仅应将低吞吐量的事件流推送到 HTTPS 监听器。HTTPS 监听器的速率限制约为每秒 100 个请求，因此需要大幅提高吞吐量的集成应尽可能使用流式同步(streaming syncs)或公共流式 API 端点(public streaming API endpoints)。
如果您的用例需要比当前提供的更高的速率限制，并且监听器是唯一合适的集成选项，请联系 Palantir 支持以讨论提高此限制。
单个事件和请求负载的大小限制为 1 MB，因为这是输出流式数据集中的最大行大小。Foundry 会拒绝超过此限制的事件。
支持的 HTTPS 监听器¶
您可以配置自定义的基本身份验证监听器，也可以配置以下监听器之一：
本文档中提及的所有产品名称、徽标和品牌均为其各自所有者的商标。本文档中使用的所有公司、产品和服务名称仅用于标识目的。