hl-api-changelog/.swagger/hl-review-service.json
2026-03-17 15:40:29 +08:00

1029 行
28 KiB
JSON

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

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

{
"swagger": "2.0",
"info": {
"title": "评价服务",
"version": "1.0.0"
},
"basePath": "/",
"paths": {
"/admin/review/list": {
"get": {
"tags": [
"管理端-评价审核"
],
"summary": "评价列表(支持好中差评/有图/有视频筛选)",
"description": "分页查询全部评价(含待审核/已通过/已拒绝),支持按评价等级、是否有图/视频、目标类型筛选\n\n**关联字典**\n- review_status评价审核状态列表筛选+显示)\n- rating_level评价等级列表筛选+显示)",
"operationId": "listReviewsUsingGET",
"produces": [
"*/*"
],
"parameters": [
{
"name": "hasImage",
"in": "query",
"description": "是否有图片: true/false",
"required": false,
"type": "boolean"
},
{
"name": "hasVideo",
"in": "query",
"description": "是否有视频: true/false",
"required": false,
"type": "boolean"
},
{
"name": "keyword",
"in": "query",
"description": "搜索关键词",
"required": false,
"type": "string",
"x-example": "风景"
},
{
"name": "maxRating",
"in": "query",
"description": "最高评分(整体满意度)",
"required": false,
"type": "integer",
"format": "int32",
"x-example": 5
},
{
"name": "minRating",
"in": "query",
"description": "最低评分(整体满意度)",
"required": false,
"type": "integer",
"format": "int32",
"x-example": 3
},
{
"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": "productType",
"in": "query",
"description": "产品类型(字典 review_product_type",
"required": false,
"type": "string",
"x-example": "CORE"
},
{
"name": "ratingLevel",
"in": "query",
"description": "评价等级: GOOD/MEDIUM/BAD",
"required": false,
"type": "string",
"x-example": "GOOD"
},
{
"name": "reviewType",
"in": "query",
"description": "评论类型(字典 review_type",
"required": false,
"type": "string",
"x-example": "PRODUCT"
},
{
"name": "status",
"in": "query",
"description": "评价状态",
"required": false,
"type": "string",
"x-example": "APPROVED"
},
{
"name": "targetId",
"in": "query",
"description": "评价目标ID",
"required": false,
"type": "integer",
"format": "int64",
"x-example": 2001
},
{
"name": "targetType",
"in": "query",
"description": "评价目标类型",
"required": false,
"type": "string",
"x-example": "PRODUCT"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/统一响应结果«分页结果«评价列表项(管理端)»»",
"originalRef": "统一响应结果«分页结果«评价列表项(管理端)»»"
}
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"responsesObject": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/统一响应结果«分页结果«评价列表项(管理端)»»",
"originalRef": "统一响应结果«分页结果«评价列表项(管理端)»»"
}
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"deprecated": false,
"x-order": "2147483647"
}
},
"/admin/review/{reviewId}": {
"get": {
"tags": [
"管理端-评价审核"
],
"summary": "评价详情",
"description": "**关联字典**\n- review_status评价审核状态显示\n- rating_level评价等级显示",
"operationId": "getReviewDetailUsingGET",
"produces": [
"*/*"
],
"parameters": [
{
"name": "reviewId",
"in": "path",
"description": "评价ID",
"required": false,
"type": "integer",
"format": "int64"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/统一响应结果«评价详情»",
"originalRef": "统一响应结果«评价详情»"
}
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"responsesObject": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/统一响应结果«评价详情»",
"originalRef": "统一响应结果«评价详情»"
}
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"deprecated": false,
"x-order": "2147483647"
}
},
"/admin/review/{reviewId}/approve": {
"post": {
"tags": [
"管理端-评价审核"
],
"summary": "通过评价",
"description": "审核通过评价,通过后评价在小程序端公开展示。状态流转PENDING_REVIEW → APPROVED",
"operationId": "approveUsingPOST",
"consumes": [
"application/json"
],
"produces": [
"*/*"
],
"parameters": [
{
"name": "reviewId",
"in": "path",
"description": "评价ID",
"required": false,
"type": "integer",
"format": "int64"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/统一响应结果«Void»",
"originalRef": "统一响应结果«Void»"
}
},
"201": {
"description": "Created"
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"responsesObject": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/统一响应结果«Void»",
"originalRef": "统一响应结果«Void»"
}
},
"201": {
"description": "Created"
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"deprecated": false,
"x-order": "2147483647"
}
},
"/admin/review/{reviewId}/override-approve": {
"post": {
"tags": [
"管理端-评价审核"
],
"summary": "覆盖通过(机器拒绝的)",
"description": "对阿里云内容审核自动拒绝的评价进行人工覆盖通过。状态流转AUTO_REJECTED → APPROVED",
"operationId": "overrideApproveUsingPOST",
"consumes": [
"application/json"
],
"produces": [
"*/*"
],
"parameters": [
{
"name": "reviewId",
"in": "path",
"description": "评价ID",
"required": false,
"type": "integer",
"format": "int64"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/统一响应结果«Void»",
"originalRef": "统一响应结果«Void»"
}
},
"201": {
"description": "Created"
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"responsesObject": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/统一响应结果«Void»",
"originalRef": "统一响应结果«Void»"
}
},
"201": {
"description": "Created"
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"deprecated": false,
"x-order": "2147483647"
}
},
"/admin/review/{reviewId}/reject": {
"post": {
"tags": [
"-"
],
"summary": "",
"description": "PENDING_REVIEW REJECTED",
"operationId": "rejectUsingPOST",
"consumes": [
"application/json"
],
"produces": [
"*/*"
],
"parameters": [
{
"in": "body",
"name": "body",
"description": "",
"required": false,
"schema": {
"$ref": "#/definitions/",
"originalRef": ""
}
},
{
"name": "reviewId",
"in": "path",
"description": "ID",
"required": false,
"type": "integer",
"format": "int64"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/«Void»",
"originalRef": "«Void»"
}
},
"201": {
"description": "Created"
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"responsesObject": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/«Void»",
"originalRef": "«Void»"
}
},
"201": {
"description": "Created"
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"deprecated": false,
"x-order": "2147483647"
}
},
"/admin/review/{reviewId}/reply": {
"post": {
"tags": [
"-"
],
"summary": "()",
"description": "\n\n****",
"operationId": "adminReplyUsingPOST",
"consumes": [
"application/json"
],
"produces": [
"*/*"
],
"parameters": [
{
"in": "body",
"name": "body",
"description": "",
"required": false,
"schema": {
"$ref": "#/definitions/",
"originalRef": ""
}
},
{
"name": "reviewId",
"in": "path",
"description": "ID",
"required": false,
"type": "integer",
"format": "int64"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/«Void»",
"originalRef": "«Void»"
}
},
"201": {
"description": "Created"
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"responsesObject": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/«Void»",
"originalRef": "«Void»"
}
},
"201": {
"description": "Created"
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Not Found"
}
},
"deprecated": false,
"x-order": "2147483647"
}
}
},
"definitions": {
"«()»": {
"type": "object",
"properties": {
"page": {
"type": "integer",
"format": "int32",
"example": 1,
"description": ""
},
"pageSize": {
"type": "integer",
"format": "int32",
"example": 20,
"description": ""
},
"records": {
"type": "array",
"description": "",
"items": {
"$ref": "#/definitions/()",
"originalRef": "()"
}
},
"total": {
"type": "integer",
"format": "int32",
"example": 100,
"description": ""
}
},
"title": "«()»"
},
"": {
"type": "object",
"required": [
"rejectReason"
],
"properties": {
"rejectReason": {
"type": "string",
"example": "",
"description": ""
}
},
"title": ""
},
"": {
"type": "object",
"required": [
"replyContent"
],
"properties": {
"replyContent": {
"type": "string",
"example": "",
"description": ""
}
},
"title": ""
},
"«Void»": {
"type": "object",
"properties": {
"code": {
"type": "integer",
"format": "int32",
"example": 200,
"description": ""
},
"message": {
"type": "string",
"example": "",
"description": ""
}
},
"title": "«Void»"
},
"««()»»": {
"type": "object",
"properties": {
"code": {
"type": "integer",
"format": "int32",
"example": 200,
"description": ""
},
"data": {
"description": "",
"$ref": "#/definitions/«()»",
"originalRef": "«()»"
},
"message": {
"type": "string",
"example": "",
"description": ""
}
},
"title": "««()»»"
},
"«»": {
"type": "object",
"properties": {
"code": {
"type": "integer",
"format": "int32",
"example": 200,
"description": ""
},
"data": {
"description": "",
"$ref": "#/definitions/",
"originalRef": ""
},
"message": {
"type": "string",
"example": "",
"description": ""
}
},
"title": "«»"
},
"()": {
"type": "object",
"properties": {
"auditedAt": {
"type": "string",
"format": "date-time",
"description": ""
},
"auditorName": {
"type": "string",
"description": ""
},
"content": {
"type": "string",
"description": ""
},
"createdAt": {
"type": "string",
"format": "date-time",
"description": ""
},
"hasReply": {
"type": "boolean",
"description": ""
},
"imageCount": {
"type": "integer",
"format": "int32",
"description": ""
},
"orderId": {
"type": "string",
"description": "ID"
},
"orderNo": {
"type": "string",
"description": ""
},
"productType": {
"type": "string",
"description": ""
},
"productTypeLabel": {
"type": "string",
"description": ""
},
"ratingAccommodation": {
"type": "integer",
"format": "int32",
"description": "宿(1-5)"
},
"ratingDining": {
"type": "integer",
"format": "int32",
"description": "(1-5)"
},
"ratingDriver": {
"type": "integer",
"format": "int32",
"description": "(1-5)"
},
"ratingItinerary": {
"type": "integer",
"format": "int32",
"description": "(1-5)"
},
"ratingLevel": {
"type": "string",
"description": ": GOOD/MEDIUM/BAD"
},
"ratingLevelLabel": {
"type": "string",
"description": ""
},
"ratingOverall": {
"type": "integer",
"format": "int32",
"description": "(1-5)"
},
"rejectReason": {
"type": "string",
"description": ""
},
"reviewId": {
"type": "string",
"description": "ID"
},
"reviewType": {
"type": "string",
"description": ""
},
"reviewTypeLabel": {
"type": "string",
"description": ""
},
"status": {
"type": "string",
"description": ""
},
"statusLabel": {
"type": "string",
"description": ""
},
"targetId": {
"type": "string",
"description": "ID"
},
"targetName": {
"type": "string",
"description": ""
},
"targetType": {
"type": "string",
"description": ""
},
"targetTypeLabel": {
"type": "string",
"description": ""
},
"userAvatar": {
"type": "string",
"description": ""
},
"userNickname": {
"type": "string",
"description": ""
},
"videoCount": {
"type": "integer",
"format": "int32",
"description": ""
}
},
"title": "()"
},
"": {
"type": "object",
"properties": {
"fileId": {
"type": "string",
"description": "ID"
},
"imageId": {
"type": "string",
"description": "ID"
},
"imageUrl": {
"type": "string",
"description": "URL"
},
"sortOrder": {
"type": "integer",
"format": "int32",
"description": ""
}
},
"title": ""
},
"": {
"type": "object",
"properties": {
"coverUrl": {
"type": "string",
"description": "URL"
},
"duration": {
"type": "integer",
"format": "int32",
"description": "()"
},
"fileId": {
"type": "string",
"description": "ID"
},
"sortOrder": {
"type": "integer",
"format": "int32",
"description": ""
},
"videoId": {
"type": "string",
"description": "ID"
},
"videoUrl": {
"type": "string",
"description": "URL"
}
},
"title": ""
},
"": {
"type": "object",
"properties": {
"adminReply": {
"type": "string",
"description": ""
},
"adminReplyAt": {
"type": "string",
"format": "date-time",
"description": ""
},
"adminReplyName": {
"type": "string",
"description": ""
},
"auditedAt": {
"type": "string",
"format": "date-time",
"description": ""
},
"auditorAdminId": {
"type": "string",
"description": "ID"
},
"auditorName": {
"type": "string",
"description": ""
},
"content": {
"type": "string",
"description": ""
},
"createdAt": {
"type": "string",
"format": "date-time",
"description": ""
},
"departureDate": {
"type": "string",
"format": "date",
"description": "()"
},
"hasImage": {
"type": "boolean",
"description": ""
},
"hasVideo": {
"type": "boolean",
"description": ""
},
"imageCount": {
"type": "integer",
"format": "int32",
"description": ""
},
"images": {
"type": "array",
"description": "",
"items": {
"$ref": "#/definitions/",
"originalRef": ""
}
},
"machineResult": {
"type": "string",
"description": ""
},
"orderId": {
"type": "string",
"description": "ID"
},
"orderNo": {
"type": "string",
"description": ""
},
"productType": {
"type": "string",
"description": ""
},
"productTypeLabel": {
"type": "string",
"description": ""
},
"ratingAccommodation": {
"type": "integer",
"format": "int32",
"description": "宿(1-5)"
},
"ratingDining": {
"type": "integer",
"format": "int32",
"description": "(1-5)"
},
"ratingDriver": {
"type": "integer",
"format": "int32",
"description": "(1-5)"
},
"ratingItinerary": {
"type": "integer",
"format": "int32",
"description": "(1-5)"
},
"ratingLevel": {
"type": "string",
"description": ": GOOD/MEDIUM/BAD"
},
"ratingLevelLabel": {
"type": "string",
"description": ": //"
},
"ratingOverall": {
"type": "integer",
"format": "int32",
"description": "(1-5)"
},
"rejectReason": {
"type": "string",
"description": ""
},
"reviewId": {
"type": "string",
"description": "ID"
},
"reviewType": {
"type": "string",
"description": ""
},
"reviewTypeLabel": {
"type": "string",
"description": ""
},
"status": {
"type": "string",
"description": ""
},
"statusLabel": {
"type": "string",
"description": ""
},
"targetId": {
"type": "string",
"description": "ID"
},
"targetName": {
"type": "string",
"description": ""
},
"targetType": {
"type": "string",
"description": ""
},
"targetTypeLabel": {
"type": "string",
"description": ""
},
"userAvatar": {
"type": "string",
"description": ""
},
"userId": {
"type": "string",
"description": "ID"
},
"userNickname": {
"type": "string",
"description": ""
},
"videoCount": {
"type": "integer",
"format": "int32",
"description": ""
},
"videos": {
"type": "array",
"description": "",
"items": {
"$ref": "#/definitions/",
"originalRef": ""
}
}
},
"title": ""
}
}
}