用途：为对接 DonorDock 非营利 CRM 的 Public API（v1 REST）提供集成参考，适合编写捐赠者管理与 CRM 集成代码。
基础信息：Base URL 为 https://public-api.donordock.com/api/v1，采用 HTTPS 上的 HTTP Basic 认证，凭据为 APIKey:APISecret 经 Base64 编码放入 Authorization 头，密钥在 UI 的 Settings → Integrations → API key 生成。示例：curl -u "$DD_API_KEY:$DD_API_SECRET" "https://public-api.donordock.com/api/v1/Contacts?take=10"
主要能力：覆盖 Contacts（列表、获取、创建、更新、搜索）、Gifts（列表、获取、创建、搜索，无更新端点）、Activities、Campaigns、Appeals、Funds、Badges、MarketingLists、Events 出席、GiftBatches（只读）、Emails 发送模板邮件、MetaData（用户、邮件模板、自定义字段定义）。
用法要点：列表端点共用 skip/take 分页（take 上限 1000）、fromDate/toDate 与 fromDateModified/toDateModified 时间过滤（UTC）、sortBy 与 sortDir；响应为 { "TotalRecords", "CurrentRecords", "Data" } 包装，按 skip + CurrentRecords >= TotalRecords 翻页。关联记录可用 ContactId、ContactAccountNumber、ContactMemberId、ContactIntegrationId、ContactEmail 之一指定联系人。Gift 枚举：Status 为 Received、Pledged、Cancelled、Pending、Processing；TransactionType 为 Donation、Membership、EventTicket、Grant，GET /api/v1/Gifts 支持逗号分隔多值。
限制与注意：公开 API 无 webhook，增量同步需用 fromDateModified 配合 sortBy=ModifiedOn 轮询；无服务端 upsert，建议先搜索再创建，并设置 IntegrationId 与 Source；自定义字段需先通过 GET /api/v1/MetaData/GetCustomFieldDefinitions?entityType=... 获取定义再经 CustomFields 数组写入；Gifts 无更新端点，须一次创建正确；SendTemplateEmail 会消耗营销邮件额度，批量发送前需确认。端点参数与对象字段见 references/endpoints.md 与 references/schemas.md。该技能与 DonorDock 无隶属或赞助关系，信息可能过时，应以官方文档与 Swagger 规范为准。