用途:面向与 DonorPerfect Online(DP)XML API(SofterWare, Inc.,User Manual v7.1,对应 2024.02.16)集成的开发参考,用于非营利捐赠者管理与募捐功能。
主要能力:HTTPS-only、返回 XML 的 API,提供预定义过程式调用(如 dp_gifts、dp_savegift、dp_savepledge、dp_savedonor、dp_save_udf_xml、dp_saveflag_xml、mergemultivalues、dp_tribAnon_* 等)以及针对底层 MS SQL Server 2019 的即席 SQL SELECT 查询。覆盖捐赠者、礼品/承诺/EFT、纪念致敬、自定义字段、代码、复选框、标记、拆分礼品、软信用、调整等数据模型。
使用方式:唯一端点为 https://www.donorperfect.net/prod/xmlrequest.asp,全部为 HTTPS GET,通过 action 查询参数分派操作;apikey 由 DonorPerfect 支持/API 帮助台提供,不加引号、不做 URL 编码。预定义过程用 params 传参,支持命名与位置两种参数(不可混用);日期仅 'MM/DD/YYYY';字符串单引号,撇号写两个;Unicode 前缀 N;空值用 null;action 后内容需 URL 编码。写入调用多支持 @user_id 审计字段。
限制:每查询最多 500 行,需分页;API 写入不触发 SmartActions;所有请求被记录;无 SLA,SofterWare 保留变更接口的权利;仅文档所述 SQL 子集受保证;生产代码避免 SELECT *;UDF 字段须已存在。密码过期不影响 API 密钥,但密钥拥有完整数据访问权限,DP 用户权限不限制 API 调用。
适用场景与其它:适用于非营利捐赠者数据读写、礼品与承诺同步、致敬通知、多币种、收据交付、英国 Gift Aid、魁北克 Law 25 隐私字段等。
补充:资料中部分内容显示不完全(如 Quebec Law 25 段落截断、references/procedures.json 与 references/tables.json 的完整参数表/列表明细),这些细节暂未提供。