用途:该技能帮助开发者完成对 Guidewire PolicyCenter、ClaimCenter 和 BillingCenter 的首次 Cloud API 调用,适用于测试连通性、探索 Cloud API 结构或学习入门。
主要能力:Guidewire Cloud API 均为 RESTful 风格,使用 JSON 载荷,并遵循 Swagger 2.0。技能演示了查询 PolicyCenter 账户和 ClaimCenter 索赔的调用方式,并说明响应结构。
使用方式:先获取令牌,再设置请求头。示例中通过 getGuidewireToken() 获取 token,并构造 headers:Authorization 为 Bearer token,Content-Type 为 application/json。随后可调用账户列表接口,例如 fetch(${process.env.GW_PC_URL}/account/v1/accounts?pageSize=5, { headers }),以及索赔列表接口,例如 fetch(${process.env.GW_CC_URL}/claim/v1/claims?pageSize=5, { headers })。
响应结构:返回体包含 count、data 数组、links 等字段。data 中每项含 attributes(字段值)、checksum(用于乐观锁)、links(如 self 链接)。分页通过 links.next.href 提供,含 offsetToken。
错误处理:404 表示端点路径无效,需核对 /account/v1/accounts 格式;400 表示查询参数无效,需检查 pageSize 与过滤语法;422 表示业务规则冲突,需读取响应中的 userMessage;409 表示 checksum 过期,需重新 GET 资源并使用新 checksum。
限制:资料未提供具体环境变量配置、令牌获取细节、完整实现步骤及本地开发流程,相关内容暂未提供。