hl-api-changelog/.swagger/hl-insurance-service.json
2026-03-18 15:56:01 +08:00

3168 行
89 KiB
JSON

此文件含有模棱两可的 Unicode 字符

此文件含有可能会与其他字符混淆的 Unicode 字符。 如果您是想特意这样的,可以安全地忽略该警告。 使用 Escape 按钮显示他们。

{
"swagger": "2.0",
"info": {
"title": "保险服务",
"version": "1.0.0"
},
"basePath": "/",
"paths": {
"/admin/insurance/balance": {
"get": {
"tags": [
"保险管理"
],
"summary": "查询保游网账户余额",
"description": "查询保游网平台的账户余额,用于管理端展示当前可用投保额度。查询失败时返回null非关键信息,不影响业务。\n\n**权限**:需管理员登录。",
"operationId": "getBalanceUsingGET",
"produces": [
"*/*"
],
"responses": {
"200": {
"description": "OK",
"schema": {
"originalRef": "统一响应结果«JsonNode»",
"$ref": "#/definitions/统一响应结果«JsonNode»"
}
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"responsesObject": {
"200": {
"description": "OK",
"schema": {
"originalRef": "统一响应结果«JsonNode»",
"$ref": "#/definitions/统一响应结果«JsonNode»"
}
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"deprecated": false,
"x-order": "2147483647"
}
},
"/admin/insurance/cancel/{id}": {
"post": {
"tags": [
"保险管理"
],
"summary": "退保",
"description": "对单个保险订单发起退保,调用保游网退保API。退保成功后保险状态变为CANCELLED。\n\n**权限**:需管理员登录。\n**注意**:已生效的保单退保可能产生手续费。\n\n**关联字典**\n- insurance_status保险状态状态流转",
"operationId": "cancelUsingPOST",
"consumes": [
"application/json"
],
"produces": [
"*/*"
],
"parameters": [
{
"name": "id",
"in": "path",
"description": "保险订单ID",
"required": false,
"type": "integer",
"format": "int64"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"originalRef": "统一响应结果«保险订单VO»",
"$ref": "#/definitions/统一响应结果«保险订单VO»"
}
},
"201": {
"description": "Created"
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"responsesObject": {
"200": {
"description": "OK",
"schema": {
"originalRef": "统一响应结果«保险订单VO»",
"$ref": "#/definitions/统一响应结果«保险订单VO»"
}
},
"201": {
"description": "Created"
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"deprecated": false,
"x-order": "2147483647"
}
},
"/admin/insurance/coverage/{orderId}": {
"get": {
"tags": [
"保险管理"
],
"summary": "查询订单保险保障(含被保人详情)",
"description": "返回订单维度的保险保障汇总信息,包含覆盖人数、保障期间、每位被保人的保单明细。用于订单详情页的保险保障展示。\n\n**权限**:需管理员登录。\n\n**关联字典**\n- insurance_status保险状态显示\n- gender性别被保人信息显示\n- id_card_type证件类型被保人信息显示",
"operationId": "getCoverageUsingGET",
"produces": [
"*/*"
],
"parameters": [
{
"name": "orderId",
"in": "path",
"description": "旅行订单ID",
"required": false,
"type": "integer",
"format": "int64"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"originalRef": "统一响应结果«订单保险保障VO»",
"$ref": "#/definitions/统一响应结果«订单保险保障VO»"
}
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"responsesObject": {
"200": {
"description": "OK",
"schema": {
"originalRef": "统一响应结果«订单保险保障VO»",
"$ref": "#/definitions/统一响应结果«订单保险保障VO»"
}
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"deprecated": false,
"x-order": "2147483647"
}
},
"/admin/insurance/entities": {
"get": {
"tags": [
"保险管理"
],
"summary": "投保公司主体列表",
"description": "返回系统配置的投保公司主体列表来自Nacos配置,投保下单时选择以哪个公司主体投保。每个主体包含编码、公司名称和商户ID。\n\n**权限**:需管理员登录。",
"operationId": "listEntitiesUsingGET",
"produces": [
"*/*"
],
"responses": {
"200": {
"description": "OK",
"schema": {
"originalRef": "统一响应结果«List«Map«string,string»»»",
"$ref": "#/definitions/统一响应结果«List«Map«string,string»»»"
}
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"responsesObject": {
"200": {
"description": "OK",
"schema": {
"originalRef": "统一响应结果«List«Map«string,string»»»",
"$ref": "#/definitions/统一响应结果«List«Map«string,string»»»"
}
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"deprecated": false,
"x-order": "2147483647"
}
},
"/admin/insurance/orders": {
"get": {
"tags": [
"保险管理"
],
"summary": "保险订单列表",
"description": "**关联字典**\n- insurance_status保险状态列表筛选+显示)",
"operationId": "listOrdersUsingGET",
"produces": [
"*/*"
],
"parameters": [
{
"name": "orderId",
"in": "query",
"description": "关联旅行订单ID",
"required": false,
"type": "integer",
"format": "int64",
"x-example": 2026270000000000001
},
{
"name": "page",
"in": "query",
"description": "页码",
"required": false,
"type": "integer",
"format": "int32",
"x-example": 1
},
{
"name": "pageSize",
"in": "query",
"description": "每页条数",
"required": false,
"type": "integer",
"format": "int32",
"x-example": 20
},
{
"name": "status",
"in": "query",
"description": "订单状态: PENDING-待出单, INSURED-已承保, CANCELLED-已退保, FAILED-投保失败",
"required": false,
"type": "string",
"x-example": "INSURED"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"originalRef": "统一响应结果«分页结果«保险订单VO»»",
"$ref": "#/definitions/统一响应结果«分页结果«保险订单VO»»"
}
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"responsesObject": {
"200": {
"description": "OK",
"schema": {
"originalRef": "统一响应结果«分页结果«保险订单VO»»",
"$ref": "#/definitions/统一响应结果«分页结果«保险订单VO»»"
}
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"deprecated": false,
"x-order": "2147483647"
}
},
"/admin/insurance/orders/by-order/{orderId}": {
"get": {
"tags": [
"保险管理"
],
"summary": "按旅行订单查询保险单",
"description": "根据旅行订单ID查询关联的所有保险订单列表。在订单详情页展示保险购买情况。\n\n**权限**:需管理员登录。\n\n**关联字典**\n- insurance_status保险状态列表显示",
"operationId": "getByOrderUsingGET",
"produces": [
"*/*"
],
"parameters": [
{
"name": "orderId",
"in": "path",
"description": "旅行订单ID",
"required": false,
"type": "integer",
"format": "int64"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"originalRef": "统一响应结果«List«保险订单VO»»",
"$ref": "#/definitions/统一响应结果«List«保险订单VO»»"
}
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"responsesObject": {
"200": {
"description": "OK",
"schema": {
"originalRef": "统一响应结果«List«保险订单VO»»",
"$ref": "#/definitions/统一响应结果«List«保险订单VO»»"
}
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"deprecated": false,
"x-order": "2147483647"
}
},
"/admin/insurance/orders/{id}": {
"get": {
"tags": [
"保险管理"
],
"summary": "保险订单详情(含被保人)",
"description": "**关联字典**\n- insurance_status保险状态显示\n- gender性别被保人信息显示\n- id_card_type证件类型被保人信息显示",
"operationId": "getOrderDetailUsingGET",
"produces": [
"*/*"
],
"parameters": [
{
"name": "id",
"in": "path",
"description": "保险订单ID",
"required": false,
"type": "integer",
"format": "int64"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"originalRef": "统一响应结果«保险订单详情VO»",
"$ref": "#/definitions/统一响应结果«保险订单详情VO»"
}
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"responsesObject": {
"200": {
"description": "OK",
"schema": {
"originalRef": "统一响应结果«保险订单详情VO»",
"$ref": "#/definitions/统一响应结果«保险订单详情VO»"
}
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"deprecated": false,
"x-order": "2147483647"
}
},
"/admin/insurance/policy/{id}/download": {
"get": {
"tags": [
"保险管理"
],
"summary": "下载保单PDF(Base64)",
"description": "从保游网下载指定保险订单的电子保单PDF,以Base64编码返回。前端可解码后展示或提供下载。\n\n**权限**:需管理员登录。",
"operationId": "downloadPolicyUsingGET",
"produces": [
"*/*"
],
"parameters": [
{
"name": "id",
"in": "path",
"description": "保险订单ID",
"required": false,
"type": "integer",
"format": "int64"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"originalRef": "统一响应结果«string»",
"$ref": "#/definitions/统一响应结果«string»"
}
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"responsesObject": {
"200": {
"description": "OK",
"schema": {
"originalRef": "统一响应结果«string»",
"$ref": "#/definitions/统一响应结果«string»"
}
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"deprecated": false,
"x-order": "2147483647"
}
},
"/admin/insurance/products": {
"get": {
"tags": [
"保险管理"
],
"summary": "保险产品列表",
"description": "分页查询已同步的保险产品,支持按是否境外筛选。产品数据来源于保游网同步。\n\n**权限**:需管理员登录。",
"operationId": "listProductsUsingGET",
"produces": [
"*/*"
],
"parameters": [
{
"name": "isOverseas",
"in": "query",
"description": "是否境外",
"required": false,
"type": "boolean",
"allowEmptyValue": false
},
{
"name": "page",
"in": "query",
"description": "页码",
"required": false,
"type": "integer",
"default": 1,
"format": "int32",
"allowEmptyValue": false
},
{
"name": "pageSize",
"in": "query",
"description": "每页条数",
"required": false,
"type": "integer",
"default": 20,
"format": "int32",
"allowEmptyValue": false
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"originalRef": "统一响应结果«分页结果«保险产品VO»»",
"$ref": "#/definitions/统一响应结果«分页结果«保险产品VO»»"
}
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"responsesObject": {
"200": {
"description": "OK",
"schema": {
"originalRef": "统一响应结果«分页结果«保险产品VO»»",
"$ref": "#/definitions/统一响应结果«分页结果«保险产品VO»»"
}
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"deprecated": false,
"x-order": "2147483647"
}
},
"/admin/insurance/products/{id}": {
"get": {
"tags": [
"保险管理"
],
"summary": "保险产品详情",
"description": "返回保险产品完整信息,包含产品名称、保险公司、保障范围、适用地区等。\n\n**权限**:需管理员登录。",
"operationId": "getProductUsingGET",
"produces": [
"*/*"
],
"parameters": [
{
"name": "id",
"in": "path",
"description": "保险产品ID",
"required": false,
"type": "integer",
"format": "int64"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"originalRef": "统一响应结果«保险产品VO»",
"$ref": "#/definitions/统一响应结果«保险产品VO»"
}
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"responsesObject": {
"200": {
"description": "OK",
"schema": {
"originalRef": "统一响应结果«保险产品VO»",
"$ref": "#/definitions/统一响应结果«保险产品VO»"
}
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"deprecated": false,
"x-order": "2147483647"
}
},
"/admin/insurance/products/{id}/plans": {
"get": {
"tags": [
"保险管理"
],
"summary": "保险产品计划及费率",
"description": "返回指定保险产品的所有投保计划及对应费率表,包含不同天数区间的保费价格。投保下单前需选择具体计划。\n\n**权限**:需管理员登录。",
"operationId": "getProductPlansUsingGET",
"produces": [
"*/*"
],
"parameters": [
{
"name": "id",
"in": "path",
"description": "保险产品ID",
"required": false,
"type": "integer",
"format": "int64"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"originalRef": "统一响应结果«List«保险计划VO»»",
"$ref": "#/definitions/统一响应结果«List«保险计划VO»»"
}
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"responsesObject": {
"200": {
"description": "OK",
"schema": {
"originalRef": "统一响应结果«List«保险计划VO»»",
"$ref": "#/definitions/统一响应结果«List«保险计划VO»»"
}
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"deprecated": false,
"x-order": "2147483647"
}
},
"/admin/insurance/purchase": {
"post": {
"tags": [
"保险管理"
],
"summary": "投保下单(每人独立保单)",
"description": "**关联字典**\n- gender性别被保人信息\n- id_card_type证件类型被保人信息",
"operationId": "purchaseUsingPOST",
"consumes": [
"application/json"
],
"produces": [
"*/*"
],
"parameters": [
{
"in": "body",
"name": "request",
"description": "投保请求",
"required": false,
"schema": {
"originalRef": "投保请求",
"$ref": "#/definitions/投保请求"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"originalRef": "统一响应结果«List«保险订单详情VO»»",
"$ref": "#/definitions/统一响应结果«List«保险订单详情VO»»"
}
},
"201": {
"description": "Created"
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"responsesObject": {
"200": {
"description": "OK",
"schema": {
"originalRef": "统一响应结果«List«保险订单详情VO»»",
"$ref": "#/definitions/统一响应结果«List«保险订单详情VO»»"
}
},
"201": {
"description": "Created"
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"deprecated": false,
"x-order": "2147483647"
}
},
"/admin/insurance/recharge": {
"post": {
"tags": [
"保险管理"
],
"summary": "在线充值(调用保游网支付API)",
"description": "调用保游网在线充值API,生成充值支付链接。支持选择支付方式支付宝/微信),充值完成后账户余额自动更新。\n\n**权限**:需管理员登录。",
"operationId": "rechargeUsingPOST",
"consumes": [
"application/json"
],
"produces": [
"*/*"
],
"parameters": [
{
"in": "body",
"name": "request",
"description": "充值请求",
"required": false,
"schema": {
"originalRef": "充值请求",
"$ref": "#/definitions/充值请求"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"originalRef": "统一响应结果«Map«string,object»»",
"$ref": "#/definitions/统一响应结果«Map«string,object»»"
}
},
"201": {
"description": "Created"
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"responsesObject": {
"200": {
"description": "OK",
"schema": {
"originalRef": "统一响应结果«Map«string,object»»",
"$ref": "#/definitions/统一响应结果«Map«string,object»»"
}
},
"201": {
"description": "Created"
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"deprecated": false,
"x-order": "2147483647"
}
},
"/admin/insurance/recharge-url": {
"get": {
"tags": [
"保险管理"
],
"summary": "获取保游网充值链接(旧接口,保留兼容)",
"description": "返回保游网平台的充值页面URL。此为旧版接口,保留用于向后兼容,推荐使用在线充值接口。\n\n**权限**:需管理员登录。",
"operationId": "getRechargeUrlUsingGET",
"produces": [
"*/*"
],
"responses": {
"200": {
"description": "OK",
"schema": {
"originalRef": "统一响应结果«string»",
"$ref": "#/definitions/统一响应结果«string»"
}
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"responsesObject": {
"200": {
"description": "OK",
"schema": {
"originalRef": "统一响应结果«string»",
"$ref": "#/definitions/统一响应结果«string»"
}
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"deprecated": false,
"x-order": "2147483647"
}
},
"/admin/insurance/scheme": {
"post": {
"tags": [
"保险方案模板"
],
"summary": "创建方案",
"description": "创建保险方案模板,配置关联保险产品、投保天数规则和费率。创建后默认启用。\n\n**权限**:需管理员登录。",
"operationId": "createSchemeUsingPOST",
"consumes": [
"application/json"
],
"produces": [
"*/*"
],
"parameters": [
{
"in": "body",
"name": "request",
"description": "方案请求",
"required": false,
"schema": {
"originalRef": "保险方案模板请求",
"$ref": "#/definitions/保险方案模板请求"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"originalRef": "统一响应结果«保险方案模板VO»",
"$ref": "#/definitions/统一响应结果«保险方案模板VO»"
}
},
"201": {
"description": "Created"
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"responsesObject": {
"200": {
"description": "OK",
"schema": {
"originalRef": "统一响应结果«保险方案模板VO»",
"$ref": "#/definitions/统一响应结果«保险方案模板VO»"
}
},
"201": {
"description": "Created"
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"deprecated": false,
"x-order": "2147483647"
}
},
"/admin/insurance/scheme/list": {
"get": {
"tags": [
"保险方案模板"
],
"summary": "活跃方案列表(下拉选择用)",
"description": "返回所有状态为启用的保险方案模板,用于投保下单时的方案下拉选择。\n\n**权限**:需管理员登录。",
"operationId": "listActiveSchemesUsingGET",
"produces": [
"*/*"
],
"responses": {
"200": {
"description": "OK",
"schema": {
"originalRef": "统一响应结果«List«保险方案模板VO»»",
"$ref": "#/definitions/统一响应结果«List«保险方案模板VO»»"
}
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"responsesObject": {
"200": {
"description": "OK",
"schema": {
"originalRef": "统一响应结果«List«保险方案模板VO»»",
"$ref": "#/definitions/统一响应结果«List«保险方案模板VO»»"
}
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"deprecated": false,
"x-order": "2147483647"
}
},
"/admin/insurance/scheme/list-all": {
"get": {
"tags": [
"保险方案模板"
],
"summary": "全部方案列表(管理用)",
"description": "返回所有保险方案模板(含启用和停用),用于方案管理页面展示和编辑。\n\n**权限**:需管理员登录。",
"operationId": "listAllSchemesUsingGET",
"produces": [
"*/*"
],
"responses": {
"200": {
"description": "OK",
"schema": {
"originalRef": "统一响应结果«List«保险方案模板VO»»",
"$ref": "#/definitions/统一响应结果«List«保险方案模板VO»»"
}
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"responsesObject": {
"200": {
"description": "OK",
"schema": {
"originalRef": "统一响应结果«List«保险方案模板VO»»",
"$ref": "#/definitions/统一响应结果«List«保险方案模板VO»»"
}
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"deprecated": false,
"x-order": "2147483647"
}
},
"/admin/insurance/scheme/preview-apply": {
"post": {
"tags": [
"保险方案模板"
],
"summary": "预览应用方案(解析日期+估算保费)",
"description": "根据方案模板和行程日期预览投保效果:解析实际投保起止日期、计算每人保费和总保费。用于投保前确认费用。\n\n**权限**:需管理员登录。",
"operationId": "previewApplyUsingPOST",
"consumes": [
"application/json"
],
"produces": [
"*/*"
],
"parameters": [
{
"in": "body",
"name": "request",
"description": "预览请求",
"required": false,
"schema": {
"originalRef": "应用方案预览请求",
"$ref": "#/definitions/应用方案预览请求"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"originalRef": "统一响应结果«方案应用预览VO»",
"$ref": "#/definitions/统一响应结果«方案应用预览VO»"
}
},
"201": {
"description": "Created"
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"responsesObject": {
"200": {
"description": "OK",
"schema": {
"originalRef": "统一响应结果«方案应用预览VO»",
"$ref": "#/definitions/统一响应结果«方案应用预览VO»"
}
},
"201": {
"description": "Created"
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"deprecated": false,
"x-order": "2147483647"
}
},
"/admin/insurance/scheme/{id}": {
"get": {
"tags": [
"保险方案模板"
],
"summary": "方案详情",
"description": "返回单个保险方案模板的完整信息,包含方案名称、保险产品关联、天数规则、费率配置等。\n\n**权限**:需管理员登录。",
"operationId": "getSchemeDetailUsingGET",
"produces": [
"*/*"
],
"parameters": [
{
"name": "id",
"in": "path",
"description": "方案ID",
"required": false,
"type": "integer",
"format": "int64"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"originalRef": "统一响应结果«保险方案模板VO»",
"$ref": "#/definitions/统一响应结果«保险方案模板VO»"
}
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"responsesObject": {
"200": {
"description": "OK",
"schema": {
"originalRef": "统一响应结果«保险方案模板VO»",
"$ref": "#/definitions/统一响应结果«保险方案模板VO»"
}
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"deprecated": false,
"x-order": "2147483647"
},
"put": {
"tags": [
"保险方案模板"
],
"summary": "更新方案",
"description": "更新保险方案模板的配置信息,包括方案名称、关联产品、天数规则、费率等。\n\n**权限**:需管理员登录。",
"operationId": "updateSchemeUsingPUT",
"consumes": [
"application/json"
],
"produces": [
"*/*"
],
"parameters": [
{
"name": "id",
"in": "path",
"description": "方案ID",
"required": false,
"type": "integer",
"format": "int64"
},
{
"in": "body",
"name": "request",
"description": "方案请求",
"required": false,
"schema": {
"originalRef": "保险方案模板请求",
"$ref": "#/definitions/保险方案模板请求"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"originalRef": "统一响应结果«保险方案模板VO»",
"$ref": "#/definitions/统一响应结果«保险方案模板VO»"
}
},
"201": {
"description": "Created"
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"responsesObject": {
"200": {
"description": "OK",
"schema": {
"originalRef": "统一响应结果«保险方案模板VO»",
"$ref": "#/definitions/统一响应结果«保险方案模板VO»"
}
},
"201": {
"description": "Created"
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"deprecated": false,
"x-order": "2147483647"
},
"delete": {
"tags": [
"保险方案模板"
],
"summary": "删除方案(软删除)",
"description": "软删除保险方案模板。已使用该方案创建的保险订单不受影响。\n\n**权限**:需管理员登录。",
"operationId": "deleteSchemeUsingDELETE",
"produces": [
"*/*"
],
"parameters": [
{
"name": "id",
"in": "path",
"description": "方案ID",
"required": false,
"type": "integer",
"format": "int64"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"originalRef": "统一响应结果«Void»",
"$ref": "#/definitions/统一响应结果«Void»"
}
},
"204": {
"description": "No Content"
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
}
},
"responsesObject": {
"200": {
"description": "OK",
"schema": {
"originalRef": "统一响应结果«Void»",
"$ref": "#/definitions/统一响应结果«Void»"
}
},
"204": {
"description": "No Content"
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
}
},
"deprecated": false,
"x-order": "2147483647"
}
},
"/admin/insurance/scheme/{id}/toggle-status": {
"put": {
"tags": [
"保险方案模板"
],
"summary": "切换方案状态(启用/停用)",
"description": "切换保险方案模板的启用/停用状态。停用后不会出现在投保下单的方案选择列表中。\n\n**权限**:需管理员登录。\n\n**关联字典**\n- common_status通用状态ACTIVE=启用/INACTIVE=停用)",
"operationId": "toggleStatusUsingPUT",
"consumes": [
"application/json"
],
"produces": [
"*/*"
],
"parameters": [
{
"name": "id",
"in": "path",
"description": "方案ID",
"required": false,
"type": "integer",
"format": "int64"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"originalRef": "统一响应结果«保险方案模板VO»",
"$ref": "#/definitions/统一响应结果«保险方案模板VO»"
}
},
"201": {
"description": "Created"
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"responsesObject": {
"200": {
"description": "OK",
"schema": {
"originalRef": "统一响应结果«保险方案模板VO»",
"$ref": "#/definitions/统一响应结果«保险方案模板VO»"
}
},
"201": {
"description": "Created"
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"deprecated": false,
"x-order": "2147483647"
}
},
"/admin/insurance/share-policy": {
"post": {
"tags": [
"保险管理"
],
"summary": "分享保单(合并某出行人所有有效保单PDF,上传OSS返回链接)",
"description": "合并指定出行人的所有有效保单PDF为一个文件,上传至OSS后返回公开访问链接。用于管理端分享保单给出行人。\n\n**权限**:需管理员登录。",
"operationId": "sharePolicyUsingPOST",
"consumes": [
"application/json"
],
"produces": [
"*/*"
],
"parameters": [
{
"in": "body",
"name": "request",
"description": "分享保单请求",
"required": false,
"schema": {
"originalRef": "保单分享请求",
"$ref": "#/definitions/保单分享请求"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"originalRef": "统一响应结果«保单分享结果»",
"$ref": "#/definitions/统一响应结果«保单分享结果»"
}
},
"201": {
"description": "Created"
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"responsesObject": {
"200": {
"description": "OK",
"schema": {
"originalRef": "统一响应结果«保单分享结果»",
"$ref": "#/definitions/统一响应结果«保单分享结果»"
}
},
"201": {
"description": "Created"
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"deprecated": false,
"x-order": "2147483647"
}
},
"/admin/insurance/sync-products": {
"post": {
"tags": [
"保险管理"
],
"summary": "从保游网同步产品数据",
"description": "手动触发从保游网API拉取最新保险产品数据含计划和费率,同步到本地数据库。返回同步的产品数量。\n\n**权限**:需管理员登录。",
"operationId": "syncProductsUsingPOST",
"consumes": [
"application/json"
],
"produces": [
"*/*"
],
"responses": {
"200": {
"description": "OK",
"schema": {
"originalRef": "统一响应结果«int»",
"$ref": "#/definitions/统一响应结果«int»"
}
},
"201": {
"description": "Created"
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"responsesObject": {
"200": {
"description": "OK",
"schema": {
"originalRef": "统一响应结果«int»",
"$ref": "#/definitions/统一响应结果«int»"
}
},
"201": {
"description": "Created"
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"deprecated": false,
"x-order": "2147483647"
}
},
"/admin/insurance/trial-price": {
"post": {
"tags": [
"保险管理"
],
"summary": "保费试算(本地费率)",
"description": "根据保险计划、投保天数和人数,使用本地同步的费率表试算保费。不调用保游网API,用于投保前的费用预估。\n\n**权限**:需管理员登录。",
"operationId": "trialPriceUsingPOST",
"consumes": [
"application/json"
],
"produces": [
"*/*"
],
"parameters": [
{
"in": "body",
"name": "request",
"description": "试算请求",
"required": false,
"schema": {
"originalRef": "保费试算请求",
"$ref": "#/definitions/保费试算请求"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"originalRef": "统一响应结果«Map«string,object»»",
"$ref": "#/definitions/统一响应结果«Map«string,object»»"
}
},
"201": {
"description": "Created"
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"responsesObject": {
"200": {
"description": "OK",
"schema": {
"originalRef": "统一响应结果«Map«string,object»»",
"$ref": "#/definitions/统一响应结果«Map«string,object»»"
}
},
"201": {
"description": "Created"
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"deprecated": false,
"x-order": "2147483647"
}
}
},
"definitions": {
"JsonNode": {
"type": "object",
"title": "JsonNode"
},
"Map«string,string»": {
"type": "object",
"title": "Map«string,string»",
"additionalProperties": {
"type": "string"
}
},
"保单分享结果": {
"type": "object",
"properties": {
"failedCount": {
"type": "integer",
"format": "int32",
"description": "下载失败的保单数量(已跳过)"
},
"pdfBase64": {
"type": "string",
"description": "合并后的PDFBase64编码"
},
"personName": {
"type": "string",
"description": "被保人姓名"
},
"policyCount": {
"type": "integer",
"format": "int32",
"description": "包含的保单数量"
}
},
"title": "保单分享结果"
},
"保单分享请求": {
"type": "object",
"required": [
"insuredIdCardNo",
"insuredName",
"orderId"
],
"properties": {
"insuredIdCardNo": {
"type": "string",
"description": "被保人证件号码"
},
"insuredName": {
"type": "string",
"description": "被保人姓名"
},
"orderId": {
"type": "integer",
"format": "int64",
"description": "旅游订单ID"
}
},
"title": "保单分享请求"
},
"保费试算请求": {
"type": "object",
"required": [
"endDate",
"insuredCount",
"planId",
"startDate"
],
"properties": {
"endDate": {
"type": "string",
"format": "date",
"example": "2026-05-05",
"description": "保障结束日期"
},
"insuredCount": {
"type": "integer",
"format": "int32",
"example": 3,
"description": "被保人数量"
},
"planId": {
"type": "integer",
"format": "int64",
"example": 2026279738275856390,
"description": "保险计划ID"
},
"startDate": {
"type": "string",
"format": "date",
"example": "2026-05-01",
"description": "保障开始日期"
}
},
"title": "保费试算请求"
},
"保险产品VO": {
"type": "object",
"properties": {
"companyName": {
"type": "string",
"example": "中国平安",
"description": "保险公司名称"
},
"createTime": {
"type": "string",
"format": "date-time",
"description": "同步时间"
},
"extProductGuid": {
"type": "string",
"example": "4810725b34654e1e88a7509e5b241c3a",
"description": "保游网产品GUID"
},
"isOverseas": {
"type": "boolean",
"example": false,
"description": "是否境外产品"
},
"maxAge": {
"type": "integer",
"format": "int32",
"example": 85,
"description": "最大投保年龄"
},
"maxDays": {
"type": "integer",
"format": "int32",
"example": 365,
"description": "最长保障天数"
},
"minAge": {
"type": "integer",
"format": "int32",
"example": 0,
"description": "最小投保年龄"
},
"minDays": {
"type": "integer",
"format": "int32",
"example": 1,
"description": "最短保障天数"
},
"productId": {
"type": "integer",
"format": "int64",
"example": 2026279738275856385,
"description": "保险产品ID"
},
"productName": {
"type": "string",
"example": "畅游神州境内游(旅行社专享)",
"description": "产品名称"
},
"productType": {
"type": "string",
"description": "产品类型"
},
"status": {
"type": "string",
"example": "ACTIVE",
"description": "产品状态: ACTIVE-已上架, INACTIVE-已下架"
}
},
"title": "保险产品VO"
},
"保险方案模板VO": {
"type": "object",
"properties": {
"adminId": {
"type": "integer",
"format": "int64",
"example": 100,
"description": "创建人ID"
},
"createTime": {
"type": "string",
"format": "date-time",
"description": "创建时间"
},
"description": {
"type": "string",
"example": "适用于7日国内行程",
"description": "方案描述"
},
"isOverseas": {
"type": "boolean",
"example": false,
"description": "是否境外"
},
"name": {
"type": "string",
"example": "7日标准方案",
"description": "方案名称"
},
"schemeId": {
"type": "integer",
"format": "int64",
"example": 2026279738275856500,
"description": "方案ID"
},
"segmentCount": {
"type": "integer",
"format": "int32",
"example": 2,
"description": "段数量"
},
"segments": {
"type": "array",
"description": "方案段列表",
"items": {
"originalRef": "保险方案段VO",
"$ref": "#/definitions/保险方案段VO"
}
},
"sortOrder": {
"type": "integer",
"format": "int32",
"example": 0,
"description": "排序序号"
},
"status": {
"type": "string",
"example": "ACTIVE",
"description": "状态: ACTIVE-启用, INACTIVE-停用"
}
},
"title": "保险方案模板VO"
},
"保险方案模板请求": {
"type": "object",
"required": [
"isOverseas",
"name",
"segments"
],
"properties": {
"description": {
"type": "string",
"example": "适用于7日国内行程,含前段境内险和后段高原险",
"description": "方案描述"
},
"isOverseas": {
"type": "boolean",
"example": false,
"description": "是否境外: false=境内, true=境外"
},
"name": {
"type": "string",
"example": "7日标准方案",
"description": "方案名称"
},
"segments": {
"type": "array",
"description": "保险段列表",
"items": {
"originalRef": "保险方案段",
"$ref": "#/definitions/保险方案段"
}
},
"sortOrder": {
"type": "integer",
"format": "int32",
"example": 0,
"description": "排序序号(越小越靠前)"
}
},
"title": "保险方案模板请求"
},
"保险方案段": {
"type": "object",
"required": [
"dayOffsetEnd",
"dayOffsetStart",
"planId",
"productId"
],
"properties": {
"dayOffsetEnd": {
"type": "integer",
"format": "int32",
"example": 3,
"description": "相对结束天(1-based, -1=行程最后一天)"
},
"dayOffsetStart": {
"type": "integer",
"format": "int32",
"example": 1,
"description": "相对起始天(1-based, 1=出发日)"
},
"planId": {
"type": "integer",
"format": "int64",
"example": 2026279738275856390,
"description": "保险计划ID"
},
"productId": {
"type": "integer",
"format": "int64",
"example": 2026279738275856385,
"description": "保险产品ID"
},
"segmentName": {
"type": "string",
"example": "前段-境内险",
"description": "段名称"
},
"sortOrder": {
"type": "integer",
"format": "int32",
"example": 0,
"description": "段排序序号"
}
},
"title": "保险方案段"
},
"保险方案段VO": {
"type": "object",
"properties": {
"dayOffsetEnd": {
"type": "integer",
"format": "int32",
"example": 3,
"description": "相对结束天(-1=最后一天)"
},
"dayOffsetStart": {
"type": "integer",
"format": "int32",
"example": 1,
"description": "相对起始天"
},
"planId": {
"type": "integer",
"format": "int64",
"example": 2026279738275856390,
"description": "保险计划ID"
},
"planName": {
"type": "string",
"example": "经济版",
"description": "保险计划名称"
},
"productId": {
"type": "integer",
"format": "int64",
"example": 2026279738275856385,
"description": "保险产品ID"
},
"productName": {
"type": "string",
"example": "畅游神州境内游(旅行社专享)",
"description": "保险产品名称"
},
"segmentId": {
"type": "integer",
"format": "int64",
"example": 2026279738275856510,
"description": "段ID"
},
"segmentName": {
"type": "string",
"example": "前段-境内险",
"description": "段名称"
},
"sortOrder": {
"type": "integer",
"format": "int32",
"example": 0,
"description": "段排序序号"
}
},
"title": "保险方案段VO"
},
"保险计划VO": {
"type": "object",
"properties": {
"extPlanGuid": {
"type": "string",
"example": "abc123",
"description": "保游网计划GUID"
},
"planId": {
"type": "integer",
"format": "int64",
"example": 2026279738275856390,
"description": "计划ID"
},
"planName": {
"type": "string",
"example": "经济版",
"description": "计划名称"
},
"productId": {
"type": "integer",
"format": "int64",
"example": 2026279738275856385,
"description": "所属产品ID"
},
"rates": {
"type": "array",
"description": "费率列表",
"items": {
"originalRef": "保险费率VO",
"$ref": "#/definitions/保险费率VO"
}
},
"securityList": {
"type": "string",
"example": "<table>...</table>",
"description": "保障内容(HTML)"
}
},
"title": "保险计划VO"
},
"保险订单VO": {
"type": "object",
"properties": {
"createTime": {
"type": "string",
"format": "date-time",
"description": "创建时间"
},
"endDate": {
"type": "string",
"format": "date",
"example": "2026-05-05",
"description": "保障结束日期"
},
"entityCode": {
"type": "string",
"example": "hulai",
"description": "投保公司主体编码"
},
"extOrderNo": {
"type": "string",
"example": "BYW202602250001",
"description": "保游网订单号"
},
"extPolicyNo": {
"type": "string",
"example": "P202602250001",
"description": "保单号"
},
"insuranceOrderId": {
"type": "integer",
"format": "int64",
"example": 2026279738275856400,
"description": "保险订单ID"
},
"insuredCount": {
"type": "integer",
"format": "int32",
"example": 3,
"description": "被保人数量"
},
"orderId": {
"type": "integer",
"format": "int64",
"example": 2026270000000000001,
"description": "关联旅行订单ID"
},
"planId": {
"type": "integer",
"format": "int64",
"example": 2026279738275856390,
"description": "保险计划ID"
},
"planName": {
"type": "string",
"example": "经济版",
"description": "保险计划名称"
},
"policyHolderName": {
"type": "string",
"example": "内蒙古呼籁国际旅行社有限公司",
"description": "投保人姓名(公司名称)"
},
"productId": {
"type": "integer",
"format": "int64",
"example": 2026279738275856385,
"description": "保险产品ID"
},
"productName": {
"type": "string",
"example": "畅游神州境内游(旅行社专享)",
"description": "保险产品名称"
},
"remark": {
"type": "string",
"description": "备注"
},
"startDate": {
"type": "string",
"format": "date",
"example": "2026-05-01",
"description": "保障开始日期"
},
"status": {
"type": "string",
"example": "INSURED",
"description": "订单状态: PENDING-待出单, INSURED-已承保, CANCELLED-已退保, FAILED-投保失败"
},
"statusLabel": {
"type": "string",
"example": "已承保",
"description": "状态中文标签"
},
"totalPremium": {
"type": "number",
"example": 45.0,
"description": "总保费(元)"
}
},
"title": "保险订单VO"
},
"保险订单详情VO": {
"type": "object",
"properties": {
"createTime": {
"type": "string",
"format": "date-time",
"description": "创建时间"
},
"endDate": {
"type": "string",
"format": "date",
"example": "2026-05-05",
"description": "保障结束日期"
},
"entityCode": {
"type": "string",
"example": "hulai",
"description": "投保公司主体编码"
},
"extOrderNo": {
"type": "string",
"example": "BYW202602250001",
"description": "保游网订单号"
},
"extPolicyNo": {
"type": "string",
"example": "P202602250001",
"description": "保单号"
},
"insuranceOrderId": {
"type": "integer",
"format": "int64",
"example": 2026279738275856400,
"description": "保险订单ID"
},
"insuredCount": {
"type": "integer",
"format": "int32",
"example": 3,
"description": "被保人数量"
},
"insuredPersons": {
"type": "array",
"description": "被保人列表",
"items": {
"originalRef": "被保人信息VO",
"$ref": "#/definitions/被保人信息VO"
}
},
"orderId": {
"type": "integer",
"format": "int64",
"example": 2026270000000000001,
"description": "关联旅行订单ID"
},
"planId": {
"type": "integer",
"format": "int64",
"example": 2026279738275856390,
"description": "保险计划ID"
},
"planName": {
"type": "string",
"example": "经济版",
"description": "保险计划名称"
},
"policyHolderName": {
"type": "string",
"example": "内蒙古呼籁国际旅行社有限公司",
"description": "投保人姓名(公司名称)"
},
"productId": {
"type": "integer",
"format": "int64",
"example": 2026279738275856385,
"description": "保险产品ID"
},
"productName": {
"type": "string",
"example": "畅游神州境内游(旅行社专享)",
"description": "保险产品名称"
},
"remark": {
"type": "string",
"description": "备注"
},
"startDate": {
"type": "string",
"format": "date",
"example": "2026-05-01",
"description": "保障开始日期"
},
"status": {
"type": "string",
"example": "INSURED",
"description": "订单状态: PENDING-待出单, INSURED-已承保, CANCELLED-已退保, FAILED-投保失败"
},
"statusLabel": {
"type": "string",
"example": "已承保",
"description": "状态中文标签"
},
"totalPremium": {
"type": "number",
"example": 45.0,
"description": "总保费(元)"
}
},
"title": "保险订单详情VO"
},
"保险费率VO": {
"type": "object",
"properties": {
"ageRange": {
"type": "string",
"example": "0-85",
"description": "适用年龄范围"
},
"dayRange": {
"type": "string",
"example": "4-7",
"description": "适用天数范围(如 1, 2, 4-7)"
},
"dayType": {
"type": "string",
"example": 10,
"description": "天数类型: 10-按天, 20-按月, 30-按年"
},
"extRateCode": {
"type": "string",
"example": "RATE001",
"description": "保游网费率编码"
},
"premium": {
"type": "number",
"example": 15.0,
"description": "单人保费(元)"
},
"rateId": {
"type": "integer",
"format": "int64",
"example": 2026279738275856395,
"description": "费率ID"
}
},
"title": "保险费率VO"
},
"充值请求": {
"type": "object",
"required": [
"money",
"payType"
],
"properties": {
"backUrl": {
"type": "string",
"example": "http://localhost:5173/insurance",
"description": "同步回调地址(支付宝用)"
},
"money": {
"type": "number",
"example": 100.0,
"description": "充值金额(元)"
},
"payType": {
"type": "integer",
"format": "int32",
"example": 11,
"description": "支付方式11=支付宝扫码, 33=微信扫码"
}
},
"title": "充值请求"
},
"分页结果«保险产品VO»": {
"type": "object",
"properties": {
"page": {
"type": "integer",
"format": "int32",
"example": 1,
"description": "当前页码"
},
"pageSize": {
"type": "integer",
"format": "int32",
"example": 20,
"description": "每页条数"
},
"records": {
"type": "array",
"description": "数据列表",
"items": {
"originalRef": "保险产品VO",
"$ref": "#/definitions/保险产品VO"
}
},
"total": {
"type": "integer",
"format": "int32",
"example": 100,
"description": "总记录数"
}
},
"title": "分页结果«保险产品VO»"
},
"分页结果«保险订单VO»": {
"type": "object",
"properties": {
"page": {
"type": "integer",
"format": "int32",
"example": 1,
"description": "当前页码"
},
"pageSize": {
"type": "integer",
"format": "int32",
"example": 20,
"description": "每页条数"
},
"records": {
"type": "array",
"description": "数据列表",
"items": {
"originalRef": "保险订单VO",
"$ref": "#/definitions/保险订单VO"
}
},
"total": {
"type": "integer",
"format": "int32",
"example": 100,
"description": "总记录数"
}
},
"title": "分页结果«保险订单VO»"
},
"应用方案预览请求": {
"type": "object",
"required": [
"orderId",
"schemeId"
],
"properties": {
"departureDate": {
"type": "string",
"format": "date",
"example": "2026-07-01",
"description": "出发日期(可选,不传则从订单获取)"
},
"insuredCount": {
"type": "integer",
"format": "int32",
"example": 4,
"description": "被保人数量(可选,不传则从订单获取出行人数)"
},
"orderId": {
"type": "integer",
"format": "int64",
"example": 2026270000000000001,
"description": "旅行订单ID用于获取出发/返回日期和出行人数)"
},
"returnDate": {
"type": "string",
"format": "date",
"example": "2026-07-07",
"description": "返回日期(可选,不传则从订单获取)"
},
"schemeId": {
"type": "integer",
"format": "int64",
"example": 2026279738275856500,
"description": "方案ID"
}
},
"title": "应用方案预览请求"
},
"投保请求": {
"type": "object",
"required": [
"endDate",
"insuredPersons",
"planId",
"startDate"
],
"properties": {
"endDate": {
"type": "string",
"format": "date",
"example": "2026-05-05",
"description": "保障结束日期"
},
"entityCode": {
"type": "string",
"example": "hulai",
"description": "投保公司主体编码(不填则使用默认主体)"
},
"insuredPersons": {
"type": "array",
"description": "被保人列表(至少1人)",
"items": {
"originalRef": "被保人/投保人信息",
"$ref": "#/definitions/被保人/投保人信息"
}
},
"orderId": {
"type": "integer",
"format": "int64",
"example": 2026270000000000001,
"description": "关联旅行订单ID(可选)"
},
"planId": {
"type": "integer",
"format": "int64",
"example": 2026279738275856390,
"description": "保险计划ID"
},
"remark": {
"type": "string",
"description": "备注"
},
"startDate": {
"type": "string",
"format": "date",
"example": "2026-05-01",
"description": "保障开始日期"
}
},
"title": "投保请求"
},
"方案应用预览VO": {
"type": "object",
"properties": {
"departureDate": {
"type": "string",
"format": "date",
"example": "2026-07-01",
"description": "行程出发日期"
},
"insuredCount": {
"type": "integer",
"format": "int32",
"example": 4,
"description": "被保人数量"
},
"returnDate": {
"type": "string",
"format": "date",
"example": "2026-07-07",
"description": "行程返回日期"
},
"schemeId": {
"type": "integer",
"format": "int64",
"example": 2026279738275856500,
"description": "方案ID"
},
"schemeName": {
"type": "string",
"example": "7日标准方案",
"description": "方案名称"
},
"segments": {
"type": "array",
"description": "解析后的保险段列表",
"items": {
"originalRef": "解析后的保险段",
"$ref": "#/definitions/解析后的保险段"
}
},
"totalEstimatedPremium": {
"type": "number",
"example": 320.0,
"description": "预估总保费(所有段合计)"
},
"tripDays": {
"type": "integer",
"format": "int32",
"example": 7,
"description": "行程天数"
},
"warnings": {
"type": "array",
"description": "警告信息(如日期间隙、重叠、超出行程范围等)",
"items": {
"type": "string"
}
}
},
"title": "方案应用预览VO"
},
"统一响应结果«JsonNode»": {
"type": "object",
"properties": {
"code": {
"type": "integer",
"format": "int32",
"example": 200,
"description": "状态码"
},
"data": {
"description": "响应数据",
"originalRef": "JsonNode",
"$ref": "#/definitions/JsonNode"
},
"message": {
"type": "string",
"example": "成功",
"description": "响应消息"
}
},
"title": "统一响应结果«JsonNode»"
},
"统一响应结果«List«Map«string,string»»»": {
"type": "object",
"properties": {
"code": {
"type": "integer",
"format": "int32",
"example": 200,
"description": "状态码"
},
"data": {
"type": "array",
"description": "响应数据",
"items": {
"originalRef": "Map«string,string»",
"$ref": "#/definitions/Map«string,string»"
}
},
"message": {
"type": "string",
"example": "成功",
"description": "响应消息"
}
},
"title": "统一响应结果«List«Map«string,string»»»"
},
"统一响应结果«List«保险方案模板VO»»": {
"type": "object",
"properties": {
"code": {
"type": "integer",
"format": "int32",
"example": 200,
"description": "状态码"
},
"data": {
"type": "array",
"description": "响应数据",
"items": {
"originalRef": "保险方案模板VO",
"$ref": "#/definitions/保险方案模板VO"
}
},
"message": {
"type": "string",
"example": "成功",
"description": "响应消息"
}
},
"title": "统一响应结果«List«保险方案模板VO»»"
},
"统一响应结果«List«保险计划VO»»": {
"type": "object",
"properties": {
"code": {
"type": "integer",
"format": "int32",
"example": 200,
"description": "状态码"
},
"data": {
"type": "array",
"description": "响应数据",
"items": {
"originalRef": "保险计划VO",
"$ref": "#/definitions/保险计划VO"
}
},
"message": {
"type": "string",
"example": "成功",
"description": "响应消息"
}
},
"title": "统一响应结果«List«保险计划VO»»"
},
"统一响应结果«List«保险订单VO»»": {
"type": "object",
"properties": {
"code": {
"type": "integer",
"format": "int32",
"example": 200,
"description": "状态码"
},
"data": {
"type": "array",
"description": "响应数据",
"items": {
"originalRef": "保险订单VO",
"$ref": "#/definitions/保险订单VO"
}
},
"message": {
"type": "string",
"example": "成功",
"description": "响应消息"
}
},
"title": "统一响应结果«List«保险订单VO»»"
},
"统一响应结果«List«保险订单详情VO»»": {
"type": "object",
"properties": {
"code": {
"type": "integer",
"format": "int32",
"example": 200,
"description": "状态码"
},
"data": {
"type": "array",
"description": "响应数据",
"items": {
"originalRef": "保险订单详情VO",
"$ref": "#/definitions/保险订单详情VO"
}
},
"message": {
"type": "string",
"example": "成功",
"description": "响应消息"
}
},
"title": "统一响应结果«List«保险订单详情VO»»"
},
"统一响应结果«Map«string,object»»": {
"type": "object",
"properties": {
"code": {
"type": "integer",
"format": "int32",
"example": 200,
"description": "状态码"
},
"data": {
"type": "object",
"description": "响应数据"
},
"message": {
"type": "string",
"example": "成功",
"description": "响应消息"
}
},
"title": "统一响应结果«Map«string,object»»"
},
"统一响应结果«Void»": {
"type": "object",
"properties": {
"code": {
"type": "integer",
"format": "int32",
"example": 200,
"description": "状态码"
},
"message": {
"type": "string",
"example": "成功",
"description": "响应消息"
}
},
"title": "统一响应结果«Void»"
},
"统一响应结果«int»": {
"type": "object",
"properties": {
"code": {
"type": "integer",
"format": "int32",
"example": 200,
"description": "状态码"
},
"data": {
"type": "integer",
"format": "int32",
"description": "响应数据"
},
"message": {
"type": "string",
"example": "成功",
"description": "响应消息"
}
},
"title": "统一响应结果«int»"
},
"统一响应结果«string»": {
"type": "object",
"properties": {
"code": {
"type": "integer",
"format": "int32",
"example": 200,
"description": "状态码"
},
"data": {
"type": "string",
"description": "响应数据"
},
"message": {
"type": "string",
"example": "成功",
"description": "响应消息"
}
},
"title": "统一响应结果«string»"
},
"统一响应结果«保单分享结果»": {
"type": "object",
"properties": {
"code": {
"type": "integer",
"format": "int32",
"example": 200,
"description": "状态码"
},
"data": {
"description": "响应数据",
"originalRef": "保单分享结果",
"$ref": "#/definitions/保单分享结果"
},
"message": {
"type": "string",
"example": "成功",
"description": "响应消息"
}
},
"title": "统一响应结果«保单分享结果»"
},
"统一响应结果«保险产品VO»": {
"type": "object",
"properties": {
"code": {
"type": "integer",
"format": "int32",
"example": 200,
"description": "状态码"
},
"data": {
"description": "响应数据",
"originalRef": "保险产品VO",
"$ref": "#/definitions/保险产品VO"
},
"message": {
"type": "string",
"example": "成功",
"description": "响应消息"
}
},
"title": "统一响应结果«保险产品VO»"
},
"统一响应结果«保险方案模板VO»": {
"type": "object",
"properties": {
"code": {
"type": "integer",
"format": "int32",
"example": 200,
"description": "状态码"
},
"data": {
"description": "响应数据",
"originalRef": "保险方案模板VO",
"$ref": "#/definitions/保险方案模板VO"
},
"message": {
"type": "string",
"example": "成功",
"description": "响应消息"
}
},
"title": "统一响应结果«保险方案模板VO»"
},
"统一响应结果«保险订单VO»": {
"type": "object",
"properties": {
"code": {
"type": "integer",
"format": "int32",
"example": 200,
"description": "状态码"
},
"data": {
"description": "响应数据",
"originalRef": "保险订单VO",
"$ref": "#/definitions/保险订单VO"
},
"message": {
"type": "string",
"example": "成功",
"description": "响应消息"
}
},
"title": "统一响应结果«保险订单VO»"
},
"统一响应结果«保险订单详情VO»": {
"type": "object",
"properties": {
"code": {
"type": "integer",
"format": "int32",
"example": 200,
"description": "状态码"
},
"data": {
"description": "响应数据",
"originalRef": "保险订单详情VO",
"$ref": "#/definitions/保险订单详情VO"
},
"message": {
"type": "string",
"example": "成功",
"description": "响应消息"
}
},
"title": "统一响应结果«保险订单详情VO»"
},
"统一响应结果«分页结果«保险产品VO»»": {
"type": "object",
"properties": {
"code": {
"type": "integer",
"format": "int32",
"example": 200,
"description": "状态码"
},
"data": {
"description": "响应数据",
"originalRef": "分页结果«保险产品VO»",
"$ref": "#/definitions/分页结果«保险产品VO»"
},
"message": {
"type": "string",
"example": "成功",
"description": "响应消息"
}
},
"title": "统一响应结果«分页结果«保险产品VO»»"
},
"统一响应结果«分页结果«保险订单VO»»": {
"type": "object",
"properties": {
"code": {
"type": "integer",
"format": "int32",
"example": 200,
"description": "状态码"
},
"data": {
"description": "响应数据",
"originalRef": "分页结果«保险订单VO»",
"$ref": "#/definitions/分页结果«保险订单VO»"
},
"message": {
"type": "string",
"example": "成功",
"description": "响应消息"
}
},
"title": "统一响应结果«分页结果«保险订单VO»»"
},
"统一响应结果«方案应用预览VO»": {
"type": "object",
"properties": {
"code": {
"type": "integer",
"format": "int32",
"example": 200,
"description": "状态码"
},
"data": {
"description": "响应数据",
"originalRef": "方案应用预览VO",
"$ref": "#/definitions/方案应用预览VO"
},
"message": {
"type": "string",
"example": "成功",
"description": "响应消息"
}
},
"title": "统一响应结果«方案应用预览VO»"
},
"统一响应结果«订单保险保障VO»": {
"type": "object",
"properties": {
"code": {
"type": "integer",
"format": "int32",
"example": 200,
"description": "状态码"
},
"data": {
"description": "响应数据",
"originalRef": "订单保险保障VO",
"$ref": "#/definitions/订单保险保障VO"
},
"message": {
"type": "string",
"example": "成功",
"description": "响应消息"
}
},
"title": "统一响应结果«订单保险保障VO»"
},
"被保人/投保人信息": {
"type": "object",
"required": [
"birthday",
"gender",
"idCardNo",
"name"
],
"properties": {
"birthday": {
"type": "string",
"format": "date",
"example": "1990-01-01",
"description": "出生日期"
},
"gender": {
"type": "string",
"example": "MALE",
"description": "性别: MALE-男, FEMALE-女"
},
"idCardNo": {
"type": "string",
"example": 110101199001011234,
"description": "证件号码"
},
"idCardType": {
"type": "string",
"example": "ID_CARD",
"description": "证件类型: ID_CARD-身份证, PASSPORT-护照, OTHER-其他"
},
"isBeneficiary": {
"type": "boolean",
"example": false,
"description": "是否为受益人"
},
"name": {
"type": "string",
"example": "李四",
"description": "姓名"
},
"phone": {
"type": "string",
"example": 13800138000,
"description": "手机号"
}
},
"title": "被保人/投保人信息"
},
"被保人信息VO": {
"type": "object",
"properties": {
"birthday": {
"type": "string",
"format": "date",
"example": "1990-01-01",
"description": "出生日期"
},
"gender": {
"type": "string",
"example": "MALE",
"description": "性别: MALE-男, FEMALE-女"
},
"idCardNo": {
"type": "string",
"example": 110101199001011234,
"description": "证件号码"
},
"idCardType": {
"type": "string",
"example": "ID_CARD",
"description": "证件类型: ID_CARD-身份证, PASSPORT-护照, OTHER-其他"
},
"insuredId": {
"type": "integer",
"format": "int64",
"example": 2026279738275856410,
"description": "被保人ID"
},
"isBeneficiary": {
"type": "boolean",
"example": false,
"description": "是否为受益人"
},
"name": {
"type": "string",
"example": "李四",
"description": "姓名"
},
"phone": {
"type": "string",
"example": 13800138000,
"description": "手机号"
}
},
"title": "被保人信息VO"
},
"解析后的保险段": {
"type": "object",
"properties": {
"coverageDays": {
"type": "integer",
"format": "int32",
"example": 3,
"description": "覆盖天数"
},
"dayOffsetEnd": {
"type": "integer",
"format": "int32",
"example": 3,
"description": "原始结束天偏移"
},
"dayOffsetStart": {
"type": "integer",
"format": "int32",
"example": 1,
"description": "原始起始天偏移"
},
"estimatedPremium": {
"type": "number",
"example": 60.0,
"description": "该段预估总保费(单人保费 x 人数)"
},
"planId": {
"type": "integer",
"format": "int64",
"example": 2026279738275856390,
"description": "保险计划ID"
},
"planName": {
"type": "string",
"example": "经济版",
"description": "保险计划名称"
},
"productId": {
"type": "integer",
"format": "int64",
"example": 2026279738275856385,
"description": "保险产品ID"
},
"productName": {
"type": "string",
"example": "畅游神州境内游(旅行社专享)",
"description": "保险产品名称"
},
"resolvedEndDate": {
"type": "string",
"format": "date",
"example": "2026-07-03",
"description": "解析后的实际结束日期"
},
"resolvedStartDate": {
"type": "string",
"format": "date",
"example": "2026-07-01",
"description": "解析后的实际开始日期"
},
"segmentName": {
"type": "string",
"example": "前段-境内险",
"description": "段名称"
},
"skipReason": {
"type": "string",
"description": "跳过原因"
},
"skipped": {
"type": "boolean",
"example": false,
"description": "是否被跳过(超出行程范围)"
},
"unitPremium": {
"type": "number",
"example": 15.0,
"description": "单人保费"
}
},
"title": "解析后的保险段"
},
"订单保险保障VO": {
"type": "object",
"properties": {
"insuranceOrders": {
"type": "array",
"description": "保险订单详情列表(含被保人)",
"items": {
"originalRef": "保险订单详情VO",
"$ref": "#/definitions/保险订单详情VO"
}
},
"orderCount": {
"type": "integer",
"format": "int32",
"example": 2,
"description": "保险单数量"
},
"orderId": {
"type": "integer",
"format": "int64",
"example": 2026270000000000001,
"description": "旅行订单ID"
}
},
"title": "订单保险保障VO"
}
}
}