# Guidewire 你好世界 ## 概述执行对 Guidewire InsuranceSuite 云 API 的首次 API 调用 - PolicyCenter、ClaimCenter 和 BillingCenter。 ## 先决条件 * 完成 `guidewire-install-auth` 设置 * 有效的 OAuth2 访问令牌 * 目标端点的API角色权限 ## 说明 ### 第 1 步：测试系统连接 # 首先获取访问令牌 TOKEN=$(curl -s -X POST "${GW_HUB_URL}/oauth/token" \ -H“内容类型：application/x-www-form-urlencoded”\ -d“grant_type=client_credentials&client_id=${GW_CLIENT_ID}&client_secret=${GW_CLIENT_SECRET}”\ | jq -r '.access_token') # 测试PolicyCenter系统信息卷曲 -s“${POLICYCENTER_URL}/common/v1/system-info”\ -H“授权：持有者${TOKEN}”\ -H“内容类型：application/json”|杰克 ### 步骤2：查询账户（PolicyCenter） // 列出分页帐户接口账户{ id：字符串；帐号：字符串；帐户持有人：{ 显示名称：字符串； }; 帐户状态：{ 代码：字符串； }; } 接口 AccountsResponse { 数据：账户[]；链接：{ 下一个？：字符串；上一个？：字符串； }; 计数：数量； } 异步函数 listAccounts(limit: number = 25): Promise { const 响应 = 等待 client.request( '获取', `/account/v1/accounts?pageSize=${limit}` ）； console.log(`找到 ${response.count} 个帐户`); 响应.data.forEach（帐户=> { console.log(`- ${account.accountNumber}: ${account.accountHolder.displayName}`); }); 返回响应； } ### 步骤 3：创建提交 (PolicyCenter) // 创建一个新的策略提交接口创建提交请求{ 数据：{ 属性：{ 帐户：{ id：字符串}； baseState: { 代码: 字符串 }; 产品：{代码：字符串}；生产者代码：{id：字符串}；有效日期：字符串； }; }; } 接口提交{ id：字符串；职位编号：字符串；状态：{代码：字符串}； } 异步函数createSubmission( 账户ID：字符串，产品代码：字符串 = 'PersonalAuto' ): 承诺<提交> { 常量请求：CreateSubmissionRequest = { 数据：{ 属性：{ 账户: { id: accountId }, 基本状态：{代码：'CA'}，产品：{代码：产品代码}，生产者代码: { id: 'pcid:DefaultProducerCode' }, 有效日期：新日期（Date.now（）+ 30 * 24 * 60 * 60 * 1000） .toISOString().split('T')[0] } } }; const response = wait client.request<{ data: 提交 }>( '发布', '/job/v1/提交', 要求）； console.log(`已创建提交：${response.data.jobNumber}`); 返回响应数据； } ### 步骤 4：提出索赔（索赔中心） // 首次丢失通知 (FNOL) 接口 FNOLRequest { 数据：{ 属性：{ 损失日期：字符串；损失类型：{代码：字符串}； lossCause: { 代码: 字符串 }; 描述：字符串；报告日期：字符串；政策编号：字符串； }; }; } 接口声明{ id：字符串；索赔编号：字符串；状态：{代码：字符串}； } 异步函数 createFNOL(policyNumber: string): Promise { const fnol: FNOLRequest = { 数据：{ 属性：{ lossDate: new Date().toISOString().split('T')[0], 损失类型：{代码：'自动'}， lossCause: { 代码: 'vehcollision' }, 描述：“十字路口车辆碰撞”， reportsDate: new Date().toISOString().split('T')[0], 保单编号: 保单编号 } } }; const 响应 = 等待 client.request<{ data: Claim }>( '发布', `${process.env.CLAIMCENTER_URL}/claim/v1/claims`, 福诺尔）； console.log(`已创建声明：${response.data.claimNumber}`); 返回响应数据； } ###第五步：查询发票（BillingCenter） // 列出账户发票接口发票{ id：字符串；发票编号：字符串；发票日期：字符串；截止日期：字符串；状态：{代码：字符串}；金额：{ 金额：数量；货币：字符串}； } 接口发票响应{ 数据：发票[]；计数：数量； } 异步函数 getAccountInvoices(accountId: string): Promise { const 响应 = 等待 client.request( '获取', `${process.env.BILLINGCENTER_URL}/billing/v1/accounts/${accountId}/invoices` ）； console.log(`找到 ${response.count} 张发票`); response.data.forEach(发票 => { console.log(`- ${invoice.invoiceNumber}: $${invoice.amount.amount} 到期 ${invoice.dueDate}`); }); 返回响应； } ## Gosu Hello World（服务器端） // 查询PolicyCenter数据的Gosu脚本使用 gw.api.database.Query 使用实体.策略使用实体.Account 类HelloGuidewire { 静态函数 listActiveAccounts() : List { var query = Query.make(账户) .compare(Account#AccountStatus, 等于, AccountStatus.TC_ACTIVE) .select() .toList() 查询.each(\帐户 -> { print("账户：${account.AccountNumber} - ${account.AccountHolderContact.DisplayName}") }) 返回查询 } 静态函数 findPoliciesByAccount(accountNumber : String) : List { var account = Query.make(帐户) .比较（帐户#帐户编号，等于，帐户编号） .select() .AtMostOneRow 如果（帐户==空）{ throw new IllegalArgumentException("未找到帐户：${accountNumber}") } 返回 account.Policies.toList() } } ## 输出 *来自PolicyCenter的成功API响应 * 带分页的帐户列表 * 创建带有职位编号的提交 * FNOL 索赔创建确认 * BillingCenter 的发票清单 ## 错误处理错误 |原因 |解决方案 ---|---|--- `404 未找到` |端点或资源 ID 无效 |验证端点路径和 ID 格式 `400 错误请求` |无效的请求负载 |检查必填字段和数据类型 `422 无法处理` |违反商业规则 |检查响应中的验证错误 `409 冲突` |并发修改 |使用更新的校验和重试 `415 不支持的媒体` |内容类型错误 |使用“application/json” ## API 响应结构所有 Guidewire Cloud API 都遵循以下结构：接口 GuidewireResponse { 数据：T； // 请求的资源包括？：任何[]； // 相关资源（如果需要）链接？：{ 自我：字符串；下一个？：字符串；上一个？：字符串； }; 数？：数量； // 集合总数 } ## 常见资源模式 // 获取单个资源获取 /account/v1/accounts/{accountId} // 使用过滤器列出资源 GET /account/v1/accounts?filter=accountStatus:eq:Active&pageSize=50 // 创建资源 POST /帐户/v1/帐户 { “数据”：{ “属性”：{ ... } } } // 更新资源（补丁）补丁 /account/v1/accounts/{accountId} { “数据”：{ “属性”：{ ... }，“校验和”：“abc123” } } // 包含相关资源 GET /account/v1/accounts/{accountId}?include=accountHolder,primaryLocation ## 示例 ### 完整的 Hello World 脚本从'./client'导入{GuidewireClient}；异步函数 main() { const 客户端 = 新 GuidewireClient( process.env.GW_CLIENT_ID!, process.env.GW_CLIENT_SECRET！， process.env.GW_HUB_URL!, process.env.POLICYCENTER_URL！）；尝试{ // 1. 测试连通性 console.log('正在测试 PolicyCenter 连接...'); const systemInfo = wait client.request('GET', '/common/v1/system-info'); console.log('已连接：', systemInfo); // 2. 列出账户 console.log('\n列出帐户...'); const 账户 = 等待 client.request('GET', '/account/v1/accounts?pageSize=5'); console.log(`找到 ${accounts.count} 个帐户`); // 3. 获取账户详细信息 if (accounts.data.length > 0) { const accountId = account.data[0].id; console.log(`\n获取帐户详细信息：${accountId}`); const account = wait client.request('GET', `/account/v1/accounts/${accountId}`); console.log('账户详细信息：', JSON.stringify(account, null, 2)); } console.log('\nHello World 完成！'); } 捕获（错误）{ console.error('错误：', error.response?.data || error.message); } } 主要的（）; ## 资源 * [PolicyCenter 云 API 参考]() * [ClaimCenter 云 API 参考]() * [BillingCenter 云 API 参考]() * [云API开发者指南]() ## 后续步骤对于本地开发工作流程，请参阅“guidewire-local-dev-loop”。

导丝你好世界

包含技能