{ "openapi": "3.0.1", "info": { "title": "管理后台", "description": "提供管理员管理的所有功能", "contact": {}, "license": {}, "version": "1.0.0" }, "servers": [ { "url": "http://172.16.8.7:48008", "description": "Generated server url" } ], "security": [ { "Authorization": [] }, { "Authorization": [] } ], "paths": { "/open-api/goods/search-url-parse": { "post": { "tags": [ "开放平台 / 商品接口" ], "summary": "电商短链/长链解析", "description": "解析淘宝/1688/微店及常见代购站链接，返回 goodsId 与 goodsSource；rno 非空时拼接到 targetGoodsDetailUrl", "operationId": "searchUrlParse", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OpenGoodsSearchUrlParseReqVO" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/CommonResultOpenGoodsSearchUrlParseRespVO" } } } } } } }, "/open-api/goods/search-by-images": { "post": { "tags": [ "开放平台 / 商品接口" ], "summary": "图片识别搜索商品列表", "operationId": "searchByImages", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OpenGoodsSearchByImagesReqVO" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/CommonResultOpenGoodsSearchRespVO" } } } } } } }, "/open-api/goods/qc-page": { "post": { "tags": [ "开放平台 / 商品质检接口" ], "summary": "按时间分页查询质检数据", "operationId": "qcPage", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OpenGoodsQcPageReqVO" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/CommonResultPageResultOpenGoodsQcInfoRespVO" } } } } } } }, "/open-api/goods/qc-images": { "post": { "tags": [ "开放平台 / 商品质检接口" ], "summary": "查询商品质检图片列表", "operationId": "qcImages", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OpenGoodsQcDetailReqVO" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/CommonResultListString" } } } } } } }, "/open-api/goods/qc-detail": { "post": { "tags": [ "开放平台 / 商品质检接口" ], "summary": "查询商品质检详情（含图片、尺寸、重量、体积、完成时间）", "operationId": "qcDetail", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OpenGoodsQcDetailReqVO" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/CommonResultOpenGoodsQcInfoRespVO" } } } } } } }, "/open-api/goods/detail": { "post": { "tags": [ "开放平台 / 商品接口" ], "summary": "查询商品详情信息", "operationId": "detail", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OpenGoodsDetailReqVO" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/CommonResultOpenGoodsDetailRespVO" } } } } } } } }, "components": { "schemas": { "SystemCommoditySaveReqVO": { "required": [ "id", "langType", "name", "uuid" ], "type": "object", "properties": { "id": { "type": "integer", "description": "编号", "format": "int64" }, "uuid": { "type": "integer", "description": "业务唯一id", "format": "int64" }, "name": { "type": "string", "description": "名称" }, "nameDescribe": { "type": "string", "description": "名称描述" }, "langType": { "type": "string", "description": "多语言" }, "price": { "type": "integer", "description": "价格", "format": "int32" }, "salePrice": { "type": "integer", "description": "销售价", "format": "int32" }, "discount": { "type": "number", "description": "折扣 0-1 最多两位小数" }, "type": { "type": "integer", "description": "服务类型[1:商品,2:包裹]", "format": "int32" }, "status": { "type": "boolean", "description": "状态" }, "targetType": { "type": "integer", "format": "int32" }, "length": { "type": "number" }, "width": { "type": "number" }, "height": { "type": "number" }, "weight": { "type": "string" }, "volume": { "type": "string" }, "required": { "type": "boolean", "description": "是否必选" }, "serviceDescribe": { "type": "string", "description": "增值服务描述" }, "picture": { "type": "string", "description": "增值服务图片URL" } }, "description": "管理后台 - 增值服务商品列表新增/修改 Request VO" }, "CommonResultBoolean": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "type": "boolean" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "SyncInternationalDataCommonReqVO": { "required": [ "targetLanguage" ], "type": "object", "properties": { "dataUuids": { "type": "array", "items": { "type": "string" } }, "sourceLanguage": { "type": "string" }, "targetLanguage": { "type": "string" } } }, "CommonResultSyncInternDataCommonRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/SyncInternDataCommonRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "SyncInternDataCommonRespVO": { "type": "object", "properties": { "successDataUuids": { "type": "array", "items": { "type": "string" } }, "exeInfo": { "type": "string" }, "clearTargetDataIds": { "type": "array", "items": { "type": "integer", "format": "int64" } }, "errorDesc": { "type": "string" } } }, "HotSaleCategorySaveReqVO": { "required": [ "localName", "name", "parentId", "sort", "status", "visibilityType" ], "type": "object", "properties": { "id": { "type": "integer", "description": "编号（更新时必填）", "format": "int64" }, "parentId": { "type": "integer", "description": "父级分类 ID：0 表示新增一级分类；非 0 表示在该一级分类下新增二级分类", "format": "int64" }, "localName": { "maxLength": 64, "minLength": 0, "type": "string", "description": "中文原名（运营录入；一级 → localThemeDimName，二级 → localCateName）" }, "name": { "maxLength": 64, "minLength": 0, "type": "string", "description": "英文名（App 端展示；一级 → themeDimName，二级 → cateName）" }, "iconUrl": { "maxLength": 255, "minLength": 0, "type": "string", "description": "图标 URL" }, "sort": { "type": "integer", "description": "同级排序值，数值越大越靠前", "format": "int32" }, "status": { "type": "integer", "description": "状态（CommonStatusEnum）：0=启用，1=禁用", "format": "int32" }, "visibilityType": { "type": "string", "description": "国家可见规则：ALL / WHITELIST / BLACKLIST" }, "visibleCountryCodes": { "type": "array", "description": "白/黑名单时生效的国家编码（ISO 3166-1 alpha-2 大写，如 [\"US\",\"CA\"]）；ALL 时可不传", "items": { "type": "string", "description": "白/黑名单时生效的国家编码（ISO 3166-1 alpha-2 大写，如 [\"US\",\"CA\"]）；ALL 时可不传" } }, "remark": { "maxLength": 255, "minLength": 0, "type": "string", "description": "备注" } }, "description": "管理后台 - 热销分类新增/修改 Request VO" }, "HotSaleCategoryUpdateSortReqVO": { "required": [ "items" ], "type": "object", "properties": { "items": { "type": "array", "description": "待更新的排序项", "items": { "$ref": "#/components/schemas/Item" } } }, "description": "管理后台 - 热销分类批量排序 Request VO" }, "Item": { "required": [ "id", "sort" ], "type": "object", "properties": { "id": { "type": "integer", "description": "分类编号", "format": "int64" }, "sort": { "type": "integer", "description": "排序值（越大越靠前）", "format": "int32" } }, "description": "待更新的排序项" }, "HotSaleCategoryGoodsSaveReqVO": { "required": [ "categoryId", "goodsId", "goodsSource", "goodsTag", "sort", "status", "visibilityType" ], "type": "object", "properties": { "id": { "type": "integer", "description": "编号（更新时必填）", "format": "int64" }, "categoryId": { "type": "integer", "description": "所属二级分类 ID（必须 level=2，Service 强校验）", "format": "int64" }, "businessType": { "type": "string", "description": "业务类型：NORMAL=正常销售（默认）/ POINT_EXCHANGE=积分兑换（预留）" }, "goodsTag": { "type": "string", "description": "货物标签：GENERAL=普货 / SENSITIVE=敏感货" }, "goodsId": { "maxLength": 64, "minLength": 0, "type": "string", "description": "平台商品 ID" }, "goodsSource": { "type": "integer", "description": "商品来源（GoodsSource）：1=淘宝, 2=阿里巴巴, 3=微店", "format": "int32" }, "goodsTitle": { "type": "string", "description": "翻译后标题" }, "localGoodsTitle": { "type": "string", "description": "原始中文标题" }, "goodsPicUrl": { "type": "string", "description": "商品主图" }, "goodsDetailUrl": { "type": "string", "description": "商品平台详情页 URL" }, "priceInCents": { "type": "integer", "description": "价格（分）", "format": "int64" }, "salesCount": { "type": "string", "description": "销量文本" }, "sort": { "type": "integer", "description": "分类内排序值，数值越大越靠前", "format": "int32" }, "status": { "type": "string", "description": "上下架状态：ON_SHELF=上架 / OFF_SHELF=下架" }, "visibilityType": { "type": "string", "description": "国家可见规则：ALL / WHITELIST / BLACKLIST" }, "visibleCountryCodes": { "type": "array", "description": "白/黑名单时生效的国家编码（ISO 3166-1 alpha-2 大写）；ALL 时可不传", "items": { "type": "string", "description": "白/黑名单时生效的国家编码（ISO 3166-1 alpha-2 大写）；ALL 时可不传" } }, "importSourceUrl": { "type": "string", "description": "运营录入的原始链接（便于追溯）" }, "remark": { "maxLength": 255, "minLength": 0, "type": "string", "description": "备注" } }, "description": "管理后台 - 热销商品手动新增/更新 Request VO" }, "HotSaleCategoryGoodsUpdateSortReqVO": { "required": [ "items" ], "type": "object", "properties": { "items": { "type": "array", "description": "待更新的排序项", "items": { "$ref": "#/components/schemas/Item" } } }, "description": "管理后台 - 热销商品批量排序 Request VO" }, "HotSaleCategoryGoodsBatchUpdateVisibilityReqVO": { "required": [ "ids", "visibilityType" ], "type": "object", "properties": { "ids": { "type": "array", "description": "待更新的商品 id 列表", "items": { "type": "integer", "description": "待更新的商品 id 列表", "format": "int64" } }, "visibilityType": { "type": "string", "description": "国家可见规则：ALL / WHITELIST / BLACKLIST" }, "visibleCountryCodes": { "type": "array", "description": "白/黑名单时生效的国家编码；ALL 时可不传", "items": { "type": "string", "description": "白/黑名单时生效的国家编码；ALL 时可不传" } } }, "description": "管理后台 - 热销商品批量更新可见国家规则 Request VO" }, "HotSaleCategoryGoodsBatchMoveReqVO": { "required": [ "ids", "targetCategoryId" ], "type": "object", "properties": { "ids": { "type": "array", "description": "待移动的商品 id 列表", "items": { "type": "integer", "description": "待移动的商品 id 列表", "format": "int64" } }, "targetCategoryId": { "type": "integer", "description": "目标二级分类 ID（必须 level=2）", "format": "int64" } }, "description": "管理后台 - 热销商品批量移动分类 Request VO" }, "GoodsDetailRiskConfigSaveReqVO": { "required": [ "configType", "configValue", "status" ], "type": "object", "properties": { "id": { "type": "integer", "description": "编号", "format": "int64" }, "configType": { "type": "string", "description": "配置类型" }, "configValue": { "type": "string", "description": "配置值" }, "status": { "type": "integer", "description": "状态：0-禁用，1-启用", "format": "int32" }, "remark": { "type": "string", "description": "备注" } }, "description": "管理后台 - 商品详情风控配置新增/修改 Request VO" }, "CommodityTemplateSaveReqVO": { "required": [ "commodityId", "id", "language", "status", "templateDesc", "templateType" ], "type": "object", "properties": { "id": { "type": "integer", "description": "编号", "format": "int64" }, "uuidCode": { "type": "string", "description": "业务唯一id", "nullable": true }, "templateType": { "type": "integer", "description": "模板类型", "format": "int32" }, "templateDesc": { "type": "string", "description": "模版名称" }, "commodityId": { "type": "string", "description": "服务商品列表" }, "scene": { "type": "integer", "description": "适用场景", "format": "int32" }, "language": { "type": "string", "description": "语言" }, "status": { "type": "integer", "description": "状态", "format": "int32" } }, "description": "管理后台 - 增值服务商品组合模版新增/修改 Request VO" }, "CommonResult": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "type": "object" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "CommodityTemplateRespDTO": { "type": "object", "properties": { "templateType": { "type": "integer", "description": "模板类型", "format": "int32" }, "templateDesc": { "type": "string", "description": "模版名称" }, "commodityId": { "type": "string", "description": "服务商品列表" }, "commodityIdList": { "type": "array", "description": "服务商品列表", "items": { "type": "integer", "description": "服务商品列表", "format": "int32" } }, "systemCommodityRespDTOList": { "type": "array", "description": "适用服务商品列表", "items": { "$ref": "#/components/schemas/SystemCommodityRespDTO" } }, "scene": { "type": "integer", "description": "适用场景", "format": "int32" }, "type": { "type": "integer", "description": "模版选择类型:1单选框,2:复选框", "format": "int32" }, "createTime": { "type": "array", "description": "创建时间", "items": { "type": "string", "description": "创建时间", "format": "date-time" } } }, "description": "RPC 服务 - 增值服务商品组合模版 Response VO" }, "CommonResultListCommodityTemplateRespDTO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/CommodityTemplateRespDTO" } }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "SystemCommodityDescribeRespDTO": { "type": "object", "properties": { "describe": { "type": "string", "description": "描述" }, "path": { "type": "string", "description": "图片路径" } }, "description": "RPC 服务 - 增值服务商品描述 Response VO" }, "SystemCommodityRespDTO": { "required": [ "id", "langType", "name", "uuid" ], "type": "object", "properties": { "id": { "type": "integer", "description": "编号", "format": "int64" }, "uuid": { "type": "integer", "description": "业务唯一id", "format": "int32" }, "name": { "type": "string", "description": "名称" }, "nameDescribe": { "type": "string", "description": "名称描述" }, "attachDescribe": { "$ref": "#/components/schemas/SystemCommodityDescribeRespDTO" }, "langType": { "type": "string", "description": "多语言" }, "price": { "type": "integer", "description": "价格", "format": "int32" }, "salePrice": { "type": "integer", "description": "销售价格", "format": "int32" }, "orgPrice": { "type": "integer", "description": "原价价格", "format": "int32" }, "discount": { "type": "number", "description": "折扣" }, "targetType": { "type": "integer", "description": "targetType", "format": "int32" }, "length": { "type": "number", "description": "长" }, "width": { "type": "number", "description": "宽" }, "height": { "type": "number", "description": "高" }, "weight": { "type": "string", "description": "重量[服务完成后发生的重量变化]" }, "volume": { "type": "string", "description": "体积[服务完成后发生的体积变化]" }, "required": { "type": "boolean", "description": "必选项" }, "selected": { "type": "boolean", "description": "是否勾选" }, "serviceDescribe": { "type": "string", "description": "增值服务描述" }, "picture": { "type": "string", "description": "增值服务图片URL" }, "status": { "type": "boolean", "description": "状态" } }, "description": "RPC 服务 - 增值服务商品列表 Response VO" }, "CommonResultListSystemCommodityRespDTO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/SystemCommodityRespDTO" } }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "ShopCategoryItemReqDTO": { "required": [ "cateId", "pageNo", "pageSize", "shopId", "source" ], "type": "object", "properties": { "pageNo": { "minimum": 1, "type": "integer", "description": "页码，从 1 开始", "format": "int32", "example": 1 }, "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "description": "每页条数，最大值为 100", "format": "int32", "example": 10 }, "shopId": { "type": "string", "description": "店铺ID", "example": "1850717273" }, "source": { "type": "integer", "description": "商品来源", "format": "int32", "example": 3 }, "cateId": { "type": "string", "description": "分类ID", "example": "11" } }, "description": "店铺分类商品查询请求 DTO" }, "CommonResultShopCategoryItemRespDTO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/ShopCategoryItemRespDTO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "ShopCategoryItemRespDTO": { "type": "object", "properties": { "list": { "type": "array", "description": "商品列表", "items": { "$ref": "#/components/schemas/ShopGoodsInfoDTO" } }, "total": { "type": "integer", "description": "总数量", "format": "int32", "example": 100 } }, "description": "店铺分类商品查询响应 DTO" }, "ShopGoodsInfoDTO": { "type": "object", "properties": { "goodsId": { "type": "string", "description": "商品ID", "example": "123456" }, "goodsTitle": { "type": "string", "description": "商品标题", "example": "测试商品" }, "localGoodsTitle": { "type": "string", "description": "本地化商品标题", "example": "Test Product" }, "goodsDetailUrl": { "type": "string", "description": "商品详情链接", "example": "https://example.com/goods/123456" }, "goodsPicUrl": { "type": "string", "description": "商品图片链接", "example": "https://example.com/image.jpg" }, "goodsSource": { "type": "integer", "description": "商品来源", "format": "int32", "example": 3 }, "price": { "type": "number", "description": "商品价格（元）", "example": 99.99 }, "priceInCents": { "type": "integer", "description": "商品价格（分）", "format": "int64", "example": 9999 }, "originPriceInCents": { "type": "integer", "description": "原价（分）", "format": "int64", "example": 12999 }, "salesCount": { "type": "integer", "description": "销量", "format": "int32", "example": 100 }, "gooodsCollectStatus": { "type": "boolean", "description": "商品收藏状态", "example": false }, "goodsShareOriginUrl": { "type": "string", "description": "商品分享原始链接", "example": "https://example.com/share/123456" }, "discountPriceInCents": { "type": "integer", "description": "折扣价格（分）", "format": "int64", "example": 8999 }, "hasDiscount": { "type": "boolean", "description": "是否有折扣", "example": true }, "discountInfo": { "type": "string", "description": "折扣信息", "example": "限时优惠" } }, "description": "店铺商品信息 DTO" }, "OpenGoodsSearchUrlParseReqVO": { "required": [ "searchUrl" ], "type": "object", "properties": { "searchUrl": { "type": "string", "description": "待解析的商品链接（支持短链/长链及常见代购站链接）" }, "rno": { "type": "string", "description": "推广码（可选，非空时拼接到 targetGoodsDetailUrl）" } }, "description": "开放平台 - 商品链接解析 Request VO" }, "CommonResultOpenGoodsSearchUrlParseRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/OpenGoodsSearchUrlParseRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "OpenGoodsSearchUrlParseRespVO": { "required": [ "goodsId", "goodsSource", "success" ], "type": "object", "properties": { "goodsId": { "type": "string", "description": "商品ID" }, "goodsSource": { "type": "integer", "description": "商品来源:1-淘宝,2-阿里巴巴,3-微店,4-其它", "format": "int32" }, "goodsSourceName": { "type": "string", "description": "商品来源名称:taobao-淘宝,alibaba-阿里巴巴,weidian-微店" }, "goodsDetailUrl": { "type": "string", "description": "原平台商品详情页地址" }, "targetGoodsDetailUrl": { "type": "string", "description": "站内分享链接（rno 非空时含推广码）" }, "success": { "type": "boolean", "description": "是否解析成功" }, "searchUrl": { "type": "string", "description": "清洗后的输入链接" } }, "description": "开放平台 - 商品链接解析 Response VO" }, "OpenGoodsSearchByImagesReqVO": { "required": [ "imagesUrl", "page", "source" ], "type": "object", "properties": { "imagesUrl": { "type": "string", "description": "图片URL（需为可公网访问的图片地址）" }, "page": { "type": "integer", "description": "当前页（从1开始）", "format": "int32" }, "source": { "type": "integer", "description": "商品来源:1-淘宝,2-1688,3-微店", "format": "int32" } }, "description": "开放平台 - 图片识别搜索商品 Request VO" }, "CommonResultOpenGoodsSearchRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/OpenGoodsSearchRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "OpenGoodsSearchInfoRespVO": { "required": [ "goodsId" ], "type": "object", "properties": { "goodsId": { "type": "string", "description": "商品ID" }, "goodsTitle": { "type": "string", "description": "商品标题" }, "goodsDetailUrl": { "type": "string", "description": "商品地址" }, "goodsPicUrl": { "type": "string", "description": "商品主图" }, "goodsSource": { "type": "integer", "description": "商品来源:1-淘宝,2-1688,3-微店", "format": "int32" }, "price": { "type": "string", "description": "商品价格（元）" }, "priceInCents": { "type": "integer", "description": "商品价格（分）", "format": "int64" }, "originPriceInCents": { "type": "integer", "description": "商品原价/划线价（分）", "format": "int64" }, "salesCount": { "type": "string", "description": "商品销售数量" }, "hasDiscount": { "type": "boolean", "description": "是否享受优惠活动" }, "discountPriceInCents": { "type": "integer", "description": "优惠后价格（分）", "format": "int64" } }, "description": "开放平台 - 图片识别搜索商品信息 Response VO" }, "OpenGoodsSearchRespVO": { "required": [ "goodsList", "page", "size", "totalCount", "totalPage" ], "type": "object", "properties": { "goodsList": { "type": "array", "description": "商品列表结果", "items": { "$ref": "#/components/schemas/OpenGoodsSearchInfoRespVO" } }, "page": { "type": "integer", "description": "当前页", "format": "int32" }, "size": { "type": "integer", "description": "页大小", "format": "int32" }, "totalPage": { "type": "integer", "description": "总页数", "format": "int32" }, "totalCount": { "type": "integer", "description": "总条数", "format": "int32" } }, "description": "开放平台 - 图片识别搜索商品列表 Response VO" }, "OpenGoodsQcPageReqVO": { "required": [ "pageNo", "pageSize" ], "type": "object", "properties": { "pageNo": { "minimum": 1, "type": "integer", "description": "页码，从 1 开始", "format": "int32", "example": 1 }, "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "description": "每页条数，最大值为 100", "format": "int32", "example": 10 }, "goodsId": { "type": "string", "description": "商品ID", "example": "123456" }, "source": { "type": "integer", "description": "商品来源:1-淘宝,2-1688,3-微店", "format": "int32", "example": 1 }, "createTime": { "type": "array", "description": "创建时间区间 [开始, 结束]", "items": { "type": "string", "description": "创建时间区间 [开始, 结束]", "format": "date-time" } }, "completionTime": { "type": "array", "description": "质检完成时间区间 [开始, 结束]", "items": { "type": "string", "description": "质检完成时间区间 [开始, 结束]", "format": "date-time" } } }, "description": "开放平台 - 质检数据分页查询 Request VO" }, "CommonResultPageResultOpenGoodsQcInfoRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultOpenGoodsQcInfoRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "OpenGoodsQcInfoRespVO": { "type": "object", "properties": { "goodsId": { "type": "string", "description": "商品ID" }, "qcPathList": { "type": "array", "description": "质检照片列表", "items": { "type": "string", "description": "质检照片列表" } }, "length": { "type": "string", "description": "长(cm)" }, "width": { "type": "string", "description": "宽(cm)" }, "height": { "type": "string", "description": "高(cm)" }, "weight": { "type": "string", "description": "重量(g)" }, "volume": { "type": "string", "description": "体积(cm³)" }, "completionTime": { "type": "string", "description": "质检完成时间", "format": "date-time" } }, "description": "开放平台 - 商品质检信息 Response VO" }, "PageResultOpenGoodsQcInfoRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/OpenGoodsQcInfoRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "OpenGoodsQcDetailReqVO": { "required": [ "goodsId", "source" ], "type": "object", "properties": { "goodsId": { "pattern": "^(?!0$).*", "type": "string", "description": "商品ID", "example": "123456" }, "source": { "type": "integer", "description": "商品来源:1-淘宝,2-1688,3-微店", "format": "int32", "example": 1 } }, "description": "开放平台 - 查询商品质检信息 Request VO" }, "CommonResultListString": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "type": "array", "items": { "type": "string" } }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "CommonResultOpenGoodsQcInfoRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/OpenGoodsQcInfoRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "OpenGoodsDetailReqVO": { "required": [ "goodsId", "source" ], "type": "object", "properties": { "goodsId": { "pattern": "^(?!0$).*", "type": "string", "description": "商品ID" }, "source": { "type": "integer", "description": "商品来源:1-淘宝,2-1688,3-微店", "format": "int32" } }, "description": "开放平台 - 查询商品详情 Request VO" }, "CommonResultOpenGoodsDetailRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/OpenGoodsDetailRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "OpenGoodsDetailRespVO": { "required": [ "goodsId", "goodsTitle" ], "type": "object", "properties": { "goodsId": { "type": "string", "description": "商品ID" }, "goodsTitle": { "type": "string", "description": "商品标题" }, "goodsDetailUrl": { "type": "string", "description": "商品地址" }, "goodsPicUrl": { "type": "string", "description": "商品主图" }, "price": { "type": "string", "description": "商品价格（元）" }, "priceInCents": { "type": "integer", "description": "商品价格（分）", "format": "int64" }, "orginalPrice": { "type": "string", "description": "商品原价（元）" }, "stockNum": { "type": "string", "description": "商品库存" }, "salesCount": { "type": "string", "description": "商品销售数量" }, "goodsImageUrlList": { "type": "array", "description": "商品图片列表集合", "items": { "type": "string", "description": "商品图片列表集合" } }, "postFee": { "type": "string", "description": "商品运费（元）" }, "goodsSource": { "type": "integer", "description": "商品来源:1-淘宝,2-阿里巴巴,3-微店", "format": "int32" } }, "description": "开放平台 - 商品详情 Response VO" }, "AppShopInfoReqVO": { "required": [ "shopId", "source" ], "type": "object", "properties": { "shopId": { "type": "string", "description": "店铺ID" }, "source": { "type": "integer", "description": "商品来源:1-淘宝,2-1688,3-微店", "format": "int32" } }, "description": "用户 App - 查询店铺信息 Request VO" }, "AppShopInfoRespVO": { "type": "object", "properties": { "shopId": { "type": "string", "description": "店铺ID" }, "shopName": { "type": "string", "description": "店铺名称" }, "shopLogo": { "type": "string", "description": "店铺Logo" }, "note": { "type": "string", "description": "店铺描述" }, "qrcode": { "type": "string", "description": "店铺二维码" }, "shopUrl": { "type": "string", "description": "店铺链接" }, "bannerUrlList": { "type": "array", "description": "店铺轮播图列表", "items": { "type": "string", "description": "店铺轮播图列表" } }, "weixin": { "type": "string", "description": "微信号" }, "shopType": { "type": "integer", "description": "店铺类型", "format": "int32" }, "status": { "type": "integer", "description": "店铺状态", "format": "int32" }, "source": { "type": "integer", "description": "商品来源", "format": "int32" }, "weidianUrl": { "type": "string", "description": "微店链接" } }, "description": "用户 App - 店铺信息 Response VO" }, "CommonResultAppShopInfoRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/AppShopInfoRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "AppShopCategoryReqVO": { "required": [ "shopId", "source" ], "type": "object", "properties": { "shopId": { "type": "string", "description": "店铺ID" }, "source": { "type": "integer", "description": "商品来源:1-淘宝,2-1688,3-微店", "format": "int32" } }, "description": "用户 App - 查询店铺商品分类 Request VO" }, "AppShopCategoryRespVO": { "type": "object", "properties": { "cateList": { "type": "array", "description": "分类列表", "items": { "$ref": "#/components/schemas/CategoryInfo" } } }, "description": "用户 App - 店铺商品分类 Response VO" }, "CategoryInfo": { "type": "object", "properties": { "cateId": { "type": "integer", "description": "分类ID", "format": "int64" }, "cateName": { "type": "string", "description": "分类名称" }, "localCateName": { "type": "string", "description": "本地分类名称(原始名称)" }, "childCateList": { "type": "array", "description": "子分类列表", "items": { "$ref": "#/components/schemas/CategoryInfo" } }, "parentCateId": { "type": "integer", "description": "父分类ID", "format": "int64" }, "speCateItemNum": { "type": "integer", "description": "特定分类商品数量", "format": "int32" } }, "description": "分类信息" }, "CommonResultAppShopCategoryRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/AppShopCategoryRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "AppShopCategoryItemReqVO": { "required": [ "cateId", "keyword", "pageNo", "pageSize", "shopId", "source" ], "type": "object", "properties": { "pageNo": { "minimum": 1, "type": "integer", "description": "页码，从 1 开始", "format": "int32", "example": 1 }, "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "description": "每页条数，最大值为 100", "format": "int32", "example": 10 }, "shopId": { "type": "string", "description": "店铺ID", "example": "1850717273" }, "source": { "type": "integer", "description": "商品来源", "format": "int32", "example": 3 }, "cateId": { "type": "string", "description": "分类ID", "example": "151130731" }, "keyword": { "type": "string", "description": "关键字", "example": "151130731" }, "sortField": { "type": "string", "description": "排序字段", "example": "全部/默认-all，销量-sold，价格-price" }, "sortType": { "type": "string", "description": "排序类型", "example": "倒序-desc，升序-asc" } }, "description": "用户 App - 查询店铺分类商品 Request VO" }, "AppShopCategoryItemRespVO": { "type": "object", "properties": { "list": { "type": "array", "description": "商品列表", "items": { "$ref": "#/components/schemas/CrawlerSearchGoodsInfoRespDTO" } }, "total": { "type": "integer", "description": "总数量", "format": "int64" } }, "description": "用户 App - 店铺分类商品 Response VO" }, "CommonResultAppShopCategoryItemRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/AppShopCategoryItemRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "CrawlerSearchGoodsInfoRespDTO": { "required": [ "discountPriceInCents", "goodsDetailUrl", "goodsId", "goodsPicUrl", "goodsSource", "goodsTitle", "gooodsCollectStatus", "localGoodsTitle", "originPriceInCents", "price", "priceInCents", "salesCount" ], "type": "object", "properties": { "goodsId": { "type": "string", "description": "商品ID" }, "goodsTitle": { "type": "string", "description": "商品标题" }, "localGoodsTitle": { "type": "string", "description": "商品标题" }, "goodsDetailUrl": { "type": "string", "description": "商品地址" }, "goodsPicUrl": { "type": "string", "description": "商品主图" }, "goodsSource": { "type": "integer", "description": "商品来源:1-淘宝,2-阿里巴巴,3-微店", "format": "int32" }, "goodsTag": { "type": "string", "description": "货物标签：GENERAL=普货 / SENSITIVE=敏感货" }, "price": { "type": "string", "description": "商品价格（元）" }, "priceInCents": { "type": "integer", "description": "商品SKU 价格（分）", "format": "int64" }, "originPriceInCents": { "type": "integer", "description": "商品SKU 原价/划线价（分）", "format": "int64" }, "salesCount": { "type": "string", "description": "商品销售数量" }, "gooodsCollectStatus": { "type": "boolean", "description": "商品收藏状态" }, "goodsShareOriginUrl": { "type": "string", "description": "商品分享链接", "nullable": true }, "discountPriceInCents": { "type": "integer", "description": "商品优惠后价格（单位：分）", "format": "int64" }, "hasDiscount": { "type": "boolean", "description": "商品SKU 是否享受优惠活动" }, "discountInfo": { "$ref": "#/components/schemas/GoodsDiscountInfoRespDTO" } }, "description": "RPC 服务 - 爬虫搜索商品信息 Response DTO" }, "GoodsDiscountInfoRespDTO": { "required": [ "discountPercentage", "discountRate", "discountType", "totalDiscountAmount" ], "type": "object", "properties": { "discountRate": { "type": "integer", "description": "折扣比例（例如：90 表示 9 折）", "format": "int32" }, "discountType": { "type": "integer", "description": "折扣类型: 1-折扣", "format": "int32" }, "discountPercentage": { "type": "integer", "description": "优惠比例百分比（例如：10 表示优惠了 10%）", "format": "int32" }, "platformDiscountPercentage": { "type": "integer", "description": "平台折扣优惠百分比（例如：10 表示平台优惠了 10%）", "format": "int32", "example": 10 }, "goodsDiscountPercentage": { "type": "integer", "description": "商品折扣优惠百分比（例如：20 表示商品优惠了 20%）", "format": "int32", "example": 20 }, "platformActualDiscountAmount": { "type": "integer", "description": "平台折扣实际优惠金额（单位：分）", "format": "int64", "example": 1000 }, "goodsActualDiscountAmount": { "type": "integer", "description": "商品折扣实际优惠金额（单位：分）", "format": "int64", "example": 1800 }, "totalDiscountAmount": { "type": "integer", "description": "总优惠金额（单位：分）", "format": "int64", "example": 2800 }, "activityType": { "type": "string", "description": "活动类型编码：PLATFORM_DISCOUNT-平台折扣活动，MERCHANT_DISCOUNT-商家折扣活动，NEW_USER_DISCOUNT-新用户折扣活动" } }, "description": "商品优惠折扣信息" }, "AppGoodsSearchReqVO": { "required": [ "keyword", "page", "source" ], "type": "object", "properties": { "keyword": { "type": "string", "description": "搜索关键字" }, "page": { "type": "integer", "description": "当前页", "format": "int32" }, "source": { "type": "integer", "description": "商品来源:1-淘宝,2-1688,3-微店", "format": "int32" }, "sort": { "type": "string", "description": "商品排序:(默认-default或空,价格倒序:price-desc,价格升序:price-asc,销量倒序:sale-desc,销量升序:sale-asc)" }, "lowPrice": { "type": "string", "description": "价格区间:大于xxx价格(最低价格)" }, "highPrice": { "type": "string", "description": "价格区间:小于xxx价格(最高价格)" }, "searchScene": { "type": "integer", "description": "搜索场景:1-首页,2-推广联盟", "format": "int32" } }, "description": "用户 App - 搜索商品列表 Request VO" }, "CommonResultCrawlerSearchGoodsListRespDTO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/CrawlerSearchGoodsListRespDTO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "CrawlerSearchGoodsListRespDTO": { "required": [ "list", "page", "size", "total", "totalPage" ], "type": "object", "properties": { "page": { "type": "integer", "description": "当前页", "format": "int32" }, "size": { "type": "integer", "description": "页大小", "format": "int32" }, "totalPage": { "type": "integer", "description": "总页数", "format": "int32" }, "list": { "type": "array", "description": "商品列表结果", "items": { "$ref": "#/components/schemas/CrawlerSearchGoodsInfoRespDTO" } }, "total": { "type": "integer", "description": "总条数", "format": "int32" } }, "description": "RPC 服务 - 爬虫商品搜索信息 Response DTO" }, "AppGoodsSearchUrlParseReqVO": { "required": [ "searchUrl" ], "type": "object", "properties": { "searchUrl": { "type": "string", "description": "搜索关键字" }, "rno": { "type": "string", "description": "推广码（可选，非空时拼接到 targetGoodsDetailUrl）" } }, "description": "用户 App - 商品搜索URL解析 Request VO" }, "AppGoodsSearchUrlParseRespVO": { "required": [ "goodsDetailUrl", "goodsId", "goodsSource", "goodsSourceName", "searchUrl", "success", "targetGoodsDetailUrl" ], "type": "object", "properties": { "targetGoodsDetailUrl": { "type": "string", "description": "目标商品链接" }, "goodsDetailUrl": { "type": "string", "description": "商品地址" }, "goodsId": { "type": "string", "description": "商品ID" }, "goodsSource": { "type": "integer", "description": "商品来源:1-淘宝,2-阿里巴巴,3-微店", "format": "int32" }, "goodsSourceName": { "type": "string", "description": "商品来源名称:taobao-淘宝,alibaba-阿里巴巴,weidian-微店" }, "success": { "type": "boolean", "description": "是否解析成功" }, "searchUrl": { "type": "string", "description": "搜索URL" }, "rno": { "type": "string", "description": "推广码（可选，非空时拼接到 targetGoodsDetailUrl）" } }, "description": "用户 APP - 商品搜索URL解析 Response VO" }, "CommonResultAppGoodsSearchUrlParseRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/AppGoodsSearchUrlParseRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "AppGoodsSearchByImagesUrlReqVO": { "required": [ "imagesUrl", "page", "source" ], "type": "object", "properties": { "imagesUrl": { "type": "string", "description": "搜索关键字" }, "page": { "type": "integer", "description": "当前页", "format": "int32" }, "source": { "type": "integer", "description": "商品来源:1-淘宝,2-1688,3-微店", "format": "int32" }, "searchScene": { "type": "integer", "description": "搜索场景:1-首页,2-推广联盟", "format": "int32" } }, "description": "用户 App - 搜索商品列表 Request VO" }, "AppGoodsQcImagesReqVO": { "required": [ "goodsId", "source" ], "type": "object", "properties": { "goodsId": { "type": "string", "description": "商品ID" }, "source": { "type": "integer", "description": "商品来源:1-淘宝,2-1688,3-微店", "format": "int32" }, "rno": { "type": "string", "description": "请求标识" } }, "description": "用户 App - 查询商品质检照片 Request VO" }, "AppGoodsQcInfoRespVO": { "type": "object", "properties": { "goodsId": { "type": "string", "description": "商品ID" }, "qcPathList": { "type": "array", "description": "质检照片列表", "items": { "type": "string", "description": "质检照片列表" } }, "length": { "type": "string", "description": "长(cm)" }, "width": { "type": "string", "description": "宽(cm)" }, "height": { "type": "string", "description": "高(cm)" }, "weight": { "type": "string", "description": "重量(g)" }, "volume": { "type": "string", "description": "体积(cm³)" }, "completionTime": { "type": "string", "description": "质检完成时间", "format": "date-time" }, "inspectBy": { "type": "integer", "description": "质检员ID", "format": "int64" }, "inspectName": { "type": "string", "description": "质检员名称" }, "qcPhotosBy": { "type": "integer", "description": "质检拍照员ID", "format": "int64" }, "qcPhotographerName": { "type": "string", "description": "质检拍照员名称" } }, "description": "用户 App - 商品质检信息 Response VO" }, "CommonResultAppGoodsQcInfoRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/AppGoodsQcInfoRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "AppThemeDimListReqVO": { "type": "object", "properties": { "themeContentType": { "type": "string", "description": "主题内容类型（历史字段，当前版本不再区分）", "example": "11" }, "themeChannelType": { "type": "string", "description": "主题渠道类型（历史字段，当前版本未使用）", "example": "1" }, "page": { "type": "integer", "description": "页码，从 1 开始，默认 1", "format": "int32", "example": 1 }, "pageSize": { "type": "integer", "description": "每页条数，默认 20，最大 100", "format": "int32", "example": 20 } }, "description": "用户 App - 查询热销分类列表 Request VO" }, "CommonResultCrawlerThemeDimListRespDTO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/CrawlerThemeDimListRespDTO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "CrawlerThemeDimListRespDTO": { "required": [ "list", "page", "size", "total", "totalPage" ], "type": "object", "properties": { "page": { "type": "integer", "description": "当前页", "format": "int32" }, "size": { "type": "integer", "description": "页大小", "format": "int32" }, "totalPage": { "type": "integer", "description": "总页数", "format": "int32" }, "list": { "type": "array", "description": "分类维度列表", "items": { "$ref": "#/components/schemas/CrawlerThemeDimRespDTO" } }, "total": { "type": "integer", "description": "总条数", "format": "int32" } }, "description": "RPC 服务 - 热销分类列表 Response DTO" }, "CrawlerThemeDimRespDTO": { "type": "object", "properties": { "themeDimId": { "type": "string", "description": "一级分类 ID", "example": "1" }, "themeDimName": { "type": "string", "description": "一级分类展示名（多语言翻译后：中文→localName，英文→name，其他语言→谷歌翻译）", "example": "美妆" }, "localThemeDimName": { "type": "string", "description": "一级分类中文原名", "example": "美妆" }, "cateId": { "type": "string", "description": "二级分类 ID", "example": "11" }, "cateName": { "type": "string", "description": "二级分类展示名（多语言翻译后：中文→localName，英文→name，其他语言→谷歌翻译）", "example": "口红" }, "localCateName": { "type": "string", "description": "二级分类中文原名", "example": "口红" } }, "description": "RPC 服务 - 热销分类维度 Response DTO（每条记录代表一个二级分类及其所属一级分类）" }, "AppThemeDetailReqVO": { "type": "object", "properties": { "themeDimId": { "type": "string", "description": "一级分类 ID，来自分类列表接口返回的 themeDimId；不传则不按一级分类过滤", "example": "1" }, "cateId": { "type": "string", "description": "二级分类 ID，来自分类列表接口返回的 cateId；不传则查全部商品", "example": "11" }, "page": { "type": "integer", "description": "页码，从 1 开始，默认 1", "format": "int32", "example": 1 }, "pageSize": { "type": "integer", "description": "每页条数，默认 20，最大 100", "format": "int32", "example": 20 } }, "description": "用户 App - 查询热销分类商品列表 Request VO" }, "AppGoodsDetailReqVO": { "required": [ "goodsId", "source" ], "type": "object", "properties": { "goodsId": { "pattern": "^(?!0$).*", "type": "string", "description": "商品ID" }, "source": { "type": "integer", "description": "商品来源:1-淘宝,2-1688,3-微店", "format": "int32" }, "forceRefresh": { "type": "boolean", "description": "是否强制刷新:默认false", "example": false }, "rno": { "type": "string", "description": "请求标识" }, "pageUrl": { "type": "string", "description": "页面URL" } }, "description": "用户 App - 查询商品详情 Request VO" }, "CommonResultCrawlerGoodsInfoRespDTO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/CrawlerGoodsInfoRespDTO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "CrawlerGoodsInfoRespDTO": { "required": [ "goodsDescHtmlContent", "goodsDetailUrl", "goodsId", "goodsImageUrlList", "goodsPicUrl", "goodsSource", "goodsTitle", "gooodsCollectStatus", "localGoodsTitle", "orginalPrice", "orginalPriceInCents", "price", "priceInCents", "propList", "recommendWarehouseInfo", "salesCount", "shopInfo", "skuList", "skuSpecInfoList", "stockNum" ], "type": "object", "properties": { "goodsId": { "type": "string", "description": "商品ID" }, "goodsTitle": { "type": "string", "description": "商品标题" }, "localGoodsTitle": { "type": "string", "description": "商品标题(本地国内语言)" }, "goodsDetailUrl": { "type": "string", "description": "商品地址" }, "goodsPicUrl": { "type": "string", "description": "商品主图" }, "price": { "type": "string", "description": "商品价格（元）" }, "priceInCents": { "type": "integer", "description": "商品价格（分）", "format": "int64" }, "orginalPrice": { "type": "string", "description": "商品原价（元）" }, "orginalPriceInCents": { "type": "integer", "description": "商品原价（分）", "format": "int64" }, "stockNum": { "type": "string", "description": "商品库存" }, "cid": { "type": "string", "description": "商品所属分类ID" }, "salesCount": { "type": "string", "description": "商品销售数量" }, "goodsImageUrlList": { "type": "array", "description": "商品图片列表集合", "items": { "type": "string", "description": "商品图片列表集合" } }, "postFee": { "type": "string", "description": "商品运费(单位:元)" }, "postFeeInCents": { "type": "integer", "description": "商品运费(单位:分)", "format": "int64" }, "goodsDescHtmlContent": { "type": "string", "description": "商品详情描述HTML" }, "goodsSource": { "type": "integer", "description": "商品来源:1-淘宝,2-阿里巴巴,3-微店", "format": "int32" }, "shopInfo": { "$ref": "#/components/schemas/CrawlerGoodsShopInfoRespDTO" }, "skuList": { "type": "array", "description": "商品SKU列表", "items": { "$ref": "#/components/schemas/CrawlerGoodsSkuInfoRespDTO" } }, "propList": { "type": "object", "additionalProperties": { "type": "array", "description": "商品SKU规格", "items": { "$ref": "#/components/schemas/CrawlerGoodsSkuPropInfoRespDTO" } }, "description": "商品SKU规格" }, "skuSpecInfoList": { "type": "array", "description": "商品SKU规格列表", "items": { "$ref": "#/components/schemas/CrawlerGoodsSkuSpecInfoRespDTO" } }, "gooodsCollectStatus": { "type": "boolean", "description": "商品收藏状态" }, "recommendWarehouseInfo": { "$ref": "#/components/schemas/GoodsRecommendWarehouseInfoRespDTO" }, "goodsShareShortUrl": { "type": "string", "description": "商品分享短链", "nullable": true }, "goodsShareOriginUrl": { "type": "string", "description": "商品分享链接", "nullable": true }, "hitSensitiveWord": { "type": "boolean", "description": "是否命中敏感词", "nullable": true }, "riskControlReason": { "type": "string", "description": "风控原因代码", "nullable": true }, "hasDiscount": { "type": "boolean", "description": "商品SKU 是否享受优惠活动" } }, "description": "RPC 服务 - 爬虫商品信息 Response DTO" }, "CrawlerGoodsShopInfoRespDTO": { "required": [ "localSellerNickname", "localShopTitle", "sellerNickname", "shopTitle", "shopUrl" ], "type": "object", "properties": { "shopId": { "type": "string", "description": "店铺ID", "nullable": true }, "sellerId": { "type": "string", "description": "卖家ID", "nullable": true }, "shopTitle": { "type": "string", "description": "店铺名称" }, "localShopTitle": { "type": "string", "description": "店铺名称(本地国内语言)" }, "sellerNickname": { "type": "string", "description": "卖家昵称" }, "localSellerNickname": { "type": "string", "description": "卖家昵称(本地国内语言)" }, "shopUrl": { "type": "string", "description": "店铺地址" } }, "description": "RPC 服务 - 爬虫商品店铺信息 Response DTO" }, "CrawlerGoodsSkuInfoRespDTO": { "required": [ "discountPriceInCents", "imageUrl", "localPropertiesName", "price", "priceInCents", "propertiesId", "propertiesName", "quantity", "salePrice", "salePriceInCents", "skuId" ], "type": "object", "properties": { "skuId": { "type": "string", "description": "商品SKU ID" }, "specId": { "type": "string", "description": "1688特有规格ID" }, "price": { "type": "string", "description": "商品SKU 价格（元）" }, "priceInCents": { "type": "integer", "description": "商品SKU 价格（分）", "format": "int64" }, "salePrice": { "type": "string", "description": "商品SKU 售价（元）" }, "salePriceInCents": { "type": "integer", "description": "商品SKU 售价（分）", "format": "int64" }, "quantity": { "type": "integer", "description": "商品SKU 数量", "format": "int32" }, "imageUrl": { "type": "string", "description": "商品SKU 图片URL" }, "propertiesId": { "type": "string", "description": "商品SKU 规格ID" }, "propertiesName": { "type": "string", "description": "商品SKU 规格名称" }, "localPropertiesName": { "type": "string", "description": "商品SKU 规格名称(本地国内语言)" }, "discountPriceInCents": { "type": "integer", "description": "商品优惠后价格（单位：分）", "format": "int64" }, "hasDiscount": { "type": "boolean", "description": "商品SKU 是否享受优惠活动" }, "discountInfo": { "$ref": "#/components/schemas/GoodsDiscountInfoRespDTO" } }, "description": "RPC 服务 - 爬虫商品SKU信息 Response DTO" }, "CrawlerGoodsSkuPropInfoRespDTO": { "required": [ "attrValue", "key", "localAttrValue", "localPname", "localVname", "pid", "pname", "vid", "vname" ], "type": "object", "properties": { "key": { "type": "string", "description": "商品SKU 规格KEY" }, "pid": { "type": "string", "description": "商品SKU 规格1:ID" }, "vid": { "type": "string", "description": "商品SKU 规格2:ID" }, "pname": { "type": "string", "description": "商品SKU 规格1:名称" }, "vname": { "type": "string", "description": "商品SKU 规格2:名称" }, "localPname": { "type": "string", "description": "商品SKU 规格1:名称(国内本地语言)" }, "localVname": { "type": "string", "description": "商品SKU 规格2:名称(国内本地语言)" }, "icon": { "type": "string", "description": "商品SKU 规格icon" }, "attrValue": { "type": "string", "description": "商品SKU 规格拼接值" }, "localAttrValue": { "type": "string", "description": "商品SKU 规格拼接值(国内本地语言)" } }, "description": "RPC 服务 - 爬虫商品SKU规格信息 Response DTO" }, "CrawlerGoodsSkuSpecInfoRespDTO": { "required": [ "localSkuSpecName", "skuSpecList", "skuSpecName" ], "type": "object", "properties": { "skuSpecName": { "type": "string", "description": "商品规格列表名称" }, "localSkuSpecName": { "type": "string", "description": "商品规格列表名称(国内本地语言)" }, "skuSpecList": { "type": "array", "description": "商品规格列表名称", "items": { "$ref": "#/components/schemas/CrawlerGoodsSkuPropInfoRespDTO" } } }, "description": "RPC 服务 - 爬虫商品规格信息 Response DTO" }, "GoodsRecommendWarehouseInfoRespDTO": { "required": [ "id", "localWarehouseName", "warehouseAddress", "warehouseContacts", "warehouseName", "warehouseTel" ], "type": "object", "properties": { "id": { "type": "integer", "description": "编号", "format": "int64" }, "warehouseName": { "type": "string", "description": "仓库名称" }, "localWarehouseName": { "type": "string", "description": "仓库名称(本地语言)" }, "warehouseAddress": { "type": "string", "description": "仓库地址" }, "warehouseTel": { "type": "string", "description": "仓库联系电话" }, "warehouseContacts": { "type": "string", "description": "仓库联系人" } }, "description": "RPC 服务 - 商品推荐仓库信息 Response DTO" }, "CommonResultLong": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "type": "integer", "format": "int64" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "HotSaleCategoryGoodsImportByUrlReqVO": { "required": [ "categoryId", "items", "visibilityType" ], "type": "object", "properties": { "categoryId": { "type": "integer", "description": "目标二级分类 ID（必须 level=2）", "format": "int64" }, "visibilityType": { "type": "string", "description": "国家可见规则：ALL / WHITELIST / BLACKLIST" }, "visibleCountryCodes": { "type": "array", "description": "白/黑名单时生效的国家编码；ALL 时可不传", "items": { "type": "string", "description": "白/黑名单时生效的国家编码；ALL 时可不传" } }, "sort": { "type": "integer", "description": "默认排序值（不传则按 0 落库，可在导入后批量改）", "format": "int32" }, "items": { "type": "array", "description": "导入项列表", "items": { "$ref": "#/components/schemas/Item" } }, "enableMultiThread": { "type": "boolean", "description": "是否多线程处理（默认 true）" }, "remark": { "maxLength": 255, "minLength": 0, "type": "string", "description": "备注（透传到每条记录）" } }, "description": "管理后台 - 热销商品 URL 批量导入 Request VO" }, "CommonResultHotSaleCategoryGoodsImportRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/HotSaleCategoryGoodsImportRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "Failure": { "type": "object", "properties": { "url": { "type": "string", "description": "失败的 URL" }, "errorMessage": { "type": "string", "description": "失败原因" } }, "description": "失败明细" }, "HotSaleCategoryGoodsImportRespVO": { "type": "object", "properties": { "totalCount": { "type": "integer", "description": "总数量", "format": "int32" }, "successCount": { "type": "integer", "description": "成功数量", "format": "int32" }, "failureCount": { "type": "integer", "description": "失败数量", "format": "int32" }, "successIds": { "type": "array", "description": "成功导入的商品 id 列表", "items": { "type": "integer", "description": "成功导入的商品 id 列表", "format": "int64" } }, "failures": { "type": "array", "description": "失败明细", "items": { "$ref": "#/components/schemas/Failure" } } }, "description": "管理后台 - 热销商品 URL 批量导入 Response VO" }, "HotSaleCategoryGoodsBatchCopyReqVO": { "required": [ "ids", "targetCategoryId" ], "type": "object", "properties": { "ids": { "type": "array", "description": "待关联的商品 id 列表", "items": { "type": "integer", "description": "待关联的商品 id 列表", "format": "int64" } }, "targetCategoryId": { "type": "integer", "description": "目标二级分类 ID（必须 level=2）", "format": "int64" } }, "description": "管理后台 - 热销商品批量关联新分类 Request VO" }, "AppGoodsSearchUrlParseRespDTO": { "required": [ "goodsDetailUrl", "goodsId", "goodsSource", "goodsSourceName", "searchUrl", "success", "targetGoodsDetailUrl" ], "type": "object", "properties": { "goodsDetailUrl": { "type": "string", "description": "源商品地址" }, "targetGoodsDetailUrl": { "type": "string", "description": "目标商品链接" }, "goodsId": { "type": "string", "description": "商品ID" }, "goodsSource": { "type": "integer", "description": "商品来源:1-淘宝,2-阿里巴巴,3-微店", "format": "int32" }, "goodsSourceName": { "type": "string", "description": "商品来源名称:taobao-淘宝,alibaba-阿里巴巴,weidian-微店" }, "success": { "type": "boolean", "description": "是否解析成功" }, "searchUrl": { "type": "string", "description": "搜索URL" } }, "description": "用户 APP - 商品搜索URL解析 Response DTO" }, "CommonResultAppGoodsSearchUrlParseRespDTO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/AppGoodsSearchUrlParseRespDTO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "CommonResultPromotionActivityGoodsByCategoryRespDTO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PromotionActivityGoodsByCategoryRespDTO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "GoodsDiscountInfoDTO": { "type": "object", "properties": { "discountRate": { "type": "integer", "description": "折扣比例（例如：90 表示 9 折）", "format": "int32" }, "discountType": { "type": "integer", "description": "折扣类型: 1-折扣", "format": "int32" }, "discountPercentage": { "type": "integer", "description": "优惠比例百分比（例如：10 表示优惠了 10%）", "format": "int32" }, "activityType": { "type": "string", "description": "活动类型编码：PLATFORM_DISCOUNT-平台折扣活动，MERCHANT_DISCOUNT-商家折扣活动，NEW_USER_DISCOUNT-新用户折扣活动" } }, "description": "商品优惠折扣信息" }, "PromotionActivityGoodsByCategoryRespDTO": { "type": "object", "properties": { "goodsList": { "type": "array", "description": "商品列表", "items": { "$ref": "#/components/schemas/PromotionActivityGoodsItemDTO" } } }, "description": "根据分类编码查询活动商品响应" }, "PromotionActivityGoodsItemDTO": { "type": "object", "properties": { "id": { "type": "integer", "description": "主键ID", "format": "int64", "example": 1024 }, "goodsId": { "type": "string", "description": "商品ID", "example": "18812" }, "goodsTitle": { "type": "string", "description": "商品标题" }, "localGoodsTitle": { "type": "string", "description": "本地商品名称" }, "goodsPrice": { "type": "string", "description": "商品价格（单位：分）", "example": "20440" }, "price": { "type": "string", "description": "商品价格（元）" }, "priceInCents": { "type": "integer", "description": "商品价格（分）", "format": "int64" }, "goodsSource": { "type": "integer", "description": "商品来源: 1-淘宝, 2-1688, 3-微店", "format": "int32" }, "goodsPicUrl": { "type": "string", "description": "商品主图" }, "goodsDetailUrl": { "type": "string", "description": "商品详情地址" }, "goodsCategoryCode": { "type": "string", "description": "商品活动分类编码" }, "merchantCode": { "type": "string", "description": "商品归属的商家编码" }, "sort": { "type": "integer", "description": "排序值，数值越大越靠前", "format": "int32" }, "goodsShareShortUrl": { "type": "string", "description": "商品分享短链" }, "goodsShareOriginUrl": { "type": "string", "description": "商品分享链接" }, "goodsCollectStatus": { "type": "boolean", "description": "商品收藏状态" }, "hasDiscount": { "type": "boolean", "description": "商品SKU 是否享受优惠活动" }, "discountPriceInCents": { "type": "integer", "description": "商品优惠后价格（单位：分）", "format": "int64" }, "discountInfo": { "$ref": "#/components/schemas/GoodsDiscountInfoDTO" } }, "description": "活动商品项信息" }, "CommonResultListGoodsSearchHotKeyRespDTO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/GoodsSearchHotKeyRespDTO" } }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "GoodsSearchHotKeyRespDTO": { "required": [ "action", "actionData", "displayKeyword", "keyword" ], "type": "object", "properties": { "keyword": { "type": "string", "description": "实际搜索的关键词" }, "displayKeyword": { "type": "string", "description": "展示给用户的关键词" }, "action": { "type": "integer", "description": "关键词类型:1-搜索关键词,2-点击跳转指定url", "format": "int32" }, "actionData": { "type": "string", "description": "关键词对应值（根据action类型，可能是搜索词或跳转URL等）" } }, "description": "RPC 服务 - 商品搜索关键字信息 Response DTO" }, "AppCommodityRespVO": { "required": [ "commodityId", "createTime", "id", "templateDesc", "templateType", "type" ], "type": "object", "properties": { "id": { "type": "integer", "description": "编号", "format": "int64" }, "templateType": { "type": "integer", "description": "模板类型", "format": "int32" }, "templateDesc": { "type": "string", "description": "模版名称" }, "commodityId": { "type": "string", "description": "服务商品列表" }, "commodityIdList": { "type": "array", "description": "服务商品列表", "items": { "type": "integer", "description": "服务商品列表", "format": "int32" } }, "type": { "type": "integer", "description": "是否组合选项[1:单选,2:组合]", "format": "int32" }, "systemCommodityRespVOList": { "type": "array", "description": "适用服务商品列表", "items": { "$ref": "#/components/schemas/AppSystemCommodityRespVO" } }, "scene": { "type": "string", "description": "适用场景" }, "createTime": { "type": "string", "description": "创建时间", "format": "date-time" } }, "description": "用户 APP - 增值服务商品模版列表 Response VO" }, "AppSystemCommodityRespVO": { "required": [ "createTime", "id", "langType", "name", "uuid" ], "type": "object", "properties": { "id": { "type": "integer", "description": "编号", "format": "int64" }, "uuid": { "type": "integer", "description": "业务唯一id", "format": "int32" }, "name": { "type": "string", "description": "名称" }, "nameDescribe": { "type": "string", "description": "名称描述" }, "attachDescribe": { "$ref": "#/components/schemas/SystemCommodityDescribeRespDTO" }, "langType": { "type": "string", "description": "多语言" }, "orgPrice": { "type": "integer", "description": "原价-分", "format": "int32" }, "salePrice": { "type": "integer", "description": "销售价-分", "format": "int32" }, "price": { "type": "integer", "description": "价格-分", "format": "int32" }, "discount": { "type": "number", "description": "折扣" }, "weight": { "type": "string", "description": "重量[服务完成后发生的重量变化]" }, "volume": { "type": "string", "description": "体积[服务完成后发生的体积变化]" }, "type": { "type": "integer", "description": "服务类型[1:商品,2:包裹]", "format": "int32" }, "status": { "type": "boolean", "description": "状态" }, "createTime": { "type": "string", "description": "创建时间", "format": "date-time" }, "serviceDescribe": { "type": "string", "description": "增值服务描述" }, "picture": { "type": "string", "description": "增值服务图片URL" } }, "description": "用户 APP - 增值服务商品列表 Response VO" }, "CommonResultListAppCommodityRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/AppCommodityRespVO" } }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "SystemCommodityPageReqVO": { "required": [ "pageNo", "pageSize" ], "type": "object", "properties": { "pageNo": { "minimum": 1, "type": "integer", "description": "页码，从 1 开始", "format": "int32", "example": 1 }, "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "description": "每页条数，最大值为 100", "format": "int32", "example": 10 }, "uuid": { "type": "integer", "description": "业务唯一id", "format": "int32" }, "name": { "type": "string", "description": "名称" }, "nameDescribe": { "type": "string", "description": "名称描述" }, "langType": { "type": "string", "description": "多语言" }, "price": { "type": "integer", "description": "价格", "format": "int32" }, "type": { "type": "integer", "description": "服务类型[1:商品,2:包裹]", "format": "int32" }, "status": { "type": "boolean", "description": "状态" }, "createTime": { "type": "array", "description": "创建时间", "items": { "type": "string", "description": "创建时间", "format": "date-time" } } }, "description": "管理后台 - 增值服务商品列表分页 Request VO" }, "CommonResultPageResultSystemCommodityRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultSystemCommodityRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PageResultSystemCommodityRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/SystemCommodityRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "SystemCommodityRespVO": { "required": [ "createTime", "height", "id", "langType", "length", "name", "targetType", "uuid", "width" ], "type": "object", "properties": { "id": { "type": "integer", "description": "编号", "format": "int64" }, "uuid": { "type": "integer", "description": "业务唯一id", "format": "int64" }, "name": { "type": "string", "description": "名称" }, "nameDescribe": { "type": "string", "description": "名称描述" }, "langType": { "type": "string", "description": "多语言" }, "price": { "type": "integer", "description": "价格", "format": "int32" }, "salePrice": { "type": "integer", "description": "销售价", "format": "int32" }, "discount": { "type": "number", "description": "折扣 0-1 最多两位小数" }, "weight": { "type": "string", "description": "重量[服务完成后发生的重量变化]" }, "volume": { "type": "string", "description": "体积[服务完成后发生的体积变化]" }, "type": { "type": "integer", "description": "服务类型[1:商品,2:包裹]", "format": "int32" }, "targetType": { "type": "integer", "description": "受众类型[0 无 1 外部包装箱 2 货品]", "format": "int32" }, "length": { "type": "number", "description": "长" }, "width": { "type": "number", "description": "宽" }, "height": { "type": "number", "description": "高" }, "status": { "type": "boolean", "description": "状态" }, "createTime": { "type": "string", "description": "创建时间", "format": "date-time" }, "required": { "type": "boolean", "description": "是否必选" }, "serviceDescribe": { "type": "string", "description": "增值服务描述" }, "picture": { "type": "string", "description": "增值服务图片URL" } }, "description": "管理后台 - 增值服务商品列表 Response VO" }, "CommonResultListSystemCommodityRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/SystemCommodityRespVO" } }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "CommonResultSystemCommodityRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/SystemCommodityRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "HotSaleCategoryPageReqVO": { "required": [ "pageNo", "pageSize" ], "type": "object", "properties": { "pageNo": { "minimum": 1, "type": "integer", "description": "页码，从 1 开始", "format": "int32", "example": 1 }, "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "description": "每页条数，最大值为 100", "format": "int32", "example": 10 }, "level": { "type": "integer", "description": "层级：1=一级，2=二级", "format": "int32" }, "parentId": { "type": "integer", "description": "父级分类 ID（0 表示一级分类的父）", "format": "int64" }, "status": { "type": "integer", "description": "状态（CommonStatusEnum）：0=启用，1=禁用", "format": "int32" }, "visibilityType": { "type": "string", "description": "国家可见规则：ALL / WHITELIST / BLACKLIST" }, "keyword": { "type": "string", "description": "关键字（同时匹配 name / localName）" } }, "description": "管理后台 - 热销分类分页 Request VO" }, "CommonResultPageResultHotSaleCategoryRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultHotSaleCategoryRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "HotSaleCategoryRespVO": { "type": "object", "properties": { "id": { "type": "integer", "description": "编号", "format": "int64" }, "parentId": { "type": "integer", "description": "父级分类 ID（0 表示一级）", "format": "int64" }, "level": { "type": "integer", "description": "层级：1=一级，2=二级", "format": "int32" }, "name": { "type": "string", "description": "展示名（翻译后）" }, "localName": { "type": "string", "description": "中文原名" }, "iconUrl": { "type": "string", "description": "图标 URL" }, "sort": { "type": "integer", "description": "排序值", "format": "int32" }, "status": { "type": "integer", "description": "状态：0=启用，1=禁用", "format": "int32" }, "visibilityType": { "type": "string", "description": "国家可见规则：ALL / WHITELIST / BLACKLIST" }, "visibleCountryCodes": { "type": "array", "description": "可见国家编码列表", "items": { "type": "string", "description": "可见国家编码列表" } }, "remark": { "type": "string", "description": "备注" }, "createTime": { "type": "string", "description": "创建时间", "format": "date-time" }, "updateTime": { "type": "string", "description": "更新时间", "format": "date-time" }, "children": { "type": "array", "description": "子分类列表（仅 list-tree 接口返回）", "items": { "$ref": "#/components/schemas/HotSaleCategoryRespVO" } } }, "description": "管理后台 - 热销分类 Response VO" }, "PageResultHotSaleCategoryRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/HotSaleCategoryRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "CommonResultListHotSaleCategoryRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/HotSaleCategoryRespVO" } }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "CommonResultListHotSaleCategoryLeafSimpleRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/HotSaleCategoryLeafSimpleRespVO" } }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "HotSaleCategoryLeafSimpleRespVO": { "type": "object", "properties": { "id": { "type": "integer", "description": "二级分类编号", "format": "int64" }, "localName": { "type": "string", "description": "二级分类中文名" }, "name": { "type": "string", "description": "二级分类展示名" }, "parentId": { "type": "integer", "description": "所属一级分类编号", "format": "int64" }, "parentLocalName": { "type": "string", "description": "所属一级分类中文名" }, "parentName": { "type": "string", "description": "所属一级分类展示名" }, "sort": { "type": "integer", "description": "排序值", "format": "int32" }, "status": { "type": "integer", "description": "状态：0=启用，1=禁用", "format": "int32" } }, "description": "管理后台 - 二级分类简略信息 Response VO" }, "CommonResultHotSaleCategoryRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/HotSaleCategoryRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "HotSaleCategoryGoodsPageReqVO": { "required": [ "pageNo", "pageSize" ], "type": "object", "properties": { "pageNo": { "minimum": 1, "type": "integer", "description": "页码，从 1 开始", "format": "int32", "example": 1 }, "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "description": "每页条数，最大值为 100", "format": "int32", "example": 10 }, "parentCategoryId": { "type": "integer", "description": "一级分类 ID（按一级反查其下全部商品）", "format": "int64" }, "categoryId": { "type": "integer", "description": "二级分类 ID", "format": "int64" }, "businessType": { "type": "string", "description": "业务类型：NORMAL / POINT_EXCHANGE" }, "goodsTag": { "type": "string", "description": "货物标签：GENERAL=普货 / SENSITIVE=敏感货" }, "status": { "type": "string", "description": "上下架状态：ON_SHELF / OFF_SHELF" }, "goodsSource": { "type": "integer", "description": "商品来源：1=淘宝, 2=阿里巴巴, 3=微店", "format": "int32" }, "visibilityType": { "type": "string", "description": "国家可见规则：ALL / WHITELIST / BLACKLIST" }, "keyword": { "type": "string", "description": "关键字（同时匹配 goodsTitle / localGoodsTitle / 精确匹配 goodsId）" }, "visibleInCountry": { "type": "string", "description": "按国家可见性过滤：传入国家编码（ISO 3166-1 alpha-2 大写），返回该国家可见的商品" } }, "description": "管理后台 - 热销商品分页 Request VO" }, "CommonResultPageResultHotSaleCategoryGoodsRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultHotSaleCategoryGoodsRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "HotSaleCategoryGoodsRespVO": { "type": "object", "properties": { "id": { "type": "integer", "description": "编号", "format": "int64" }, "categoryId": { "type": "integer", "description": "所属二级分类 ID", "format": "int64" }, "categoryLocalName": { "type": "string", "description": "所属二级分类中文名" }, "parentCategoryId": { "type": "integer", "description": "所属一级分类 ID", "format": "int64" }, "parentCategoryLocalName": { "type": "string", "description": "所属一级分类中文名" }, "businessType": { "type": "string", "description": "业务类型：NORMAL / POINT_EXCHANGE" }, "goodsTag": { "type": "string", "description": "货物标签：GENERAL=普货 / SENSITIVE=敏感货" }, "goodsId": { "type": "string", "description": "平台商品 ID" }, "goodsSource": { "type": "integer", "description": "商品来源：1=淘宝, 2=阿里巴巴, 3=微店", "format": "int32" }, "goodsTitle": { "type": "string", "description": "翻译后标题" }, "localGoodsTitle": { "type": "string", "description": "原始中文标题" }, "goodsPicUrl": { "type": "string", "description": "商品主图" }, "goodsDetailUrl": { "type": "string", "description": "商品平台详情页 URL" }, "priceInCents": { "type": "integer", "description": "价格（分）", "format": "int64" }, "salesCount": { "type": "string", "description": "销量文本" }, "sort": { "type": "integer", "description": "排序值", "format": "int32" }, "topped": { "type": "boolean", "description": "是否在该二级分类下已置顶（sort 为分类内最大值）" }, "status": { "type": "string", "description": "上下架状态：ON_SHELF / OFF_SHELF" }, "visibilityType": { "type": "string", "description": "国家可见规则：ALL / WHITELIST / BLACKLIST" }, "visibleCountryCodes": { "type": "array", "description": "可见国家编码列表", "items": { "type": "string", "description": "可见国家编码列表" } }, "importSourceUrl": { "type": "string", "description": "运营录入的原始链接" }, "lastRefreshTime": { "type": "string", "description": "最近一次同步爬虫的时间", "format": "date-time" }, "remark": { "type": "string", "description": "备注" }, "createTime": { "type": "string", "description": "创建时间", "format": "date-time" }, "updateTime": { "type": "string", "description": "更新时间", "format": "date-time" } }, "description": "管理后台 - 热销商品 Response VO" }, "PageResultHotSaleCategoryGoodsRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/HotSaleCategoryGoodsRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "CommonResultHotSaleCategoryGoodsRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/HotSaleCategoryGoodsRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "CommonResultGoodsDetailRiskLogStatisticsRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/GoodsDetailRiskLogStatisticsRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "CountryStatistics": { "type": "object", "properties": { "countryCode": { "type": "string", "description": "国家编码" }, "countryName": { "type": "string", "description": "国家名称" }, "totalCount": { "type": "integer", "description": "请求数", "format": "int64" }, "passCount": { "type": "integer", "description": "通过数", "format": "int64" }, "blockCount": { "type": "integer", "description": "拦截数", "format": "int64" } }, "description": "按国家统计" }, "GoodsDetailRiskLogStatisticsRespVO": { "type": "object", "properties": { "totalCount": { "type": "integer", "description": "总请求数", "format": "int64" }, "passCount": { "type": "integer", "description": "通过数", "format": "int64" }, "blockCount": { "type": "integer", "description": "拦截数", "format": "int64" }, "passRate": { "type": "number", "description": "通过率（百分比）", "format": "double" }, "blockRate": { "type": "number", "description": "拦截率（百分比）", "format": "double" }, "reasonStatistics": { "type": "array", "description": "按风控原因统计", "items": { "$ref": "#/components/schemas/ReasonStatistics" } }, "countryStatistics": { "type": "array", "description": "按国家统计", "items": { "$ref": "#/components/schemas/CountryStatistics" } } }, "description": "管理后台 - 商品详情风控日志统计 Response VO" }, "ReasonStatistics": { "type": "object", "properties": { "reason": { "type": "string", "description": "风控原因" }, "reasonDesc": { "type": "string", "description": "风控原因描述" }, "count": { "type": "integer", "description": "数量", "format": "int64" } }, "description": "按风控原因统计" }, "GoodsDetailRiskLogPageReqVO": { "required": [ "pageNo", "pageSize" ], "type": "object", "properties": { "pageNo": { "minimum": 1, "type": "integer", "description": "页码，从 1 开始", "format": "int32", "example": 1 }, "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "description": "每页条数，最大值为 100", "format": "int32", "example": 10 }, "goodsId": { "type": "string", "description": "商品ID" }, "source": { "type": "integer", "description": "商品来源：1-淘宝，2-1688，3-微店", "format": "int32" }, "userIp": { "type": "string", "description": "用户IP" }, "countryCode": { "type": "string", "description": "国家编码" }, "userId": { "type": "integer", "description": "用户ID", "format": "int64" }, "rno": { "type": "string", "description": "请求标识" }, "result": { "type": "string", "description": "风控结果：PASS-通过，BLOCK-拦截" }, "reason": { "type": "string", "description": "风控原因" }, "createTime": { "type": "array", "description": "创建时间", "items": { "type": "string", "description": "创建时间", "format": "date-time" } } }, "description": "管理后台 - 商品详情风控日志分页 Request VO" }, "CommonResultPageResultGoodsDetailRiskLogRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultGoodsDetailRiskLogRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "GoodsDetailRiskLogRespVO": { "required": [ "createTime", "id" ], "type": "object", "properties": { "id": { "type": "integer", "description": "编号", "format": "int64" }, "goodsId": { "type": "string", "description": "商品ID" }, "source": { "type": "integer", "description": "商品来源：1-淘宝，2-1688，3-微店", "format": "int32" }, "sourceDesc": { "type": "string", "description": "商品来源描述" }, "userIp": { "type": "string", "description": "用户IP" }, "countryCode": { "type": "string", "description": "国家编码" }, "localCountryName": { "type": "string", "description": "本地国家名称" }, "userId": { "type": "integer", "description": "用户ID", "format": "int64" }, "rno": { "type": "string", "description": "请求标识" }, "pageUrl": { "type": "string", "description": "页面URL" }, "result": { "type": "string", "description": "风控结果：PASS-通过，BLOCK-拦截" }, "resultDesc": { "type": "string", "description": "风控结果描述" }, "reason": { "type": "string", "description": "风控原因" }, "reasonDesc": { "type": "string", "description": "风控原因描述" }, "costTime": { "type": "integer", "description": "耗时（毫秒）", "format": "int64" }, "createTime": { "type": "string", "description": "创建时间", "format": "date-time" } }, "description": "管理后台 - 商品详情风控日志 Response VO" }, "PageResultGoodsDetailRiskLogRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/GoodsDetailRiskLogRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "CommonResultGoodsDetailRiskLogRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/GoodsDetailRiskLogRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "GoodsDetailRiskConfigPageReqVO": { "required": [ "pageNo", "pageSize" ], "type": "object", "properties": { "pageNo": { "minimum": 1, "type": "integer", "description": "页码，从 1 开始", "format": "int32", "example": 1 }, "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "description": "每页条数，最大值为 100", "format": "int32", "example": 10 }, "configType": { "type": "string", "description": "配置类型" }, "configValue": { "type": "string", "description": "配置值（模糊搜索）" }, "status": { "type": "integer", "description": "状态：0-禁用，1-启用", "format": "int32" }, "createTime": { "type": "array", "description": "创建时间", "items": { "type": "string", "description": "创建时间", "format": "date-time" } } }, "description": "管理后台 - 商品详情风控配置分页 Request VO" }, "CommonResultPageResultGoodsDetailRiskConfigRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultGoodsDetailRiskConfigRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "GoodsDetailRiskConfigRespVO": { "required": [ "configType", "configValue", "createTime", "id", "status" ], "type": "object", "properties": { "id": { "type": "integer", "description": "编号", "format": "int64" }, "configType": { "type": "string", "description": "配置类型" }, "configTypeDesc": { "type": "string", "description": "配置类型描述" }, "configValue": { "type": "string", "description": "配置值" }, "status": { "type": "integer", "description": "状态：0-禁用，1-启用", "format": "int32" }, "remark": { "type": "string", "description": "备注" }, "createTime": { "type": "string", "description": "创建时间", "format": "date-time" }, "updateTime": { "type": "string", "description": "更新时间", "format": "date-time" } }, "description": "管理后台 - 商品详情风控配置 Response VO" }, "PageResultGoodsDetailRiskConfigRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/GoodsDetailRiskConfigRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "CommonResultGoodsDetailRiskConfigRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/GoodsDetailRiskConfigRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "CommodityTemplatePageReqVO": { "required": [ "pageNo", "pageSize" ], "type": "object", "properties": { "pageNo": { "minimum": 1, "type": "integer", "description": "页码，从 1 开始", "format": "int32", "example": 1 }, "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "description": "每页条数，最大值为 100", "format": "int32", "example": 10 }, "templateType": { "type": "integer", "description": "模板类型", "format": "int32" }, "templateDesc": { "type": "string", "description": "模版名称" }, "commodityId": { "type": "string", "description": "服务商品列表" }, "scene": { "type": "integer", "description": "适用场景", "format": "int32" }, "createTime": { "type": "array", "description": "创建时间", "items": { "type": "string", "description": "创建时间", "format": "date-time" } }, "language": { "type": "string", "description": "语言" } }, "description": "管理后台 - 增值服务商品组合模版分页 Request VO" }, "CommodityTemplateRespVO": { "required": [ "commodityId", "createTime", "id", "language", "status", "templateDesc", "templateType", "type", "uuidCode" ], "type": "object", "properties": { "id": { "type": "integer", "description": "编号", "format": "int64" }, "uuidCode": { "type": "string", "description": "业务唯一id" }, "templateType": { "type": "integer", "description": "模板类型", "format": "int32" }, "templateDesc": { "type": "string", "description": "模版名称" }, "commodityId": { "type": "string", "description": "服务商品列表" }, "commodityIdList": { "type": "array", "description": "服务商品列表", "items": { "type": "integer", "description": "服务商品列表", "format": "int32" } }, "systemCommodityRespDTOList": { "type": "array", "description": "适用服务商品列表", "items": { "$ref": "#/components/schemas/SystemCommodityRespDTO" } }, "scene": { "type": "integer", "description": "适用场景", "format": "int32" }, "createTime": { "type": "string", "description": "创建时间", "format": "date-time" }, "language": { "type": "string", "description": "语言" }, "status": { "type": "integer", "description": "状态", "format": "int32" }, "type": { "type": "integer", "description": "选项类型", "format": "int32" } }, "description": "管理后台 - 增值服务商品组合模版 Response VO" }, "CommonResultPageResultCommodityTemplateRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultCommodityTemplateRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PageResultCommodityTemplateRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/CommodityTemplateRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "CommonResultCommodityTemplateRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/CommodityTemplateRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "CommonResultListCommodityTemplateRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/CommodityTemplateRespVO" } }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } } }, "securitySchemes": { "Authorization": { "type": "apiKey", "name": "Authorization", "in": "header" } } } }