用途:该技能提供与 Blackbaud SKY API(Raiser's Edge NXT)集成的参考资料,用于编写非营利筹款和捐赠人管理相关代码。基础地址为 https://api.sky.blackbaud.com,各模块通过带版本的路径段访问。
主要能力:Constituent 模块(/constituent/v1,159 个操作)覆盖捐赠人主记录及其地址、别名、教育、邮箱、电话、关系、评级、备注、通信偏好、自定义字段、附件等子资源,并含 Actions、Prospect Status、Giving Summary 端点;Gift 模块(/gift/v1,28 个操作)处理礼金与经常性捐赠、致谢、收据、批次;Gift v2(/gft-gifts,10 个操作,PREVIEW)支持承诺分期、股票出售、批次礼物与经常性捐赠修订;Fundraising(/fundraising/v1,53 个操作)覆盖 Campaign、Fund、Appeal、Package、Fundraiser;Opportunity(/opportunity/v1,19 个操作)与 Event(/event,65 个操作)。
认证与用法:使用 OAuth 2.0 授权码流程,授权地址 https://oauth2.sky.blackbaud.com/authorization,令牌地址 https://oauth2.sky.blackbaud.com/token,令牌有效期 60 分钟,Scopes 当前未使用。需准备 Application ID(client_id)、Client Secret 与 API Subscription Key。每次调用需携带 Authorization: Bearer {access_token}、Bb-Api-Subscription-Key: {subscription_key}、Content-Type: application/json。
分页与限流:使用 limit 与 offset,默认 500,最大 5000(部分端点可至 10000),列表响应含 count 字段。超出速率返回 HTTP 429,超出配额返回 HTTP 403,均含 Retry-After 头,应实现指数退避。
限制:资料未提供价格、收费或平台支持范围;Gift v2 标注为 PREVIEW。具体端点参数与响应结构需另行查阅官方规范。