SuperAPI AI 工具集

guidewire-sdk-patterns

编程与开发

查看项目

更新于 10-15 23:26

技能介绍

用途:在已有认证层(getToken() 返回缓存且校验作用域的 bearer 令牌)之上,构建可运行于生产的 Guidewire Cloud API 请求层,解决五类请求侧故障:409 校验和冲突、429 配额级联、分页静默丢数据、重试导致重复写入、错误信息被压平。

主要能力:1)校验和往返:patchResource/putResource 先 GET 取最新 checksum 再 PATCH/PUT,遇 409 应重试外层 helper 而非内层请求;2)Retry-After 感知限流:429 时解析 Retry-After(秒数或 HTTP 日期),5xx 用带抖动的指数退避,避免客户端同步重试;3)分页:用 paginate 异步生成器沿 links.next.href 迭代,无 links.next 即终止,避免把 pageSize=100 当作全部结果;4)幂等写入:POST 携带 Idempotency-Key(每个逻辑操作生成一次 v4 UUID,跨重试复用,24 小时内去重);5)结构化错误:GwError 暴露 status、op、path、body 与 is(type),便于按 errors[].type 模式匹配。

使用方式:以 fetch 之上的可组合层实现,示例包括 patchResource、backoffFor、paginate、createClaim、mapError 等函数;需 Node 20+ 或支持 fetch、AbortController、crypto.randomUUID 的运行时,端点位于 [TENANT].guidewire.net。

适用场景:PolicyCenter 保单更新、ClaimCenter 批量 FNOL 导入、账户分页索引等并发写入与大批量请求场景。

限制:依赖 guidewire-install-auth 的令牌层;422 规则违规与 400 校验失败不应盲目重试;429 反复出现说明缺少令牌桶或租户配额被共享;具体端点、批量接口与 HTTP/2 连接池细节需参考官方 API 文档。