4391 lines
127 KiB
JSON
4391 lines
127 KiB
JSON
{
|
||
"openapi": "3.0.1",
|
||
"info": {
|
||
"title": "One Pipe package silence admin API - Apifox snapshot",
|
||
"version": "2026-10-28",
|
||
"description": "21 order-silence and first-purchase operations. Read-only snapshot; refresh the source export when Apifox changes."
|
||
},
|
||
"paths": {
|
||
"/api/admin/assets/{asset_type}/{id}/first-purchase-records": {
|
||
"get": {
|
||
"summary": "资产首次购买套餐记录",
|
||
"deprecated": false,
|
||
"description": "按资产查看各世代首次购买套餐记录（首次购买套餐时间、来源（首次购买套餐 / 历史回填）、订单号、结束时间与原因）；换货后的新资产在当前世代真正购买套餐后才有记录；只读。",
|
||
"tags": [
|
||
"卡管/资产 - 首次购买套餐时间",
|
||
"资产 - 首次购买套餐时间"
|
||
],
|
||
"parameters": [
|
||
{
|
||
"name": "asset_type",
|
||
"in": "path",
|
||
"description": "资产类型 card/iot_card/device",
|
||
"required": true,
|
||
"example": "",
|
||
"schema": {
|
||
"description": "资产类型 card/iot_card/device",
|
||
"type": "string"
|
||
}
|
||
},
|
||
{
|
||
"name": "id",
|
||
"in": "path",
|
||
"description": "资产 ID",
|
||
"required": true,
|
||
"example": 0,
|
||
"schema": {
|
||
"description": "资产 ID",
|
||
"minimum": 0,
|
||
"type": "integer"
|
||
}
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "成功",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"properties": {
|
||
"code": {
|
||
"description": "响应码",
|
||
"type": "integer",
|
||
"examples": [
|
||
0
|
||
]
|
||
},
|
||
"data": {
|
||
"items": {
|
||
"$ref": "#/components/schemas/DtoAssetFirstPurchaseRecordResponse"
|
||
},
|
||
"type": "array"
|
||
},
|
||
"msg": {
|
||
"description": "响应消息",
|
||
"type": "string",
|
||
"examples": [
|
||
"success"
|
||
]
|
||
},
|
||
"timestamp": {
|
||
"description": "时间戳",
|
||
"format": "date-time",
|
||
"type": "string"
|
||
}
|
||
},
|
||
"required": [
|
||
"code",
|
||
"data",
|
||
"msg",
|
||
"timestamp"
|
||
],
|
||
"type": "object"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"400": {
|
||
"description": "请求参数错误",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"401": {
|
||
"description": "未认证或认证已过期",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"403": {
|
||
"description": "无权访问",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"500": {
|
||
"description": "服务器内部错误",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
}
|
||
},
|
||
"security": [
|
||
{
|
||
"BearerAuth": []
|
||
}
|
||
]
|
||
}
|
||
},
|
||
"/api/admin/package-silence/batches": {
|
||
"get": {
|
||
"summary": "延期批次列表",
|
||
"deprecated": false,
|
||
"description": "",
|
||
"tags": [
|
||
"卡管/沉默期 - 延期",
|
||
"沉默期 - 延期"
|
||
],
|
||
"parameters": [
|
||
{
|
||
"name": "page",
|
||
"in": "query",
|
||
"description": "页码",
|
||
"required": false,
|
||
"example": 0,
|
||
"schema": {
|
||
"description": "页码",
|
||
"type": "integer"
|
||
}
|
||
},
|
||
{
|
||
"name": "page_size",
|
||
"in": "query",
|
||
"description": "每页数量",
|
||
"required": false,
|
||
"example": 0,
|
||
"schema": {
|
||
"description": "每页数量",
|
||
"type": "integer"
|
||
}
|
||
},
|
||
{
|
||
"name": "batch_no",
|
||
"in": "query",
|
||
"description": "批次号",
|
||
"required": false,
|
||
"example": "",
|
||
"schema": {
|
||
"description": "批次号",
|
||
"type": "string"
|
||
}
|
||
},
|
||
{
|
||
"name": "path",
|
||
"in": "query",
|
||
"description": "路径",
|
||
"required": false,
|
||
"example": "",
|
||
"schema": {
|
||
"description": "路径",
|
||
"type": "string"
|
||
}
|
||
},
|
||
{
|
||
"name": "extension_type",
|
||
"in": "query",
|
||
"description": "延期类型",
|
||
"required": false,
|
||
"example": "",
|
||
"schema": {
|
||
"description": "延期类型",
|
||
"type": "string"
|
||
}
|
||
},
|
||
{
|
||
"name": "status",
|
||
"in": "query",
|
||
"description": "批次状态",
|
||
"required": false,
|
||
"example": "",
|
||
"schema": {
|
||
"description": "批次状态",
|
||
"type": "string"
|
||
}
|
||
},
|
||
{
|
||
"name": "has_exception",
|
||
"in": "query",
|
||
"description": "只看含异常明细的批次",
|
||
"required": false,
|
||
"example": "",
|
||
"schema": {
|
||
"description": "只看含异常明细的批次",
|
||
"type": "boolean",
|
||
"nullable": true
|
||
}
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "成功",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"properties": {
|
||
"code": {
|
||
"description": "响应码",
|
||
"type": "integer",
|
||
"examples": [
|
||
0
|
||
]
|
||
},
|
||
"data": {
|
||
"$ref": "#/components/schemas/DtoSilenceBatchPageResult"
|
||
},
|
||
"msg": {
|
||
"description": "响应消息",
|
||
"type": "string",
|
||
"examples": [
|
||
"success"
|
||
]
|
||
},
|
||
"timestamp": {
|
||
"description": "时间戳",
|
||
"format": "date-time",
|
||
"type": "string"
|
||
}
|
||
},
|
||
"required": [
|
||
"code",
|
||
"data",
|
||
"msg",
|
||
"timestamp"
|
||
],
|
||
"type": "object"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"400": {
|
||
"description": "请求参数错误",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"401": {
|
||
"description": "未认证或认证已过期",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"403": {
|
||
"description": "无权访问",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"500": {
|
||
"description": "服务器内部错误",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
}
|
||
},
|
||
"security": [
|
||
{
|
||
"BearerAuth": []
|
||
}
|
||
]
|
||
}
|
||
},
|
||
"/api/admin/package-silence/batches/{id}": {
|
||
"get": {
|
||
"summary": "延期批次详情（含明细）",
|
||
"deprecated": false,
|
||
"description": "",
|
||
"tags": [
|
||
"卡管/沉默期 - 延期",
|
||
"沉默期 - 延期"
|
||
],
|
||
"parameters": [
|
||
{
|
||
"name": "id",
|
||
"in": "path",
|
||
"description": "ID",
|
||
"required": true,
|
||
"example": 0,
|
||
"schema": {
|
||
"description": "ID",
|
||
"minimum": 0,
|
||
"type": "integer"
|
||
}
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "成功",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"properties": {
|
||
"code": {
|
||
"description": "响应码",
|
||
"type": "integer",
|
||
"examples": [
|
||
0
|
||
]
|
||
},
|
||
"data": {
|
||
"$ref": "#/components/schemas/DtoSilenceBatchResponse"
|
||
},
|
||
"msg": {
|
||
"description": "响应消息",
|
||
"type": "string",
|
||
"examples": [
|
||
"success"
|
||
]
|
||
},
|
||
"timestamp": {
|
||
"description": "时间戳",
|
||
"format": "date-time",
|
||
"type": "string"
|
||
}
|
||
},
|
||
"required": [
|
||
"code",
|
||
"data",
|
||
"msg",
|
||
"timestamp"
|
||
],
|
||
"type": "object"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"400": {
|
||
"description": "请求参数错误",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"401": {
|
||
"description": "未认证或认证已过期",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"403": {
|
||
"description": "无权访问",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"500": {
|
||
"description": "服务器内部错误",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
}
|
||
},
|
||
"security": [
|
||
{
|
||
"BearerAuth": []
|
||
}
|
||
]
|
||
}
|
||
},
|
||
"/api/admin/package-silence/eligibility": {
|
||
"get": {
|
||
"summary": "延期资格",
|
||
"deprecated": false,
|
||
"description": "待实名但已到期的先判定为过期；返回最少 / 最多天数与月数、单价、各月数档位；金额全部由后端计算。\n\n沉默期总开关关闭时返回错误码 1274（silence_feature_disabled）；已发生的支付回调、查单与审批回调不受开关影响。",
|
||
"tags": [
|
||
"卡管/沉默期 - 延期",
|
||
"沉默期 - 延期"
|
||
],
|
||
"parameters": [
|
||
{
|
||
"name": "package_usage_id",
|
||
"in": "query",
|
||
"description": "套餐记录 ID",
|
||
"required": true,
|
||
"example": 0,
|
||
"schema": {
|
||
"description": "套餐记录 ID",
|
||
"minimum": 0,
|
||
"type": "integer"
|
||
}
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "成功",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"properties": {
|
||
"code": {
|
||
"description": "响应码",
|
||
"type": "integer",
|
||
"examples": [
|
||
0
|
||
]
|
||
},
|
||
"data": {
|
||
"$ref": "#/components/schemas/DtoSilenceEligibilityResponse"
|
||
},
|
||
"msg": {
|
||
"description": "响应消息",
|
||
"type": "string",
|
||
"examples": [
|
||
"success"
|
||
]
|
||
},
|
||
"timestamp": {
|
||
"description": "时间戳",
|
||
"format": "date-time",
|
||
"type": "string"
|
||
}
|
||
},
|
||
"required": [
|
||
"code",
|
||
"data",
|
||
"msg",
|
||
"timestamp"
|
||
],
|
||
"type": "object"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"400": {
|
||
"description": "请求参数错误",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"401": {
|
||
"description": "未认证或认证已过期",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"403": {
|
||
"description": "无权访问",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"500": {
|
||
"description": "服务器内部错误",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
}
|
||
},
|
||
"security": [
|
||
{
|
||
"BearerAuth": []
|
||
}
|
||
]
|
||
}
|
||
},
|
||
"/api/admin/package-silence/extensions/{id}/handle": {
|
||
"post": {
|
||
"summary": "处理异常延期明细",
|
||
"deprecated": false,
|
||
"description": "需 package_silence:exception 权限；retry 按原快照重新执行，close 关闭（在线订单按冻结商户原路退款）。不得直接改截止时间。",
|
||
"tags": [
|
||
"卡管/沉默期 - 延期",
|
||
"沉默期 - 延期"
|
||
],
|
||
"parameters": [
|
||
{
|
||
"name": "id",
|
||
"in": "path",
|
||
"description": "延期明细 ID",
|
||
"required": true,
|
||
"example": 0,
|
||
"schema": {
|
||
"description": "延期明细 ID",
|
||
"minimum": 0,
|
||
"type": "integer"
|
||
}
|
||
}
|
||
],
|
||
"requestBody": {
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/DtoSilenceExceptionHandleParams"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"responses": {
|
||
"200": {
|
||
"description": "成功",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"properties": {
|
||
"code": {
|
||
"description": "响应码",
|
||
"type": "integer",
|
||
"examples": [
|
||
0
|
||
]
|
||
},
|
||
"data": {
|
||
"$ref": "#/components/schemas/DtoSilenceExtensionResponse"
|
||
},
|
||
"msg": {
|
||
"description": "响应消息",
|
||
"type": "string",
|
||
"examples": [
|
||
"success"
|
||
]
|
||
},
|
||
"timestamp": {
|
||
"description": "时间戳",
|
||
"format": "date-time",
|
||
"type": "string"
|
||
}
|
||
},
|
||
"required": [
|
||
"code",
|
||
"data",
|
||
"msg",
|
||
"timestamp"
|
||
],
|
||
"type": "object"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"400": {
|
||
"description": "请求参数错误",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"401": {
|
||
"description": "未认证或认证已过期",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"403": {
|
||
"description": "无权访问",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"500": {
|
||
"description": "服务器内部错误",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
}
|
||
},
|
||
"security": [
|
||
{
|
||
"BearerAuth": []
|
||
}
|
||
]
|
||
}
|
||
},
|
||
"/api/admin/package-silence/orders": {
|
||
"get": {
|
||
"summary": "延期订单列表",
|
||
"deprecated": false,
|
||
"description": "叠加店铺数据范围；支付方式、收款商户、交易流水号取已支付或已退款支付单快照。导出使用统一导出任务，场景 package_silence_order，筛选参数同本接口。",
|
||
"tags": [
|
||
"卡管/沉默期 - 延期",
|
||
"沉默期 - 延期"
|
||
],
|
||
"parameters": [
|
||
{
|
||
"name": "page",
|
||
"in": "query",
|
||
"description": "页码",
|
||
"required": false,
|
||
"example": 0,
|
||
"schema": {
|
||
"description": "页码",
|
||
"type": "integer"
|
||
}
|
||
},
|
||
{
|
||
"name": "page_size",
|
||
"in": "query",
|
||
"description": "每页数量",
|
||
"required": false,
|
||
"example": 0,
|
||
"schema": {
|
||
"description": "每页数量",
|
||
"type": "integer"
|
||
}
|
||
},
|
||
{
|
||
"name": "package_usage_id",
|
||
"in": "query",
|
||
"description": "套餐记录 ID",
|
||
"required": false,
|
||
"example": 0,
|
||
"schema": {
|
||
"description": "套餐记录 ID",
|
||
"minimum": 0,
|
||
"type": "integer",
|
||
"nullable": true
|
||
}
|
||
},
|
||
{
|
||
"name": "package_id",
|
||
"in": "query",
|
||
"description": "套餐 ID",
|
||
"required": false,
|
||
"example": 0,
|
||
"schema": {
|
||
"description": "套餐 ID",
|
||
"minimum": 0,
|
||
"type": "integer",
|
||
"nullable": true
|
||
}
|
||
},
|
||
{
|
||
"name": "asset_identifier",
|
||
"in": "query",
|
||
"description": "资产标识（ICCID / 虚拟号 / IMEI）",
|
||
"required": false,
|
||
"example": "",
|
||
"schema": {
|
||
"description": "资产标识（ICCID / 虚拟号 / IMEI）",
|
||
"type": "string"
|
||
}
|
||
},
|
||
{
|
||
"name": "order_no",
|
||
"in": "query",
|
||
"description": "订单号",
|
||
"required": false,
|
||
"example": "",
|
||
"schema": {
|
||
"description": "订单号",
|
||
"type": "string"
|
||
}
|
||
},
|
||
{
|
||
"name": "status",
|
||
"in": "query",
|
||
"description": "状态",
|
||
"required": false,
|
||
"example": "",
|
||
"schema": {
|
||
"description": "状态",
|
||
"type": "string"
|
||
}
|
||
},
|
||
{
|
||
"name": "source",
|
||
"in": "query",
|
||
"description": "来源",
|
||
"required": false,
|
||
"example": "",
|
||
"schema": {
|
||
"description": "来源",
|
||
"type": "string"
|
||
}
|
||
},
|
||
{
|
||
"name": "payment_method",
|
||
"in": "query",
|
||
"description": "支付方式",
|
||
"required": false,
|
||
"example": "",
|
||
"schema": {
|
||
"description": "支付方式",
|
||
"type": "string"
|
||
}
|
||
},
|
||
{
|
||
"name": "merchant_name",
|
||
"in": "query",
|
||
"description": "收款商户名称（模糊）",
|
||
"required": false,
|
||
"example": "",
|
||
"schema": {
|
||
"description": "收款商户名称（模糊）",
|
||
"type": "string"
|
||
}
|
||
},
|
||
{
|
||
"name": "third_party_trade_no",
|
||
"in": "query",
|
||
"description": "交易流水号或线下交易单号",
|
||
"required": false,
|
||
"example": "",
|
||
"schema": {
|
||
"description": "交易流水号或线下交易单号",
|
||
"type": "string"
|
||
}
|
||
},
|
||
{
|
||
"name": "paid_start",
|
||
"in": "query",
|
||
"description": "支付时间起（RFC3339）",
|
||
"required": false,
|
||
"example": "",
|
||
"schema": {
|
||
"description": "支付时间起（RFC3339）",
|
||
"type": "string"
|
||
}
|
||
},
|
||
{
|
||
"name": "paid_end",
|
||
"in": "query",
|
||
"description": "支付时间止（RFC3339）",
|
||
"required": false,
|
||
"example": "",
|
||
"schema": {
|
||
"description": "支付时间止（RFC3339）",
|
||
"type": "string"
|
||
}
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "成功",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"properties": {
|
||
"code": {
|
||
"description": "响应码",
|
||
"type": "integer",
|
||
"examples": [
|
||
0
|
||
]
|
||
},
|
||
"data": {
|
||
"$ref": "#/components/schemas/DtoSilenceOrderPageResult"
|
||
},
|
||
"msg": {
|
||
"description": "响应消息",
|
||
"type": "string",
|
||
"examples": [
|
||
"success"
|
||
]
|
||
},
|
||
"timestamp": {
|
||
"description": "时间戳",
|
||
"format": "date-time",
|
||
"type": "string"
|
||
}
|
||
},
|
||
"required": [
|
||
"code",
|
||
"data",
|
||
"msg",
|
||
"timestamp"
|
||
],
|
||
"type": "object"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"400": {
|
||
"description": "请求参数错误",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"401": {
|
||
"description": "未认证或认证已过期",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"403": {
|
||
"description": "无权访问",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"500": {
|
||
"description": "服务器内部错误",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
}
|
||
},
|
||
"security": [
|
||
{
|
||
"BearerAuth": []
|
||
}
|
||
]
|
||
}
|
||
},
|
||
"/api/admin/package-silence/orders/{id}": {
|
||
"get": {
|
||
"summary": "延期订单详情",
|
||
"deprecated": false,
|
||
"description": "",
|
||
"tags": [
|
||
"卡管/沉默期 - 延期",
|
||
"沉默期 - 延期"
|
||
],
|
||
"parameters": [
|
||
{
|
||
"name": "id",
|
||
"in": "path",
|
||
"description": "ID",
|
||
"required": true,
|
||
"example": 0,
|
||
"schema": {
|
||
"description": "ID",
|
||
"minimum": 0,
|
||
"type": "integer"
|
||
}
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "成功",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"properties": {
|
||
"code": {
|
||
"description": "响应码",
|
||
"type": "integer",
|
||
"examples": [
|
||
0
|
||
]
|
||
},
|
||
"data": {
|
||
"$ref": "#/components/schemas/DtoSilenceExtensionOrderResponse"
|
||
},
|
||
"msg": {
|
||
"description": "响应消息",
|
||
"type": "string",
|
||
"examples": [
|
||
"success"
|
||
]
|
||
},
|
||
"timestamp": {
|
||
"description": "时间戳",
|
||
"format": "date-time",
|
||
"type": "string"
|
||
}
|
||
},
|
||
"required": [
|
||
"code",
|
||
"data",
|
||
"msg",
|
||
"timestamp"
|
||
],
|
||
"type": "object"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"400": {
|
||
"description": "请求参数错误",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"401": {
|
||
"description": "未认证或认证已过期",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"403": {
|
||
"description": "无权访问",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"500": {
|
||
"description": "服务器内部错误",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
}
|
||
},
|
||
"security": [
|
||
{
|
||
"BearerAuth": []
|
||
}
|
||
]
|
||
}
|
||
},
|
||
"/api/admin/package-silence/orders/offline": {
|
||
"post": {
|
||
"summary": "登记线下付费延期",
|
||
"deprecated": false,
|
||
"description": "需 package_silence:offline 权限；实收金额必须等于系统计算金额（1273），同一收款方式下交易单号唯一（1272）；政策未勾选 offline_paid 免审批时提交企微审批，通过后延期，驳回订单 rejected 且系统不退款。\n\n沉默期总开关关闭时返回错误码 1274（silence_feature_disabled）；已发生的支付回调、查单与审批回调不受开关影响。",
|
||
"tags": [
|
||
"卡管/沉默期 - 延期",
|
||
"沉默期 - 延期"
|
||
],
|
||
"parameters": [],
|
||
"requestBody": {
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/DtoSilenceOfflineOrderRequest"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"responses": {
|
||
"200": {
|
||
"description": "成功",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"properties": {
|
||
"code": {
|
||
"description": "响应码",
|
||
"type": "integer",
|
||
"examples": [
|
||
0
|
||
]
|
||
},
|
||
"data": {
|
||
"$ref": "#/components/schemas/DtoSilenceExtensionOrderResponse"
|
||
},
|
||
"msg": {
|
||
"description": "响应消息",
|
||
"type": "string",
|
||
"examples": [
|
||
"success"
|
||
]
|
||
},
|
||
"timestamp": {
|
||
"description": "时间戳",
|
||
"format": "date-time",
|
||
"type": "string"
|
||
}
|
||
},
|
||
"required": [
|
||
"code",
|
||
"data",
|
||
"msg",
|
||
"timestamp"
|
||
],
|
||
"type": "object"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"400": {
|
||
"description": "请求参数错误",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"401": {
|
||
"description": "未认证或认证已过期",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"403": {
|
||
"description": "无权访问",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"500": {
|
||
"description": "服务器内部错误",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
}
|
||
},
|
||
"security": [
|
||
{
|
||
"BearerAuth": []
|
||
}
|
||
]
|
||
}
|
||
},
|
||
"/api/admin/package-silence/orders/qrcode": {
|
||
"post": {
|
||
"summary": "运营创建在线延期订单并生成支付二维码",
|
||
"deprecated": false,
|
||
"description": "需 package_silence:extend 权限；商户按支付方式经商户池路由并冻结；返回 qr_content 由前端渲染为二维码，客户扫码支付后自动延期，不审批。同一套餐已有待支付订单时先查单：未支付则关闭旧单再新建，已支付则按已支付处理并返回旧单。\n\n沉默期总开关关闭时返回错误码 1274（silence_feature_disabled）；已发生的支付回调、查单与审批回调不受开关影响。",
|
||
"tags": [
|
||
"卡管/沉默期 - 延期",
|
||
"沉默期 - 延期"
|
||
],
|
||
"parameters": [],
|
||
"requestBody": {
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/DtoSilenceOnlineOrderRequest"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"responses": {
|
||
"200": {
|
||
"description": "成功",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"properties": {
|
||
"code": {
|
||
"description": "响应码",
|
||
"type": "integer",
|
||
"examples": [
|
||
0
|
||
]
|
||
},
|
||
"data": {
|
||
"$ref": "#/components/schemas/DtoSilenceExtensionOrderResponse"
|
||
},
|
||
"msg": {
|
||
"description": "响应消息",
|
||
"type": "string",
|
||
"examples": [
|
||
"success"
|
||
]
|
||
},
|
||
"timestamp": {
|
||
"description": "时间戳",
|
||
"format": "date-time",
|
||
"type": "string"
|
||
}
|
||
},
|
||
"required": [
|
||
"code",
|
||
"data",
|
||
"msg",
|
||
"timestamp"
|
||
],
|
||
"type": "object"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"400": {
|
||
"description": "请求参数错误",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"401": {
|
||
"description": "未认证或认证已过期",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"403": {
|
||
"description": "无权访问",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"500": {
|
||
"description": "服务器内部错误",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
}
|
||
},
|
||
"security": [
|
||
{
|
||
"BearerAuth": []
|
||
}
|
||
]
|
||
}
|
||
},
|
||
"/api/admin/package-silence/quote": {
|
||
"get": {
|
||
"summary": "按天数试算付费延期",
|
||
"deprecated": false,
|
||
"description": "按每月 30 天向上取整计费（1 天按 30 天，31 天按 60 天），延长天数等于计费天数。\n\n沉默期总开关关闭时返回错误码 1274（silence_feature_disabled）；已发生的支付回调、查单与审批回调不受开关影响。",
|
||
"tags": [
|
||
"卡管/沉默期 - 延期",
|
||
"沉默期 - 延期"
|
||
],
|
||
"parameters": [
|
||
{
|
||
"name": "package_usage_id",
|
||
"in": "query",
|
||
"description": "套餐记录 ID",
|
||
"required": true,
|
||
"example": 0,
|
||
"schema": {
|
||
"description": "套餐记录 ID",
|
||
"minimum": 0,
|
||
"type": "integer"
|
||
}
|
||
},
|
||
{
|
||
"name": "days",
|
||
"in": "query",
|
||
"description": "输入的延期天数（按每月 30 天向上取整计费）",
|
||
"required": true,
|
||
"example": 0,
|
||
"schema": {
|
||
"description": "输入的延期天数（按每月 30 天向上取整计费）",
|
||
"type": "integer"
|
||
}
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "成功",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"properties": {
|
||
"code": {
|
||
"description": "响应码",
|
||
"type": "integer",
|
||
"examples": [
|
||
0
|
||
]
|
||
},
|
||
"data": {
|
||
"$ref": "#/components/schemas/DtoSilenceQuoteResponse"
|
||
},
|
||
"msg": {
|
||
"description": "响应消息",
|
||
"type": "string",
|
||
"examples": [
|
||
"success"
|
||
]
|
||
},
|
||
"timestamp": {
|
||
"description": "时间戳",
|
||
"format": "date-time",
|
||
"type": "string"
|
||
}
|
||
},
|
||
"required": [
|
||
"code",
|
||
"data",
|
||
"msg",
|
||
"timestamp"
|
||
],
|
||
"type": "object"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"400": {
|
||
"description": "请求参数错误",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"401": {
|
||
"description": "未认证或认证已过期",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"403": {
|
||
"description": "无权访问",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"500": {
|
||
"description": "服务器内部错误",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
}
|
||
},
|
||
"security": [
|
||
{
|
||
"BearerAuth": []
|
||
}
|
||
]
|
||
}
|
||
},
|
||
"/api/admin/package-silence/special": {
|
||
"post": {
|
||
"summary": "提交特殊延期（单个 / 批量）",
|
||
"deprecated": false,
|
||
"description": "需 package_silence:extend 权限，批量（多条或导入文件）另需 package_silence:extend_batch；免费延期受政策次数约束（1267）；不受付费上限与套餐是否支持延期约束，只要求新截止晚于今天。政策未勾选对应免审批场景（批量看 batch）时提交企微审批，通过后逐条执行。\n\n沉默期总开关关闭时返回错误码 1274（silence_feature_disabled）；已发生的支付回调、查单与审批回调不受开关影响。",
|
||
"tags": [
|
||
"卡管/沉默期 - 延期",
|
||
"沉默期 - 延期"
|
||
],
|
||
"parameters": [],
|
||
"requestBody": {
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/DtoSilenceSpecialRequest"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"responses": {
|
||
"200": {
|
||
"description": "成功",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"properties": {
|
||
"code": {
|
||
"description": "响应码",
|
||
"type": "integer",
|
||
"examples": [
|
||
0
|
||
]
|
||
},
|
||
"data": {
|
||
"$ref": "#/components/schemas/DtoSilenceBatchResponse"
|
||
},
|
||
"msg": {
|
||
"description": "响应消息",
|
||
"type": "string",
|
||
"examples": [
|
||
"success"
|
||
]
|
||
},
|
||
"timestamp": {
|
||
"description": "时间戳",
|
||
"format": "date-time",
|
||
"type": "string"
|
||
}
|
||
},
|
||
"required": [
|
||
"code",
|
||
"data",
|
||
"msg",
|
||
"timestamp"
|
||
],
|
||
"type": "object"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"400": {
|
||
"description": "请求参数错误",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"401": {
|
||
"description": "未认证或认证已过期",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"403": {
|
||
"description": "无权访问",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"500": {
|
||
"description": "服务器内部错误",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
}
|
||
},
|
||
"security": [
|
||
{
|
||
"BearerAuth": []
|
||
}
|
||
]
|
||
}
|
||
},
|
||
"/api/admin/package-silence/policies": {
|
||
"get": {
|
||
"summary": "延期政策列表",
|
||
"deprecated": false,
|
||
"description": "需 package_silence:policy 权限。",
|
||
"tags": [
|
||
"卡管/沉默期 - 延期政策",
|
||
"沉默期 - 延期政策"
|
||
],
|
||
"parameters": [
|
||
{
|
||
"name": "page",
|
||
"in": "query",
|
||
"description": "页码",
|
||
"required": false,
|
||
"example": 0,
|
||
"schema": {
|
||
"description": "页码",
|
||
"type": "integer"
|
||
}
|
||
},
|
||
{
|
||
"name": "page_size",
|
||
"in": "query",
|
||
"description": "每页数量",
|
||
"required": false,
|
||
"example": 0,
|
||
"schema": {
|
||
"description": "每页数量",
|
||
"type": "integer"
|
||
}
|
||
},
|
||
{
|
||
"name": "name",
|
||
"in": "query",
|
||
"description": "政策名称（模糊）",
|
||
"required": false,
|
||
"example": "",
|
||
"schema": {
|
||
"description": "政策名称（模糊）",
|
||
"type": "string"
|
||
}
|
||
},
|
||
{
|
||
"name": "scope_type",
|
||
"in": "query",
|
||
"description": "适用范围",
|
||
"required": false,
|
||
"example": "",
|
||
"schema": {
|
||
"description": "适用范围",
|
||
"type": "string"
|
||
}
|
||
},
|
||
{
|
||
"name": "status",
|
||
"in": "query",
|
||
"description": "状态",
|
||
"required": false,
|
||
"example": 0,
|
||
"schema": {
|
||
"description": "状态",
|
||
"type": "integer",
|
||
"nullable": true
|
||
}
|
||
},
|
||
{
|
||
"name": "effective_at",
|
||
"in": "query",
|
||
"description": "在该时间生效（RFC3339）",
|
||
"required": false,
|
||
"example": "",
|
||
"schema": {
|
||
"description": "在该时间生效（RFC3339）",
|
||
"type": "string"
|
||
}
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "成功",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"properties": {
|
||
"code": {
|
||
"description": "响应码",
|
||
"type": "integer",
|
||
"examples": [
|
||
0
|
||
]
|
||
},
|
||
"data": {
|
||
"items": {
|
||
"$ref": "#/components/schemas/DtoSilencePolicyResponse"
|
||
},
|
||
"type": "array"
|
||
},
|
||
"msg": {
|
||
"description": "响应消息",
|
||
"type": "string",
|
||
"examples": [
|
||
"success"
|
||
]
|
||
},
|
||
"timestamp": {
|
||
"description": "时间戳",
|
||
"format": "date-time",
|
||
"type": "string"
|
||
}
|
||
},
|
||
"required": [
|
||
"code",
|
||
"data",
|
||
"msg",
|
||
"timestamp"
|
||
],
|
||
"type": "object"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"400": {
|
||
"description": "请求参数错误",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"401": {
|
||
"description": "未认证或认证已过期",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"403": {
|
||
"description": "无权访问",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"500": {
|
||
"description": "服务器内部错误",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
}
|
||
},
|
||
"security": [
|
||
{
|
||
"BearerAuth": []
|
||
}
|
||
]
|
||
},
|
||
"post": {
|
||
"summary": "新增延期政策",
|
||
"deprecated": false,
|
||
"description": "同一优先级的适用范围与生效时间段不能重叠，重叠返回 1269（silence_policy_overlap）。修改只影响之后发起的延期。",
|
||
"tags": [
|
||
"卡管/沉默期 - 延期政策",
|
||
"沉默期 - 延期政策"
|
||
],
|
||
"parameters": [],
|
||
"requestBody": {
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/DtoSilencePolicyRequest"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"responses": {
|
||
"200": {
|
||
"description": "成功",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"properties": {
|
||
"code": {
|
||
"description": "响应码",
|
||
"type": "integer",
|
||
"examples": [
|
||
0
|
||
]
|
||
},
|
||
"data": {
|
||
"$ref": "#/components/schemas/DtoSilencePolicyResponse"
|
||
},
|
||
"msg": {
|
||
"description": "响应消息",
|
||
"type": "string",
|
||
"examples": [
|
||
"success"
|
||
]
|
||
},
|
||
"timestamp": {
|
||
"description": "时间戳",
|
||
"format": "date-time",
|
||
"type": "string"
|
||
}
|
||
},
|
||
"required": [
|
||
"code",
|
||
"data",
|
||
"msg",
|
||
"timestamp"
|
||
],
|
||
"type": "object"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"400": {
|
||
"description": "请求参数错误",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"401": {
|
||
"description": "未认证或认证已过期",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"403": {
|
||
"description": "无权访问",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"500": {
|
||
"description": "服务器内部错误",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
}
|
||
},
|
||
"security": [
|
||
{
|
||
"BearerAuth": []
|
||
}
|
||
]
|
||
}
|
||
},
|
||
"/api/admin/package-silence/policies/{id}": {
|
||
"get": {
|
||
"summary": "延期政策详情",
|
||
"deprecated": false,
|
||
"description": "",
|
||
"tags": [
|
||
"卡管/沉默期 - 延期政策",
|
||
"沉默期 - 延期政策"
|
||
],
|
||
"parameters": [
|
||
{
|
||
"name": "id",
|
||
"in": "path",
|
||
"description": "ID",
|
||
"required": true,
|
||
"example": 0,
|
||
"schema": {
|
||
"description": "ID",
|
||
"minimum": 0,
|
||
"type": "integer"
|
||
}
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "成功",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"properties": {
|
||
"code": {
|
||
"description": "响应码",
|
||
"type": "integer",
|
||
"examples": [
|
||
0
|
||
]
|
||
},
|
||
"data": {
|
||
"$ref": "#/components/schemas/DtoSilencePolicyResponse"
|
||
},
|
||
"msg": {
|
||
"description": "响应消息",
|
||
"type": "string",
|
||
"examples": [
|
||
"success"
|
||
]
|
||
},
|
||
"timestamp": {
|
||
"description": "时间戳",
|
||
"format": "date-time",
|
||
"type": "string"
|
||
}
|
||
},
|
||
"required": [
|
||
"code",
|
||
"data",
|
||
"msg",
|
||
"timestamp"
|
||
],
|
||
"type": "object"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"400": {
|
||
"description": "请求参数错误",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"401": {
|
||
"description": "未认证或认证已过期",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"403": {
|
||
"description": "无权访问",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"500": {
|
||
"description": "服务器内部错误",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
}
|
||
},
|
||
"security": [
|
||
{
|
||
"BearerAuth": []
|
||
}
|
||
]
|
||
},
|
||
"put": {
|
||
"summary": "编辑延期政策",
|
||
"deprecated": false,
|
||
"description": "全量提交字段；已创建的延期订单与已提交的审批按快照执行。",
|
||
"tags": [
|
||
"卡管/沉默期 - 延期政策",
|
||
"沉默期 - 延期政策"
|
||
],
|
||
"parameters": [
|
||
{
|
||
"name": "id",
|
||
"in": "path",
|
||
"description": "政策 ID",
|
||
"required": true,
|
||
"example": 0,
|
||
"schema": {
|
||
"description": "政策 ID",
|
||
"minimum": 0,
|
||
"type": "integer"
|
||
}
|
||
}
|
||
],
|
||
"requestBody": {
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/DtoSilencePolicyUpdateParams"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"responses": {
|
||
"200": {
|
||
"description": "成功",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"properties": {
|
||
"code": {
|
||
"description": "响应码",
|
||
"type": "integer",
|
||
"examples": [
|
||
0
|
||
]
|
||
},
|
||
"data": {
|
||
"$ref": "#/components/schemas/DtoSilencePolicyResponse"
|
||
},
|
||
"msg": {
|
||
"description": "响应消息",
|
||
"type": "string",
|
||
"examples": [
|
||
"success"
|
||
]
|
||
},
|
||
"timestamp": {
|
||
"description": "时间戳",
|
||
"format": "date-time",
|
||
"type": "string"
|
||
}
|
||
},
|
||
"required": [
|
||
"code",
|
||
"data",
|
||
"msg",
|
||
"timestamp"
|
||
],
|
||
"type": "object"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"400": {
|
||
"description": "请求参数错误",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"401": {
|
||
"description": "未认证或认证已过期",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"403": {
|
||
"description": "无权访问",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"500": {
|
||
"description": "服务器内部错误",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
}
|
||
},
|
||
"security": [
|
||
{
|
||
"BearerAuth": []
|
||
}
|
||
]
|
||
}
|
||
},
|
||
"/api/admin/package-silence/policies/{id}/status": {
|
||
"put": {
|
||
"summary": "启停延期政策",
|
||
"deprecated": false,
|
||
"description": "启用时同样做重叠校验。",
|
||
"tags": [
|
||
"卡管/沉默期 - 延期政策",
|
||
"沉默期 - 延期政策"
|
||
],
|
||
"parameters": [
|
||
{
|
||
"name": "id",
|
||
"in": "path",
|
||
"description": "政策 ID",
|
||
"required": true,
|
||
"example": 0,
|
||
"schema": {
|
||
"description": "政策 ID",
|
||
"minimum": 0,
|
||
"type": "integer"
|
||
}
|
||
}
|
||
],
|
||
"requestBody": {
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/DtoSilencePolicyStatusParams"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"responses": {
|
||
"200": {
|
||
"description": "成功",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"properties": {
|
||
"code": {
|
||
"description": "响应码",
|
||
"type": "integer",
|
||
"examples": [
|
||
0
|
||
]
|
||
},
|
||
"data": {
|
||
"$ref": "#/components/schemas/DtoSilencePolicyResponse"
|
||
},
|
||
"msg": {
|
||
"description": "响应消息",
|
||
"type": "string",
|
||
"examples": [
|
||
"success"
|
||
]
|
||
},
|
||
"timestamp": {
|
||
"description": "时间戳",
|
||
"format": "date-time",
|
||
"type": "string"
|
||
}
|
||
},
|
||
"required": [
|
||
"code",
|
||
"data",
|
||
"msg",
|
||
"timestamp"
|
||
],
|
||
"type": "object"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"400": {
|
||
"description": "请求参数错误",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"401": {
|
||
"description": "未认证或认证已过期",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"403": {
|
||
"description": "无权访问",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"500": {
|
||
"description": "服务器内部错误",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
}
|
||
},
|
||
"security": [
|
||
{
|
||
"BearerAuth": []
|
||
}
|
||
]
|
||
}
|
||
},
|
||
"/api/admin/package-silence/policies/match": {
|
||
"get": {
|
||
"summary": "查询套餐当前匹配的延期政策",
|
||
"deprecated": false,
|
||
"description": "优先级：指定套餐 > 套餐系列 > 全部套餐；只匹配启用且在生效期内的政策。",
|
||
"tags": [
|
||
"卡管/沉默期 - 延期政策",
|
||
"沉默期 - 延期政策"
|
||
],
|
||
"parameters": [
|
||
{
|
||
"name": "package_id",
|
||
"in": "query",
|
||
"description": "套餐 ID",
|
||
"required": true,
|
||
"example": 0,
|
||
"schema": {
|
||
"description": "套餐 ID",
|
||
"minimum": 0,
|
||
"type": "integer"
|
||
}
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "成功",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"properties": {
|
||
"code": {
|
||
"description": "响应码",
|
||
"type": "integer",
|
||
"examples": [
|
||
0
|
||
]
|
||
},
|
||
"data": {
|
||
"$ref": "#/components/schemas/DtoSilencePolicyMatchResponse"
|
||
},
|
||
"msg": {
|
||
"description": "响应消息",
|
||
"type": "string",
|
||
"examples": [
|
||
"success"
|
||
]
|
||
},
|
||
"timestamp": {
|
||
"description": "时间戳",
|
||
"format": "date-time",
|
||
"type": "string"
|
||
}
|
||
},
|
||
"required": [
|
||
"code",
|
||
"data",
|
||
"msg",
|
||
"timestamp"
|
||
],
|
||
"type": "object"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"400": {
|
||
"description": "请求参数错误",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"401": {
|
||
"description": "未认证或认证已过期",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"403": {
|
||
"description": "无权访问",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"500": {
|
||
"description": "服务器内部错误",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
}
|
||
},
|
||
"security": [
|
||
{
|
||
"BearerAuth": []
|
||
}
|
||
]
|
||
}
|
||
},
|
||
"/api/admin/package-silence/records": {
|
||
"get": {
|
||
"summary": "套餐沉默期流水",
|
||
"deprecated": false,
|
||
"description": "设置、调整、过期、结束、延期、换货迁移、回填等不可变流水。",
|
||
"tags": [
|
||
"卡管/沉默期",
|
||
"沉默期"
|
||
],
|
||
"parameters": [
|
||
{
|
||
"name": "package_usage_id",
|
||
"in": "query",
|
||
"description": "套餐记录 ID",
|
||
"required": true,
|
||
"example": 0,
|
||
"schema": {
|
||
"description": "套餐记录 ID",
|
||
"minimum": 0,
|
||
"type": "integer"
|
||
}
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "成功",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"properties": {
|
||
"code": {
|
||
"description": "响应码",
|
||
"type": "integer",
|
||
"examples": [
|
||
0
|
||
]
|
||
},
|
||
"data": {
|
||
"items": {
|
||
"$ref": "#/components/schemas/DtoSilenceRecordResponse"
|
||
},
|
||
"type": "array"
|
||
},
|
||
"msg": {
|
||
"description": "响应消息",
|
||
"type": "string",
|
||
"examples": [
|
||
"success"
|
||
]
|
||
},
|
||
"timestamp": {
|
||
"description": "时间戳",
|
||
"format": "date-time",
|
||
"type": "string"
|
||
}
|
||
},
|
||
"required": [
|
||
"code",
|
||
"data",
|
||
"msg",
|
||
"timestamp"
|
||
],
|
||
"type": "object"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"400": {
|
||
"description": "请求参数错误",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"401": {
|
||
"description": "未认证或认证已过期",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"403": {
|
||
"description": "无权访问",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"500": {
|
||
"description": "服务器内部错误",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
}
|
||
},
|
||
"security": [
|
||
{
|
||
"BearerAuth": []
|
||
}
|
||
]
|
||
}
|
||
},
|
||
"/api/admin/package-silence/switch": {
|
||
"get": {
|
||
"summary": "查询沉默期总开关",
|
||
"deprecated": false,
|
||
"description": "返回总开关当前值与打开前 4 项检查结果（未配置默认沉默期的套餐、未回填记录、全部套餐延期政策、企微审批场景）。",
|
||
"tags": [
|
||
"卡管/沉默期",
|
||
"沉默期"
|
||
],
|
||
"parameters": [],
|
||
"responses": {
|
||
"200": {
|
||
"description": "成功",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"properties": {
|
||
"code": {
|
||
"description": "响应码",
|
||
"type": "integer",
|
||
"examples": [
|
||
0
|
||
]
|
||
},
|
||
"data": {
|
||
"$ref": "#/components/schemas/DtoSilenceSwitchResponse"
|
||
},
|
||
"msg": {
|
||
"description": "响应消息",
|
||
"type": "string",
|
||
"examples": [
|
||
"success"
|
||
]
|
||
},
|
||
"timestamp": {
|
||
"description": "时间戳",
|
||
"format": "date-time",
|
||
"type": "string"
|
||
}
|
||
},
|
||
"required": [
|
||
"code",
|
||
"data",
|
||
"msg",
|
||
"timestamp"
|
||
],
|
||
"type": "object"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"400": {
|
||
"description": "请求参数错误",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"401": {
|
||
"description": "未认证或认证已过期",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"403": {
|
||
"description": "无权访问",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"500": {
|
||
"description": "服务器内部错误",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
}
|
||
},
|
||
"security": [
|
||
{
|
||
"BearerAuth": []
|
||
}
|
||
]
|
||
},
|
||
"put": {
|
||
"summary": "切换沉默期总开关（仅超级管理员）",
|
||
"deprecated": false,
|
||
"description": "打开前逐项检查，任一项不满足返回 1275（silence_switch_precheck_failed），data.failed_items 为未满足项与数量；关闭（应急）不检查：规则暂停、数据保留。每次切换写审计 package.silence_switch_changed。",
|
||
"tags": [
|
||
"卡管/沉默期",
|
||
"沉默期"
|
||
],
|
||
"parameters": [],
|
||
"requestBody": {
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/DtoSilenceSwitchRequest"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"responses": {
|
||
"200": {
|
||
"description": "成功",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"properties": {
|
||
"code": {
|
||
"description": "响应码",
|
||
"type": "integer",
|
||
"examples": [
|
||
0
|
||
]
|
||
},
|
||
"data": {
|
||
"$ref": "#/components/schemas/DtoSilenceSwitchResponse"
|
||
},
|
||
"msg": {
|
||
"description": "响应消息",
|
||
"type": "string",
|
||
"examples": [
|
||
"success"
|
||
]
|
||
},
|
||
"timestamp": {
|
||
"description": "时间戳",
|
||
"format": "date-time",
|
||
"type": "string"
|
||
}
|
||
},
|
||
"required": [
|
||
"code",
|
||
"data",
|
||
"msg",
|
||
"timestamp"
|
||
],
|
||
"type": "object"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"400": {
|
||
"description": "请求参数错误",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"401": {
|
||
"description": "未认证或认证已过期",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"403": {
|
||
"description": "无权访问",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"500": {
|
||
"description": "服务器内部错误",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
}
|
||
},
|
||
"security": [
|
||
{
|
||
"BearerAuth": []
|
||
}
|
||
]
|
||
}
|
||
},
|
||
"/api/admin/package-silence/usages": {
|
||
"get": {
|
||
"summary": "即将过期 / 已过期套餐",
|
||
"deprecated": false,
|
||
"description": "view=expiring（默认 7 天内到期）/ expired / all；导出使用统一导出任务，场景 package_silence_usage，筛选参数同本接口。",
|
||
"tags": [
|
||
"卡管/沉默期",
|
||
"沉默期"
|
||
],
|
||
"parameters": [
|
||
{
|
||
"name": "page",
|
||
"in": "query",
|
||
"description": "页码",
|
||
"required": false,
|
||
"example": 0,
|
||
"schema": {
|
||
"description": "页码",
|
||
"type": "integer"
|
||
}
|
||
},
|
||
{
|
||
"name": "page_size",
|
||
"in": "query",
|
||
"description": "每页数量",
|
||
"required": false,
|
||
"example": 0,
|
||
"schema": {
|
||
"description": "每页数量",
|
||
"type": "integer"
|
||
}
|
||
},
|
||
{
|
||
"name": "view",
|
||
"in": "query",
|
||
"description": "视图：expiring 即将过期（默认 7 天内） / expired 已过期 / all 全部待实名与已过期",
|
||
"required": false,
|
||
"example": "",
|
||
"schema": {
|
||
"description": "视图：expiring 即将过期（默认 7 天内） / expired 已过期 / all 全部待实名与已过期",
|
||
"type": "string"
|
||
}
|
||
},
|
||
{
|
||
"name": "within_days",
|
||
"in": "query",
|
||
"description": "即将过期的天数范围（默认 7）",
|
||
"required": false,
|
||
"example": 0,
|
||
"schema": {
|
||
"description": "即将过期的天数范围（默认 7）",
|
||
"type": "integer"
|
||
}
|
||
},
|
||
{
|
||
"name": "asset_identifier",
|
||
"in": "query",
|
||
"description": "资产标识",
|
||
"required": false,
|
||
"example": "",
|
||
"schema": {
|
||
"description": "资产标识",
|
||
"type": "string"
|
||
}
|
||
},
|
||
{
|
||
"name": "package_id",
|
||
"in": "query",
|
||
"description": "套餐 ID",
|
||
"required": false,
|
||
"example": 0,
|
||
"schema": {
|
||
"description": "套餐 ID",
|
||
"minimum": 0,
|
||
"type": "integer",
|
||
"nullable": true
|
||
}
|
||
},
|
||
{
|
||
"name": "shop_id",
|
||
"in": "query",
|
||
"description": "资产所属店铺",
|
||
"required": false,
|
||
"example": 0,
|
||
"schema": {
|
||
"description": "资产所属店铺",
|
||
"minimum": 0,
|
||
"type": "integer",
|
||
"nullable": true
|
||
}
|
||
},
|
||
{
|
||
"name": "deadline_start",
|
||
"in": "query",
|
||
"description": "截止时间起（RFC3339）",
|
||
"required": false,
|
||
"example": "",
|
||
"schema": {
|
||
"description": "截止时间起（RFC3339）",
|
||
"type": "string"
|
||
}
|
||
},
|
||
{
|
||
"name": "deadline_end",
|
||
"in": "query",
|
||
"description": "截止时间止（RFC3339）",
|
||
"required": false,
|
||
"example": "",
|
||
"schema": {
|
||
"description": "截止时间止（RFC3339）",
|
||
"type": "string"
|
||
}
|
||
}
|
||
],
|
||
"responses": {
|
||
"200": {
|
||
"description": "成功",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"properties": {
|
||
"code": {
|
||
"description": "响应码",
|
||
"type": "integer",
|
||
"examples": [
|
||
0
|
||
]
|
||
},
|
||
"data": {
|
||
"$ref": "#/components/schemas/DtoSilenceUsagePageResult"
|
||
},
|
||
"msg": {
|
||
"description": "响应消息",
|
||
"type": "string",
|
||
"examples": [
|
||
"success"
|
||
]
|
||
},
|
||
"timestamp": {
|
||
"description": "时间戳",
|
||
"format": "date-time",
|
||
"type": "string"
|
||
}
|
||
},
|
||
"required": [
|
||
"code",
|
||
"data",
|
||
"msg",
|
||
"timestamp"
|
||
],
|
||
"type": "object"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"400": {
|
||
"description": "请求参数错误",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"401": {
|
||
"description": "未认证或认证已过期",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"403": {
|
||
"description": "无权访问",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
},
|
||
"500": {
|
||
"description": "服务器内部错误",
|
||
"content": {
|
||
"application/json": {
|
||
"schema": {
|
||
"$ref": "#/components/schemas/ErrorResponse"
|
||
}
|
||
}
|
||
},
|
||
"headers": {}
|
||
}
|
||
},
|
||
"security": [
|
||
{
|
||
"BearerAuth": []
|
||
}
|
||
]
|
||
}
|
||
}
|
||
},
|
||
"components": {
|
||
"schemas": {
|
||
"DtoAssetFirstPurchaseRecordResponse": {
|
||
"properties": {
|
||
"asset_id": {
|
||
"description": "资产 ID",
|
||
"minimum": 0,
|
||
"type": "integer"
|
||
},
|
||
"asset_identifier": {
|
||
"description": "资产标识快照",
|
||
"type": "string"
|
||
},
|
||
"asset_type": {
|
||
"description": "资产类型",
|
||
"type": "string"
|
||
},
|
||
"created_at": {
|
||
"description": "记录时间",
|
||
"format": "date-time",
|
||
"type": "string"
|
||
},
|
||
"end_reason": {
|
||
"description": "结束原因：exchange_return 换货回库",
|
||
"type": "string"
|
||
},
|
||
"ended_at": {
|
||
"description": "该世代结束时间",
|
||
"format": "date-time",
|
||
"type": "string",
|
||
"nullable": true
|
||
},
|
||
"first_purchase_at": {
|
||
"description": "首次购买套餐时间",
|
||
"format": "date-time",
|
||
"type": "string"
|
||
},
|
||
"generation": {
|
||
"description": "世代",
|
||
"type": "integer"
|
||
},
|
||
"id": {
|
||
"description": "记录 ID",
|
||
"minimum": 0,
|
||
"type": "integer"
|
||
},
|
||
"order_no": {
|
||
"description": "订单号",
|
||
"type": "string"
|
||
},
|
||
"source": {
|
||
"description": "来源：order 首次购买套餐 / backfill 历史回填",
|
||
"type": "string"
|
||
},
|
||
"source_name": {
|
||
"description": "来源名称",
|
||
"type": "string"
|
||
}
|
||
},
|
||
"type": "object"
|
||
},
|
||
"ErrorResponse": {
|
||
"properties": {
|
||
"code": {
|
||
"description": "错误码",
|
||
"type": "integer",
|
||
"examples": [
|
||
1001
|
||
]
|
||
},
|
||
"data": {
|
||
"description": "错误详情（可选）",
|
||
"type": "object",
|
||
"properties": {}
|
||
},
|
||
"msg": {
|
||
"description": "错误消息",
|
||
"type": "string",
|
||
"examples": [
|
||
"参数验证失败"
|
||
]
|
||
},
|
||
"timestamp": {
|
||
"description": "时间戳",
|
||
"format": "date-time",
|
||
"type": "string"
|
||
}
|
||
},
|
||
"required": [
|
||
"code",
|
||
"msg",
|
||
"timestamp"
|
||
],
|
||
"type": "object"
|
||
},
|
||
"DtoSilenceBatchPageResult": {
|
||
"properties": {
|
||
"items": {
|
||
"description": "批次列表",
|
||
"items": {
|
||
"$ref": "#/components/schemas/DtoSilenceBatchResponse"
|
||
},
|
||
"type": "array"
|
||
},
|
||
"page": {
|
||
"description": "页码",
|
||
"type": "integer"
|
||
},
|
||
"page_size": {
|
||
"description": "每页数量",
|
||
"type": "integer"
|
||
},
|
||
"total": {
|
||
"description": "总数",
|
||
"type": "integer"
|
||
}
|
||
},
|
||
"type": "object"
|
||
},
|
||
"DtoSilenceBatchResponse": {
|
||
"properties": {
|
||
"amount": {
|
||
"description": "费用（分）",
|
||
"type": "integer"
|
||
},
|
||
"approval_instance_id": {
|
||
"description": "审批实例 ID",
|
||
"minimum": 0,
|
||
"type": "integer",
|
||
"nullable": true
|
||
},
|
||
"approval_required": {
|
||
"description": "是否需要审批",
|
||
"type": "boolean"
|
||
},
|
||
"approval_status": {
|
||
"description": "审批状态",
|
||
"type": "string"
|
||
},
|
||
"basis": {
|
||
"description": "依据",
|
||
"type": "string"
|
||
},
|
||
"batch_no": {
|
||
"description": "批次号",
|
||
"type": "string"
|
||
},
|
||
"completed_at": {
|
||
"description": "完成时间",
|
||
"format": "date-time",
|
||
"type": "string",
|
||
"nullable": true
|
||
},
|
||
"evidence_refs": {
|
||
"description": "附件",
|
||
"items": {
|
||
"type": "string"
|
||
},
|
||
"type": "array"
|
||
},
|
||
"extension_type": {
|
||
"description": "延期类型",
|
||
"type": "string"
|
||
},
|
||
"failed_count": {
|
||
"description": "失败数",
|
||
"type": "integer"
|
||
},
|
||
"id": {
|
||
"description": "批次 ID",
|
||
"minimum": 0,
|
||
"type": "integer"
|
||
},
|
||
"items": {
|
||
"description": "明细",
|
||
"items": {
|
||
"$ref": "#/components/schemas/DtoSilenceExtensionResponse"
|
||
},
|
||
"type": "array"
|
||
},
|
||
"path": {
|
||
"description": "路径：online / offline / special / adjust",
|
||
"type": "string"
|
||
},
|
||
"reason": {
|
||
"description": "原因",
|
||
"type": "string"
|
||
},
|
||
"requested_at": {
|
||
"description": "发起时间",
|
||
"format": "date-time",
|
||
"type": "string"
|
||
},
|
||
"requested_by": {
|
||
"description": "发起人",
|
||
"minimum": 0,
|
||
"type": "integer"
|
||
},
|
||
"requested_count": {
|
||
"description": "明细数",
|
||
"type": "integer"
|
||
},
|
||
"status": {
|
||
"description": "批次状态",
|
||
"type": "string"
|
||
},
|
||
"succeeded_count": {
|
||
"description": "成功数",
|
||
"type": "integer"
|
||
}
|
||
},
|
||
"type": "object"
|
||
},
|
||
"DtoSilenceExtensionResponse": {
|
||
"properties": {
|
||
"after_deadline_at": {
|
||
"description": "延期后截止时间",
|
||
"format": "date-time",
|
||
"type": "string",
|
||
"nullable": true
|
||
},
|
||
"amount": {
|
||
"description": "金额（分）",
|
||
"type": "integer"
|
||
},
|
||
"asset_identifier": {
|
||
"description": "资产标识",
|
||
"type": "string"
|
||
},
|
||
"asset_type": {
|
||
"description": "资产类型",
|
||
"type": "string"
|
||
},
|
||
"batch_id": {
|
||
"description": "批次 ID",
|
||
"minimum": 0,
|
||
"type": "integer"
|
||
},
|
||
"before_deadline_at": {
|
||
"description": "延期前截止时间",
|
||
"format": "date-time",
|
||
"type": "string",
|
||
"nullable": true
|
||
},
|
||
"executed_at": {
|
||
"description": "执行时间",
|
||
"format": "date-time",
|
||
"type": "string",
|
||
"nullable": true
|
||
},
|
||
"extension_days": {
|
||
"description": "延长天数",
|
||
"type": "integer"
|
||
},
|
||
"extension_order_id": {
|
||
"description": "延期订单 ID",
|
||
"minimum": 0,
|
||
"type": "integer",
|
||
"nullable": true
|
||
},
|
||
"extension_type": {
|
||
"description": "延期类型",
|
||
"type": "string"
|
||
},
|
||
"failure_code": {
|
||
"description": "失败 / 异常原因码",
|
||
"type": "string"
|
||
},
|
||
"failure_summary": {
|
||
"description": "失败 / 异常说明",
|
||
"type": "string"
|
||
},
|
||
"id": {
|
||
"description": "明细 ID",
|
||
"minimum": 0,
|
||
"type": "integer"
|
||
},
|
||
"input_days": {
|
||
"description": "输入天数",
|
||
"type": "integer"
|
||
},
|
||
"months": {
|
||
"description": "计费月数",
|
||
"type": "integer"
|
||
},
|
||
"package_name": {
|
||
"description": "套餐名称",
|
||
"type": "string"
|
||
},
|
||
"package_usage_id": {
|
||
"description": "套餐记录 ID",
|
||
"minimum": 0,
|
||
"type": "integer"
|
||
},
|
||
"row_no": {
|
||
"description": "行号",
|
||
"type": "integer"
|
||
},
|
||
"status": {
|
||
"description": "明细状态",
|
||
"type": "string"
|
||
}
|
||
},
|
||
"type": "object"
|
||
},
|
||
"DtoSilenceEligibilityResponse": {
|
||
"properties": {
|
||
"can_extend": {
|
||
"description": "能否办理付费延期",
|
||
"type": "boolean"
|
||
},
|
||
"extended_days": {
|
||
"description": "已累计延期天数",
|
||
"type": "integer"
|
||
},
|
||
"extension_enabled": {
|
||
"description": "套餐是否支持付费延期",
|
||
"type": "boolean"
|
||
},
|
||
"free_extension_available": {
|
||
"description": "是否还能申请免费延期",
|
||
"type": "boolean"
|
||
},
|
||
"free_extension_limit": {
|
||
"description": "免费延期次数上限",
|
||
"type": "integer"
|
||
},
|
||
"free_extension_used": {
|
||
"description": "已使用免费延期次数",
|
||
"type": "integer"
|
||
},
|
||
"max_days": {
|
||
"description": "本次付费延期可输入的最多天数",
|
||
"type": "integer"
|
||
},
|
||
"max_months": {
|
||
"description": "本次付费延期最多月数（特殊延期不受此限）",
|
||
"type": "integer"
|
||
},
|
||
"min_days": {
|
||
"description": "可输入的最少天数（付费与特殊延期都适用）",
|
||
"type": "integer"
|
||
},
|
||
"min_months": {
|
||
"description": "最少延期月数",
|
||
"type": "integer"
|
||
},
|
||
"options": {
|
||
"description": "min～max 每档计费天数、金额与新截止日期",
|
||
"items": {
|
||
"$ref": "#/components/schemas/DtoSilenceExtensionOption"
|
||
},
|
||
"type": "array"
|
||
},
|
||
"original_deadline": {
|
||
"description": "当前截止日期（YYYY-MM-DD）",
|
||
"type": "string"
|
||
},
|
||
"overdue_days": {
|
||
"description": "已过期天数",
|
||
"type": "integer"
|
||
},
|
||
"package_usage_id": {
|
||
"description": "套餐记录 ID",
|
||
"minimum": 0,
|
||
"type": "integer"
|
||
},
|
||
"paid_extended_days": {
|
||
"description": "其中付费延期累计天数",
|
||
"type": "integer"
|
||
},
|
||
"pending_order_no": {
|
||
"description": "未结束的延期订单号（有则不能新建，需先完成或关闭）",
|
||
"type": "string"
|
||
},
|
||
"policy_id": {
|
||
"description": "当前匹配的延期政策 ID",
|
||
"minimum": 0,
|
||
"type": "integer",
|
||
"nullable": true
|
||
},
|
||
"policy_name": {
|
||
"description": "当前匹配的延期政策名称",
|
||
"type": "string"
|
||
},
|
||
"reason": {
|
||
"description": "付费延期不能办理的原因：not_expired/no_silence/extension_disabled/no_policy/exceeds_limit/refunded/order_pending/activated/adjust_pending",
|
||
"type": "string"
|
||
},
|
||
"silence_status": {
|
||
"description": "沉默期状态（待实名但已到期的先判定为过期）",
|
||
"type": "string"
|
||
},
|
||
"special_extension_available": {
|
||
"description": "能否申请特殊延期（只要求套餐已过期）",
|
||
"type": "boolean"
|
||
},
|
||
"unit_price": {
|
||
"description": "每月单价（分），取当前匹配的延期政策",
|
||
"type": "integer"
|
||
}
|
||
},
|
||
"type": "object"
|
||
},
|
||
"DtoSilenceExtensionOption": {
|
||
"properties": {
|
||
"amount": {
|
||
"description": "金额（分）",
|
||
"type": "integer"
|
||
},
|
||
"billed_days": {
|
||
"description": "计费 / 延长天数（月数 × 30）",
|
||
"type": "integer"
|
||
},
|
||
"months": {
|
||
"description": "计费月数",
|
||
"type": "integer"
|
||
},
|
||
"new_deadline": {
|
||
"description": "新截止日期（YYYY-MM-DD，当日 23:59:59 截止）",
|
||
"type": "string"
|
||
}
|
||
},
|
||
"type": "object"
|
||
},
|
||
"DtoSilenceExceptionHandleParams": {
|
||
"properties": {
|
||
"action": {
|
||
"description": "处理方式：retry 重试执行 / close 关闭（在线订单关闭时原路退款）",
|
||
"type": "string"
|
||
},
|
||
"id": {
|
||
"description": "延期明细 ID",
|
||
"minimum": 0,
|
||
"type": "integer"
|
||
},
|
||
"reason": {
|
||
"description": "处理原因",
|
||
"type": "string"
|
||
}
|
||
},
|
||
"required": [
|
||
"action",
|
||
"id",
|
||
"reason"
|
||
],
|
||
"type": "object"
|
||
},
|
||
"DtoSilenceOrderPageResult": {
|
||
"properties": {
|
||
"items": {
|
||
"description": "订单列表",
|
||
"items": {
|
||
"$ref": "#/components/schemas/DtoSilenceExtensionOrderResponse"
|
||
},
|
||
"type": "array"
|
||
},
|
||
"page": {
|
||
"description": "页码",
|
||
"type": "integer"
|
||
},
|
||
"page_size": {
|
||
"description": "每页数量",
|
||
"type": "integer"
|
||
},
|
||
"total": {
|
||
"description": "总数",
|
||
"type": "integer"
|
||
}
|
||
},
|
||
"type": "object"
|
||
},
|
||
"DtoSilenceExtensionOrderResponse": {
|
||
"properties": {
|
||
"amount": {
|
||
"description": "应付金额（分）",
|
||
"type": "integer"
|
||
},
|
||
"approval_instance_id": {
|
||
"description": "审批实例 ID",
|
||
"minimum": 0,
|
||
"type": "integer",
|
||
"nullable": true
|
||
},
|
||
"approval_required": {
|
||
"description": "是否需要审批",
|
||
"type": "boolean"
|
||
},
|
||
"asset_id": {
|
||
"description": "资产 ID",
|
||
"minimum": 0,
|
||
"type": "integer"
|
||
},
|
||
"asset_identifier": {
|
||
"description": "资产标识快照",
|
||
"type": "string"
|
||
},
|
||
"asset_type": {
|
||
"description": "资产类型 iot_card / device",
|
||
"type": "string"
|
||
},
|
||
"batch_no": {
|
||
"description": "批次号",
|
||
"type": "string"
|
||
},
|
||
"before_deadline_at": {
|
||
"description": "下单时截止时间",
|
||
"format": "date-time",
|
||
"type": "string"
|
||
},
|
||
"completed_at": {
|
||
"description": "延期生效时间",
|
||
"format": "date-time",
|
||
"type": "string",
|
||
"nullable": true
|
||
},
|
||
"created_at": {
|
||
"description": "创建时间",
|
||
"format": "date-time",
|
||
"type": "string"
|
||
},
|
||
"created_by": {
|
||
"description": "后台创建人",
|
||
"minimum": 0,
|
||
"type": "integer",
|
||
"nullable": true
|
||
},
|
||
"customer_id": {
|
||
"description": "H5 下单的客户",
|
||
"minimum": 0,
|
||
"type": "integer",
|
||
"nullable": true
|
||
},
|
||
"evidence_refs": {
|
||
"description": "申请依据",
|
||
"items": {
|
||
"type": "string"
|
||
},
|
||
"type": "array"
|
||
},
|
||
"exception_code": {
|
||
"description": "异常原因码",
|
||
"type": "string"
|
||
},
|
||
"exception_summary": {
|
||
"description": "异常说明",
|
||
"type": "string"
|
||
},
|
||
"expected_deadline_at": {
|
||
"description": "预计新截止时间",
|
||
"format": "date-time",
|
||
"type": "string"
|
||
},
|
||
"expire_at": {
|
||
"description": "支付截止时间",
|
||
"format": "date-time",
|
||
"type": "string",
|
||
"nullable": true
|
||
},
|
||
"extension_days": {
|
||
"description": "计费 / 延长天数",
|
||
"type": "integer"
|
||
},
|
||
"id": {
|
||
"description": "订单 ID",
|
||
"minimum": 0,
|
||
"type": "integer"
|
||
},
|
||
"input_days": {
|
||
"description": "输入天数",
|
||
"type": "integer"
|
||
},
|
||
"months": {
|
||
"description": "计费月数",
|
||
"type": "integer"
|
||
},
|
||
"offline_payment_method_name": {
|
||
"description": "线下收款方式",
|
||
"type": "string"
|
||
},
|
||
"offline_trade_no": {
|
||
"description": "线下交易单号",
|
||
"type": "string"
|
||
},
|
||
"order_no": {
|
||
"description": "订单号",
|
||
"type": "string"
|
||
},
|
||
"package_id": {
|
||
"description": "套餐 ID",
|
||
"minimum": 0,
|
||
"type": "integer"
|
||
},
|
||
"package_name": {
|
||
"description": "套餐名称快照",
|
||
"type": "string"
|
||
},
|
||
"package_usage_id": {
|
||
"description": "套餐记录 ID",
|
||
"minimum": 0,
|
||
"type": "integer"
|
||
},
|
||
"paid_amount": {
|
||
"description": "实付金额（分）",
|
||
"type": "integer",
|
||
"nullable": true
|
||
},
|
||
"paid_at": {
|
||
"description": "支付时间",
|
||
"format": "date-time",
|
||
"type": "string",
|
||
"nullable": true
|
||
},
|
||
"payment_merchant_name": {
|
||
"description": "收款商户名称（取已支付或已退款支付单快照）",
|
||
"type": "string"
|
||
},
|
||
"payment_method": {
|
||
"description": "支付方式：wechat/alipay/offline",
|
||
"type": "string"
|
||
},
|
||
"payment_no": {
|
||
"description": "支付单号",
|
||
"type": "string"
|
||
},
|
||
"payment_voucher_keys": {
|
||
"description": "线下收款凭证",
|
||
"items": {
|
||
"type": "string"
|
||
},
|
||
"type": "array"
|
||
},
|
||
"policy_name": {
|
||
"description": "政策名称快照",
|
||
"type": "string"
|
||
},
|
||
"qr_content": {
|
||
"description": "支付内容（待支付时返回，前端渲染为二维码或跳转链接）",
|
||
"type": "string"
|
||
},
|
||
"refund_amount": {
|
||
"description": "退款金额",
|
||
"type": "integer",
|
||
"nullable": true
|
||
},
|
||
"refund_no": {
|
||
"description": "原路退款单号（仅执行异常）",
|
||
"type": "string"
|
||
},
|
||
"refunded_at": {
|
||
"description": "退款时间",
|
||
"format": "date-time",
|
||
"type": "string",
|
||
"nullable": true
|
||
},
|
||
"shop_id": {
|
||
"description": "下单时资产所属店铺",
|
||
"minimum": 0,
|
||
"type": "integer"
|
||
},
|
||
"source": {
|
||
"description": "来源：client / admin / offline",
|
||
"type": "string"
|
||
},
|
||
"source_name": {
|
||
"description": "来源名称",
|
||
"type": "string"
|
||
},
|
||
"status": {
|
||
"description": "状态：pending_payment/pending_approval/rejected/paid/completed/closed/exception/refunded",
|
||
"type": "string"
|
||
},
|
||
"status_name": {
|
||
"description": "状态名称",
|
||
"type": "string"
|
||
},
|
||
"third_party_trade_no": {
|
||
"description": "交易流水号",
|
||
"type": "string"
|
||
},
|
||
"unit_price": {
|
||
"description": "单价（分/月）",
|
||
"type": "integer"
|
||
}
|
||
},
|
||
"type": "object"
|
||
},
|
||
"DtoSilenceOfflineOrderRequest": {
|
||
"properties": {
|
||
"days": {
|
||
"description": "输入的延期天数",
|
||
"type": "integer"
|
||
},
|
||
"evidence_refs": {
|
||
"description": "客户申请依据",
|
||
"items": {
|
||
"type": "string"
|
||
},
|
||
"type": "array",
|
||
"nullable": true
|
||
},
|
||
"offline_payment_method_id": {
|
||
"description": "线下收款方式（字典 ID）",
|
||
"minimum": 0,
|
||
"type": "integer"
|
||
},
|
||
"offline_trade_no": {
|
||
"description": "线下交易单号（同一收款方式下唯一）",
|
||
"type": "string"
|
||
},
|
||
"package_usage_id": {
|
||
"description": "套餐记录 ID",
|
||
"minimum": 0,
|
||
"type": "integer"
|
||
},
|
||
"paid_amount": {
|
||
"description": "实收金额（分），必须等于系统计算金额",
|
||
"type": "integer"
|
||
},
|
||
"paid_at": {
|
||
"description": "付款时间",
|
||
"format": "date-time",
|
||
"type": "string"
|
||
},
|
||
"payment_voucher_keys": {
|
||
"description": "收款凭证对象存储 Key（1～5 个）",
|
||
"items": {
|
||
"type": "string"
|
||
},
|
||
"type": "array",
|
||
"nullable": true
|
||
},
|
||
"request_id": {
|
||
"description": "幂等键",
|
||
"type": "string"
|
||
}
|
||
},
|
||
"required": [
|
||
"days",
|
||
"offline_payment_method_id",
|
||
"offline_trade_no",
|
||
"package_usage_id",
|
||
"paid_at",
|
||
"payment_voucher_keys",
|
||
"request_id"
|
||
],
|
||
"type": "object"
|
||
},
|
||
"DtoSilenceOnlineOrderRequest": {
|
||
"properties": {
|
||
"days": {
|
||
"description": "输入的延期天数",
|
||
"type": "integer"
|
||
},
|
||
"evidence_refs": {
|
||
"description": "客户申请记录或截图对象存储 Key（后台创建时填写）",
|
||
"items": {
|
||
"type": "string"
|
||
},
|
||
"type": "array",
|
||
"nullable": true
|
||
},
|
||
"package_usage_id": {
|
||
"description": "套餐记录 ID",
|
||
"minimum": 0,
|
||
"type": "integer"
|
||
},
|
||
"payment_method": {
|
||
"description": "支付方式：wechat / alipay（经商户池路由）",
|
||
"type": "string"
|
||
},
|
||
"request_id": {
|
||
"description": "下单幂等键",
|
||
"type": "string"
|
||
}
|
||
},
|
||
"required": [
|
||
"days",
|
||
"package_usage_id",
|
||
"payment_method",
|
||
"request_id"
|
||
],
|
||
"type": "object"
|
||
},
|
||
"DtoSilenceQuoteResponse": {
|
||
"properties": {
|
||
"amount": {
|
||
"description": "金额（分）",
|
||
"type": "integer"
|
||
},
|
||
"billed_days": {
|
||
"description": "计费 / 延长天数",
|
||
"type": "integer"
|
||
},
|
||
"input_days": {
|
||
"description": "输入天数",
|
||
"type": "integer"
|
||
},
|
||
"months": {
|
||
"description": "计费月数",
|
||
"type": "integer"
|
||
},
|
||
"new_deadline": {
|
||
"description": "新截止日期",
|
||
"type": "string"
|
||
},
|
||
"valid": {
|
||
"description": "是否在可办理范围内",
|
||
"type": "boolean"
|
||
}
|
||
},
|
||
"type": "object"
|
||
},
|
||
"DtoSilenceSpecialRequest": {
|
||
"properties": {
|
||
"amount": {
|
||
"description": "费用（分，免费为 0；优惠价为实收合计）",
|
||
"type": "integer"
|
||
},
|
||
"basis": {
|
||
"description": "免费或优惠依据",
|
||
"type": "string"
|
||
},
|
||
"evidence_refs": {
|
||
"description": "客户申请记录或截图",
|
||
"items": {
|
||
"type": "string"
|
||
},
|
||
"type": "array",
|
||
"nullable": true
|
||
},
|
||
"extension_type": {
|
||
"description": "延期类型：free 免费 / discount 优惠价 / complaint_compensation 客诉补偿 / system_compensation 系统异常补偿 / special_customer 特殊客户政策",
|
||
"type": "string"
|
||
},
|
||
"import_file_key": {
|
||
"description": "批量导入的明细文件 Key",
|
||
"type": "string"
|
||
},
|
||
"items": {
|
||
"description": "明细（批量需 package_silence:extend_batch 权限）",
|
||
"items": {
|
||
"$ref": "#/components/schemas/DtoSilenceSpecialItem"
|
||
},
|
||
"type": "array",
|
||
"nullable": true
|
||
},
|
||
"offline_paid_at": {
|
||
"description": "优惠价有收款时：付款时间",
|
||
"format": "date-time",
|
||
"type": "string",
|
||
"nullable": true
|
||
},
|
||
"offline_payment_method_id": {
|
||
"description": "优惠价有收款时：线下收款方式",
|
||
"minimum": 0,
|
||
"type": "integer",
|
||
"nullable": true
|
||
},
|
||
"offline_trade_no": {
|
||
"description": "优惠价有收款时：交易单号",
|
||
"type": "string"
|
||
},
|
||
"payment_voucher_keys": {
|
||
"description": "优惠价有收款时：收款凭证",
|
||
"items": {
|
||
"type": "string"
|
||
},
|
||
"type": "array",
|
||
"nullable": true
|
||
},
|
||
"reason": {
|
||
"description": "原因",
|
||
"type": "string"
|
||
}
|
||
},
|
||
"required": [
|
||
"extension_type",
|
||
"items",
|
||
"reason"
|
||
],
|
||
"type": "object"
|
||
},
|
||
"DtoSilenceSpecialItem": {
|
||
"properties": {
|
||
"days": {
|
||
"description": "延期天数（按 30 天向上取整）",
|
||
"type": "integer"
|
||
},
|
||
"package_usage_id": {
|
||
"description": "套餐记录 ID",
|
||
"minimum": 0,
|
||
"type": "integer"
|
||
}
|
||
},
|
||
"required": [
|
||
"days",
|
||
"package_usage_id"
|
||
],
|
||
"type": "object"
|
||
},
|
||
"DtoSilencePolicyResponse": {
|
||
"properties": {
|
||
"approval_exempt_types": {
|
||
"description": "免审批场景",
|
||
"items": {
|
||
"type": "string"
|
||
},
|
||
"type": "array"
|
||
},
|
||
"created_at": {
|
||
"description": "创建时间",
|
||
"format": "date-time",
|
||
"type": "string"
|
||
},
|
||
"creator": {
|
||
"description": "创建人",
|
||
"minimum": 0,
|
||
"type": "integer"
|
||
},
|
||
"effective_from": {
|
||
"description": "生效时间",
|
||
"format": "date-time",
|
||
"type": "string"
|
||
},
|
||
"effective_to": {
|
||
"description": "失效时间",
|
||
"format": "date-time",
|
||
"type": "string",
|
||
"nullable": true
|
||
},
|
||
"free_extension_limit": {
|
||
"description": "免费延期次数",
|
||
"type": "integer"
|
||
},
|
||
"id": {
|
||
"description": "政策 ID",
|
||
"minimum": 0,
|
||
"type": "integer"
|
||
},
|
||
"name": {
|
||
"description": "政策名称",
|
||
"type": "string"
|
||
},
|
||
"paid_max_months": {
|
||
"description": "付费延期累计最多月数",
|
||
"type": "integer"
|
||
},
|
||
"remark": {
|
||
"description": "备注",
|
||
"type": "string"
|
||
},
|
||
"scope_ids": {
|
||
"description": "系列或套餐 ID 列表",
|
||
"items": {
|
||
"minimum": 0,
|
||
"type": "integer"
|
||
},
|
||
"type": "array"
|
||
},
|
||
"scope_type": {
|
||
"description": "适用范围",
|
||
"type": "string"
|
||
},
|
||
"scope_type_name": {
|
||
"description": "适用范围名称",
|
||
"type": "string"
|
||
},
|
||
"single_max_months": {
|
||
"description": "单次付费延期最多月数",
|
||
"type": "integer",
|
||
"nullable": true
|
||
},
|
||
"status": {
|
||
"description": "状态：0-停用 1-启用",
|
||
"type": "integer"
|
||
},
|
||
"unit_price": {
|
||
"description": "每月单价（分）",
|
||
"type": "integer"
|
||
},
|
||
"updated_at": {
|
||
"description": "更新时间",
|
||
"format": "date-time",
|
||
"type": "string"
|
||
},
|
||
"updater": {
|
||
"description": "更新人",
|
||
"minimum": 0,
|
||
"type": "integer"
|
||
}
|
||
},
|
||
"type": "object"
|
||
},
|
||
"DtoSilencePolicyRequest": {
|
||
"properties": {
|
||
"approval_exempt_types": {
|
||
"description": "免审批场景（多选，空表示全部需审批）",
|
||
"items": {
|
||
"type": "string"
|
||
},
|
||
"type": "array",
|
||
"nullable": true
|
||
},
|
||
"effective_from": {
|
||
"description": "生效时间",
|
||
"format": "date-time",
|
||
"type": "string"
|
||
},
|
||
"effective_to": {
|
||
"description": "失效时间（为空表示长期）",
|
||
"format": "date-time",
|
||
"type": "string",
|
||
"nullable": true
|
||
},
|
||
"free_extension_limit": {
|
||
"description": "每笔套餐免费延期次数",
|
||
"minimum": 0,
|
||
"type": "integer"
|
||
},
|
||
"name": {
|
||
"description": "政策名称（唯一）",
|
||
"maxLength": 100,
|
||
"type": "string"
|
||
},
|
||
"paid_max_months": {
|
||
"description": "付费延期累计最多月数",
|
||
"minimum": 0,
|
||
"type": "integer"
|
||
},
|
||
"remark": {
|
||
"description": "备注",
|
||
"maxLength": 500,
|
||
"type": "string"
|
||
},
|
||
"scope_ids": {
|
||
"description": "系列 ID 或套餐 ID 列表（all 时为空）",
|
||
"items": {
|
||
"minimum": 0,
|
||
"type": "integer"
|
||
},
|
||
"type": "array",
|
||
"nullable": true
|
||
},
|
||
"scope_type": {
|
||
"description": "适用范围：all-全部套餐 series-套餐系列 package-指定套餐",
|
||
"type": "string"
|
||
},
|
||
"single_max_months": {
|
||
"description": "单次付费延期最多月数（为空表示不单独限制）",
|
||
"type": "integer",
|
||
"nullable": true
|
||
},
|
||
"status": {
|
||
"description": "状态：0-停用 1-启用（新增默认启用）",
|
||
"type": "integer",
|
||
"nullable": true
|
||
},
|
||
"unit_price": {
|
||
"description": "每月单价（分），1 月 = 30 天",
|
||
"minimum": 0,
|
||
"type": "integer"
|
||
}
|
||
},
|
||
"required": [
|
||
"effective_from",
|
||
"name",
|
||
"scope_type"
|
||
],
|
||
"type": "object"
|
||
},
|
||
"DtoSilencePolicyUpdateParams": {
|
||
"properties": {
|
||
"approval_exempt_types": {
|
||
"description": "免审批场景（多选，空表示全部需审批）",
|
||
"items": {
|
||
"type": "string"
|
||
},
|
||
"type": "array",
|
||
"nullable": true
|
||
},
|
||
"effective_from": {
|
||
"description": "生效时间",
|
||
"format": "date-time",
|
||
"type": "string"
|
||
},
|
||
"effective_to": {
|
||
"description": "失效时间（为空表示长期）",
|
||
"format": "date-time",
|
||
"type": "string",
|
||
"nullable": true
|
||
},
|
||
"free_extension_limit": {
|
||
"description": "每笔套餐免费延期次数",
|
||
"minimum": 0,
|
||
"type": "integer"
|
||
},
|
||
"id": {
|
||
"description": "政策 ID",
|
||
"minimum": 0,
|
||
"type": "integer"
|
||
},
|
||
"name": {
|
||
"description": "政策名称（唯一）",
|
||
"maxLength": 100,
|
||
"type": "string"
|
||
},
|
||
"paid_max_months": {
|
||
"description": "付费延期累计最多月数",
|
||
"minimum": 0,
|
||
"type": "integer"
|
||
},
|
||
"remark": {
|
||
"description": "备注",
|
||
"maxLength": 500,
|
||
"type": "string"
|
||
},
|
||
"scope_ids": {
|
||
"description": "系列 ID 或套餐 ID 列表（all 时为空）",
|
||
"items": {
|
||
"minimum": 0,
|
||
"type": "integer"
|
||
},
|
||
"type": "array",
|
||
"nullable": true
|
||
},
|
||
"scope_type": {
|
||
"description": "适用范围：all-全部套餐 series-套餐系列 package-指定套餐",
|
||
"type": "string"
|
||
},
|
||
"single_max_months": {
|
||
"description": "单次付费延期最多月数（为空表示不单独限制）",
|
||
"type": "integer",
|
||
"nullable": true
|
||
},
|
||
"status": {
|
||
"description": "状态：0-停用 1-启用（新增默认启用）",
|
||
"type": "integer",
|
||
"nullable": true
|
||
},
|
||
"unit_price": {
|
||
"description": "每月单价（分），1 月 = 30 天",
|
||
"minimum": 0,
|
||
"type": "integer"
|
||
}
|
||
},
|
||
"required": [
|
||
"effective_from",
|
||
"id",
|
||
"name",
|
||
"scope_type"
|
||
],
|
||
"type": "object"
|
||
},
|
||
"DtoSilencePolicyStatusParams": {
|
||
"properties": {
|
||
"id": {
|
||
"description": "政策 ID",
|
||
"minimum": 0,
|
||
"type": "integer"
|
||
},
|
||
"status": {
|
||
"description": "状态：0-停用 1-启用",
|
||
"type": "integer",
|
||
"nullable": true
|
||
}
|
||
},
|
||
"required": [
|
||
"id",
|
||
"status"
|
||
],
|
||
"type": "object"
|
||
},
|
||
"DtoSilencePolicyMatchResponse": {
|
||
"properties": {
|
||
"matched": {
|
||
"description": "是否匹配到政策（未匹配时不能付费延期，特殊延期仍可申请）",
|
||
"type": "boolean"
|
||
},
|
||
"package_id": {
|
||
"description": "套餐 ID",
|
||
"minimum": 0,
|
||
"type": "integer"
|
||
},
|
||
"policy": {
|
||
"$ref": "#/components/schemas/DtoSilencePolicyResponse"
|
||
}
|
||
},
|
||
"type": "object"
|
||
},
|
||
"DtoSilenceRecordResponse": {
|
||
"properties": {
|
||
"after_deadline_at": {
|
||
"description": "变更后截止时间",
|
||
"format": "date-time",
|
||
"type": "string",
|
||
"nullable": true
|
||
},
|
||
"after_status": {
|
||
"description": "变更后状态",
|
||
"type": "string",
|
||
"nullable": true
|
||
},
|
||
"approval_instance_id": {
|
||
"description": "审批实例",
|
||
"minimum": 0,
|
||
"type": "integer",
|
||
"nullable": true
|
||
},
|
||
"asset_id": {
|
||
"description": "资产 ID",
|
||
"minimum": 0,
|
||
"type": "integer"
|
||
},
|
||
"asset_type": {
|
||
"description": "资产类型",
|
||
"type": "string"
|
||
},
|
||
"batch_id": {
|
||
"description": "批次",
|
||
"minimum": 0,
|
||
"type": "integer",
|
||
"nullable": true
|
||
},
|
||
"before_deadline_at": {
|
||
"description": "变更前截止时间",
|
||
"format": "date-time",
|
||
"type": "string",
|
||
"nullable": true
|
||
},
|
||
"before_status": {
|
||
"description": "变更前状态",
|
||
"type": "string",
|
||
"nullable": true
|
||
},
|
||
"change_days": {
|
||
"description": "变化天数",
|
||
"type": "integer"
|
||
},
|
||
"created_at": {
|
||
"description": "时间",
|
||
"format": "date-time",
|
||
"type": "string"
|
||
},
|
||
"default_days": {
|
||
"description": "默认值快照",
|
||
"type": "integer",
|
||
"nullable": true
|
||
},
|
||
"event_name": {
|
||
"description": "事件名称",
|
||
"type": "string"
|
||
},
|
||
"event_type": {
|
||
"description": "事件：set/adjust/expired/ended/extend/exchange/backfill/realname_backfill",
|
||
"type": "string"
|
||
},
|
||
"exchange_no": {
|
||
"description": "换货单号",
|
||
"type": "string"
|
||
},
|
||
"extension_id": {
|
||
"description": "延期明细",
|
||
"minimum": 0,
|
||
"type": "integer",
|
||
"nullable": true
|
||
},
|
||
"id": {
|
||
"description": "流水 ID",
|
||
"minimum": 0,
|
||
"type": "integer"
|
||
},
|
||
"is_adjusted": {
|
||
"description": "是否调整",
|
||
"type": "boolean"
|
||
},
|
||
"operator_id": {
|
||
"description": "操作人",
|
||
"minimum": 0,
|
||
"type": "integer"
|
||
},
|
||
"operator_type": {
|
||
"description": "操作人类型",
|
||
"type": "string"
|
||
},
|
||
"package_usage_id": {
|
||
"description": "套餐记录 ID",
|
||
"minimum": 0,
|
||
"type": "integer"
|
||
},
|
||
"period_days": {
|
||
"description": "沉默期天数",
|
||
"type": "integer",
|
||
"nullable": true
|
||
},
|
||
"reason": {
|
||
"description": "原因",
|
||
"type": "string"
|
||
},
|
||
"trigger_source": {
|
||
"description": "触发来源",
|
||
"type": "string"
|
||
}
|
||
},
|
||
"type": "object"
|
||
},
|
||
"DtoSilenceSwitchResponse": {
|
||
"properties": {
|
||
"enabled": {
|
||
"description": "总开关是否打开",
|
||
"type": "boolean"
|
||
},
|
||
"precheck": {
|
||
"description": "打开前检查各项结果",
|
||
"items": {
|
||
"$ref": "#/components/schemas/DtoSilenceSwitchPrecheckItem"
|
||
},
|
||
"type": "array"
|
||
},
|
||
"precheck_passed": {
|
||
"description": "打开前检查是否全部通过",
|
||
"type": "boolean"
|
||
}
|
||
},
|
||
"type": "object"
|
||
},
|
||
"DtoSilenceSwitchPrecheckItem": {
|
||
"properties": {
|
||
"code": {
|
||
"description": "检查项：unconfigured_packages / unbackfilled_usages / default_policy_missing / approval_scene_missing",
|
||
"type": "string"
|
||
},
|
||
"count": {
|
||
"description": "数量（前两项为未满足的数量，后两项为已具备的数量）",
|
||
"type": "integer"
|
||
},
|
||
"name": {
|
||
"description": "检查项名称",
|
||
"type": "string"
|
||
},
|
||
"passed": {
|
||
"description": "是否满足",
|
||
"type": "boolean"
|
||
}
|
||
},
|
||
"type": "object"
|
||
},
|
||
"DtoSilenceSwitchRequest": {
|
||
"properties": {
|
||
"enabled": {
|
||
"description": "目标状态：true 打开 / false 关闭（应急关闭不做检查）",
|
||
"type": "boolean",
|
||
"nullable": true
|
||
}
|
||
},
|
||
"required": [
|
||
"enabled"
|
||
],
|
||
"type": "object"
|
||
},
|
||
"DtoSilenceUsagePageResult": {
|
||
"properties": {
|
||
"items": {
|
||
"description": "列表",
|
||
"items": {
|
||
"$ref": "#/components/schemas/DtoSilenceUsageItem"
|
||
},
|
||
"type": "array"
|
||
},
|
||
"page": {
|
||
"description": "页码",
|
||
"type": "integer"
|
||
},
|
||
"page_size": {
|
||
"description": "每页数量",
|
||
"type": "integer"
|
||
},
|
||
"total": {
|
||
"description": "总数",
|
||
"type": "integer"
|
||
}
|
||
},
|
||
"type": "object"
|
||
},
|
||
"DtoSilenceUsageItem": {
|
||
"properties": {
|
||
"asset_id": {
|
||
"description": "资产 ID",
|
||
"minimum": 0,
|
||
"type": "integer"
|
||
},
|
||
"asset_identifier": {
|
||
"description": "资产标识",
|
||
"type": "string"
|
||
},
|
||
"asset_type": {
|
||
"description": "资产类型",
|
||
"type": "string"
|
||
},
|
||
"created_at": {
|
||
"description": "购买时间",
|
||
"format": "date-time",
|
||
"type": "string"
|
||
},
|
||
"order_no": {
|
||
"description": "订单号",
|
||
"type": "string"
|
||
},
|
||
"package_id": {
|
||
"description": "套餐 ID",
|
||
"minimum": 0,
|
||
"type": "integer"
|
||
},
|
||
"package_name": {
|
||
"description": "套餐名称",
|
||
"type": "string"
|
||
},
|
||
"package_usage_id": {
|
||
"description": "套餐记录 ID",
|
||
"minimum": 0,
|
||
"type": "integer"
|
||
},
|
||
"shop_id": {
|
||
"description": "资产所属店铺",
|
||
"minimum": 0,
|
||
"type": "integer",
|
||
"nullable": true
|
||
},
|
||
"shop_name": {
|
||
"description": "店铺名称",
|
||
"type": "string"
|
||
},
|
||
"silence": {
|
||
"$ref": "#/components/schemas/DtoPackageSilenceView"
|
||
}
|
||
},
|
||
"type": "object"
|
||
},
|
||
"DtoPackageSilenceView": {
|
||
"properties": {
|
||
"extendable": {
|
||
"description": "是否显示延期入口（沉默期已过期的待生效套餐）",
|
||
"type": "boolean"
|
||
},
|
||
"silence_adjust_pending": {
|
||
"description": "购买时调整沉默期的审批是否进行中",
|
||
"type": "boolean"
|
||
},
|
||
"silence_deadline_at": {
|
||
"description": "当前沉默期截止时间（截止日 23:59:59）",
|
||
"format": "date-time",
|
||
"type": "string",
|
||
"nullable": true
|
||
},
|
||
"silence_expired_at": {
|
||
"description": "最近一次过期时间",
|
||
"format": "date-time",
|
||
"type": "string",
|
||
"nullable": true
|
||
},
|
||
"silence_extended_days": {
|
||
"description": "累计已延期天数",
|
||
"type": "integer"
|
||
},
|
||
"silence_extension_count": {
|
||
"description": "累计延期次数",
|
||
"type": "integer"
|
||
},
|
||
"silence_free_extension_used": {
|
||
"description": "已使用免费延期次数",
|
||
"type": "integer"
|
||
},
|
||
"silence_paid_extended_days": {
|
||
"description": "其中付费延期累计天数",
|
||
"type": "integer"
|
||
},
|
||
"silence_period_days": {
|
||
"description": "沉默期天数",
|
||
"type": "integer",
|
||
"nullable": true
|
||
},
|
||
"silence_start_at": {
|
||
"description": "沉默期起算时间（购买支付成功时间）",
|
||
"format": "date-time",
|
||
"type": "string",
|
||
"nullable": true
|
||
},
|
||
"silence_status": {
|
||
"description": "沉默期状态：waiting-待实名 expired-沉默期已过期 ended-沉默期已结束；待实名但已过截止的按 expired 返回",
|
||
"type": "string"
|
||
},
|
||
"silence_status_name": {
|
||
"description": "沉默期状态名称（待实名 / 延期待实名 / 沉默期已过期 / 沉默期已结束）",
|
||
"type": "string"
|
||
}
|
||
},
|
||
"type": "object"
|
||
}
|
||
},
|
||
"securitySchemes": {
|
||
"BearerAuth": {
|
||
"bearerFormat": "JWT",
|
||
"scheme": "bearer",
|
||
"type": "jwt"
|
||
},
|
||
"AgentOpenAPIAccount": {
|
||
"description": "代理账号标识，填写代理登录平台使用的用户名或手机号，例如 agent001。",
|
||
"in": "header",
|
||
"name": "X-Agent-Account",
|
||
"type": "apikey"
|
||
},
|
||
"AgentOpenAPINonce": {
|
||
"description": "调用方每次请求自行生成的随机串，不需要平台提前分配；同一账号在 5 分钟内不可重复。",
|
||
"in": "header",
|
||
"name": "X-Agent-Nonce",
|
||
"type": "apikey"
|
||
},
|
||
"AgentOpenAPIPassword": {
|
||
"description": "代理账号当前登录密码，同时作为 HMAC-SHA256 签名密钥；密码变更后必须使用新密码签名。",
|
||
"in": "header",
|
||
"name": "X-Agent-Password",
|
||
"type": "apikey"
|
||
},
|
||
"AgentOpenAPISign": {
|
||
"description": "调用方按签名规则实时计算的 HMAC-SHA256 小写十六进制签名，不是固定值。",
|
||
"in": "header",
|
||
"name": "X-Agent-Sign",
|
||
"type": "apikey"
|
||
},
|
||
"AgentOpenAPITimestamp": {
|
||
"description": "调用方生成的请求发起时间，支持 Unix 秒、Unix 毫秒或 RFC3339 时间，必须与签名原文 timestamp 行一致。",
|
||
"in": "header",
|
||
"name": "X-Agent-Timestamp",
|
||
"type": "apikey"
|
||
},
|
||
"Combination": {
|
||
"group": [
|
||
{
|
||
"id": 1892463
|
||
},
|
||
{
|
||
"id": 1892464
|
||
},
|
||
{
|
||
"id": 1892465
|
||
},
|
||
{
|
||
"id": 1892466
|
||
},
|
||
{
|
||
"id": 1892467
|
||
}
|
||
],
|
||
"type": "combination"
|
||
}
|
||
}
|
||
}
|
||
}
|