用途：为开发者与销售运营提供 Pipedrive 平台集成指导，包括通过 API 创建/更新交易、人员、组织、线索、活动，配置 Webhook 推送变更，从 API v1 迁移到 v2，处理 429 限流，使用自定义字段以及理解套餐与 token 预算。
主要能力与用法：默认使用 v2（游标分页、token 成本约为 v1 一半），仅对尚未上 v2 的资源（Leads、Notes、Webhooks、Files、Filters、Goals、Projects）使用 v1。认证上，自有账号用 API token（x-api-token 头），可分发的 MarketPlace 应用用 OAuth 2.0（使用返回的 api_domain 作为基础 URL）。自定义字段是 40 位哈希键而非名称，需通过 GET /api/v1/dealFields（或 personFields/organizationFields）获取并缓存哈希→标签映射，且哈希因账号而异。
限流：每日 token 预算为 30,000 × 套餐倍率 × 席位数，触发 429 后当天不可用（除非加购）。v2 约省一半 token，Webhook 免费，增量拉取用 updated_since。Webhook 需立即返回 200 并异步处理，重试间隔为 3/30/150 秒，首次尝试连续失败 10 次封禁 30 分钟，连续 3 天无成功投递会自动删除；应按对象 id 与 meta.timestamp 去重。
限制与注意：API v1 将于 2026-07-31 完全停用；v2 用 PATCH（v1 用 PUT）和游标分页（additional_data.next_cursor），移植代码需同时改动；Leads 与 Deals 不同且仅 v1；基础 URL 为公司专属，格式为 https://{your-company}.pipedrive.com/api/...；LeadBooster、Web Visitors、Campaigns、Smart Docs、Projects 等为付费附加项。定价、停用日期等可能变化，请以官方为准。