# 编辑商品 ## OpenAPI Specification ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /api/open/product/edit: post: summary: 编辑商品 deprecated: false description: |- 注意事项： 1：可以只传入需要更新的字段， 没有传入的字段不会更新 2：多规格商品，如果已经发布到闲鱼则不能清空SKU，至少要保留一组 3：如果商品状态为销售中，则同步更新到闲鱼App 特别提醒： 如果商品为在架状态时，采用异步的方式更新商品信息到闲鱼App上，因此更新结果采用异步回调的方式进行通知。 如果商品不是在架状态，即使传入回调地址，也不会触发回调通知。 tags: - 商品 parameters: - name: appid in: query description: '' required: true example: '{{appid}}' schema: type: string - name: timestamp in: query description: 当前时间戳（单位秒，5分钟内有效） required: false example: '{{timestamp}}' schema: type: integer default: '{{timestamp}}' - name: seller_id in: query description: 商家ID（仅商务对接传入，自研/第三方ERP对接忽略即可） example: '{{seller_id}}' schema: type: integer - name: sign in: query description: 签名MD5值（参考签名说明） required: true example: '{{sign}}' schema: type: string requestBody: content: application/json: schema: type: object properties: product_id: type: integer title: 管家商品ID format: int64 examples: - 441160510721413 item_biz_type: title: 商品类型ID $ref: '#/components/schemas/item_biz_type' sp_biz_type: title: 商品分类ID $ref: '#/components/schemas/sp_biz_type' category_id: type: integer title: 商品分类 format: int32 examples: - 50025386 channel_cat_id: type: string title: 商品类目ID examples: - e11455b218c06e7ae10cfa39bf43dc0f channel_pv: title: 商品属性 $ref: '#/components/schemas/channel_pv' price: &ref_8 title: 商品售价（分） $ref: '#/components/schemas/price' description: 注意：多规格商品时，必须是SKU其中一个金额 original_price: title: 商品原价（分） $ref: '#/components/schemas/original_price' express_fee: title: 运费 $ref: '#/components/schemas/express_fee' stock: type: integer title: 商品库存 minimum: 1 maximum: 399960 format: int32 examples: - 1 description: 注意：多规格商品，必须是SKU库存的合计 outer_id: type: string title: 商家编码 minLength: 1 maxLength: 64 examples: - '317837811' description: 注意：一个中文按2个字符算 stuff_status: title: 商品成色 $ref: '#/components/schemas/stuff_status' publish_shop: type: array items: type: object x-apifox-refs: 01J18VWFHWEBKB41W9DT61W8ZK: $ref: '#/components/schemas/publish_shop' x-apifox-overrides: images: &ref_5 title: 商品图片URL description: 注意：第1张作为商品主图，前9张发布到闲鱼App $ref: '#/components/schemas/images1' content: &ref_4 type: string title: 商品描述 description: 注意：一个中文按2个字符算，不支持HTML代码，可使用\n换行 minLength: 5 maxLength: 5000 examples: - iPhone 12 128G 黑色 8新，非诚勿扰~~ title: &ref_3 type: string title: 商品标题 description: 注意：一个中文按2个字符算 minLength: 1 examples: - iPhone 12 128G 黑色 maxLength: 60 province: &ref_0 type: integer title: 商品发货省份 format: int32 examples: - 110000 city: &ref_1 type: integer title: 商品发货城市 format: int32 examples: - 110100 district: &ref_2 type: integer title: 商品发货地区 format: int32 examples: - 110101 x-apifox-orders: - 01J18VWFHWEBKB41W9DT61W8ZK properties: user_name: type: string title: 闲鱼会员名 examples: - tb924343042 province: *ref_0 city: *ref_1 district: *ref_2 title: *ref_3 content: *ref_4 images: *ref_5 white_images: type: string title: 商品白底图URL examples: - https://xxx.com/xxx1.jpg description: |- 注意 ： 1：如果传入会在闲鱼商品详情显示，并且无法删除，只能修改 2：当商品类型是特卖类型，即`item_biz_type`=24时，`white_images`为必填 service_support: &ref_9 title: 商品服务 $ref: '#/components/schemas/service_support' express_way: &ref_10 $ref: '#/components/schemas/express_way' title: 物流方式 is_self_pickup: type: boolean title: 是否支持自提 required: - user_name x-apifox-ignore-properties: - user_name - province - city - district - title - content - images - white_images - service_support - express_way - is_self_pickup title: 发布店铺 sku_items: type: array items: $ref: '#/components/schemas/sku_items' title: 商品多规格信息 book_data: title: 图书信息 $ref: '#/components/schemas/book_data' food_data: title: 食品信息 $ref: '#/components/schemas/food_data' report_data: title: 验货报告信息 $ref: '#/components/schemas/report_data' notify_url: type: string title: 商品回调通知地址 description: |- 仅在商品状态为在架中编辑时，才会触发回调通知。 回调参数请查看推送目录下的【商品回调通知】文档，会推送编辑结果。 flash_sale_type: $ref: '#/components/schemas/flash_sale_type' title: 闲鱼特卖类型 advent_data: $ref: '#/components/schemas/advent_data' title: 闲鱼特卖信息 description: 闲鱼特卖类型为临期非食品行业时必传 inspect_data: $ref: >- #/components/schemas/%E9%AA%8C%E8%B4%A7%E5%AE%9D%E4%BF%A1%E6%81%AF title: 验货宝信息 description: 商品类型为验货宝时必传 brand_data: $ref: '#/components/schemas/brand_data' title: 品牌捡漏信息 detail_images: &ref_7 $ref: '#/components/schemas/images' title: 详情图片 sku_images: $ref: '#/components/schemas/sku_images' title: 规格图片 ship_region_data: $ref: >- #/components/schemas/%E8%B7%A8%E5%A2%83%E5%8F%91%E8%B4%A7%E5%9C%B0%E5%8C%BA is_tax_included: type: boolean title: 是否包含税费 description: 目前仅用于跨境商品 required: - product_id x-apifox-orders: - product_id - item_biz_type - sp_biz_type - category_id - channel_cat_id - channel_pv - price - original_price - express_fee - stock - outer_id - stuff_status - publish_shop - sku_items - book_data - food_data - report_data - notify_url - flash_sale_type - advent_data - inspect_data - brand_data - detail_images - sku_images - ship_region_data - is_tax_included x-apifox-ignore-properties: [] example: product_id: 443299347640581 item_biz_type: 2 sp_biz_type: 1 category_id: 50025386 channel_cat_id: e11455b218c06e7ae10cfa39bf43dc0f channel_pv: - property_id: b5e5462c028aba7f1921b9e373cead75 property_name: 交易形式 value_id: 8a3445658e0bc44687b43d68bdc44732 value_name: 代下单 - property_id: 96ad8793a2fdb81bb108d382c4e6ea42 property_name: 面值 value_id: 38ed5f6522cd7ab6 value_name: 100元 title: iPhone 12 128G 黑色 price: 550000 original_price: 700000 express_fee: 10 stock: 10 outer_id: '2021110112345' stuff_status: 100 publish_shop: - images: - https://xxx.com/xxx1.jpg - https://xxx.com/xxx2.jpg user_name: 闲鱼会员名 province: 130000 city: 130100 district: 130101 title: 商品标题 content: 商品描述。 white_images: https://xxx.com/xxx1.jpg service_support: SDR sku_items: - price: 500000 stock: 10 outer_id: '' sku_text: 颜色:白色;容量:128G - price: 600000 stock: 10 outer_id: '' sku_text: 颜色:白色;容量:256G - price: 500000 stock: 10 outer_id: '' sku_text: 颜色:黑色;容量:128G - price: 600000 stock: 10 outer_id: '' sku_text: 颜色:黑色;容量:256G book_data: title: 北京法源寺 author: 李敖 publisher: 中国友谊出版公司 isbn: '9787505720176' food_data: pack: 罐装 spec: '150' brand: 伏特加伏特加 expire: num: 360 unit: 天 production: date: '2021-11-29' address: detail: 北京市东城区x街道 province: 130000 city: 130100 district: 130101 report_data: used_car: report_url: https://xxxxxx.com beauty_makeup: org_id: 181 brand: 欧莱雅 spec: 小瓶装 level: 全新 org_name: 哈哈哈 qc_result: 通过 images: - https://xxx.com/xxx1.jpg - https://xxx.com/xxx2.jpg game: qc_no: '123123' qc_result: 符合 title: 测试游戏 platform: 小霸王 images: - https://xxx.com/xxx1.jpg - https://xxx.com/xxx2.jpg curio: org_id: 191 org_name: NGC评级 size: 12mmx14mm material: 陶瓷 qc_no: '3131319' qc_result: 真品 images: - https://xxx.com/xxx1.jpg - https://xxx.com/xxx2.jpg jewelry: org_name: 某某平台 shape: 圆形 color: 白色 weight: 125g qc_no: '3131319' qc_desc: 无瑕疵 images: - https://xxx.com/xxx1.jpg - https://xxx.com/xxx2.jpg valuable: org_id: 162 org_name: 国检 qc_no: '454545' qc_result: 符合 images: - https://xxx.com/xxx1.jpg - https://xxx.com/xxx2.jpg yx_3c: class_id: 10 subclass_id: 1001 brand_id: 10000 brand_name: 苹果 model_id: 10011 model_name: iPhone 14 Pro model_sn: IMEI/序列号 report_user: 张胜男 report_time: '2024-03-15 18:04:44' report_items: - answer_id: 11103 answer_name: 不开机 answer_type: 2 category_name: 拆修侵液 group_name: 系统情况 question_name: 系统情况 answer_ids: - 11103 - 11106 responses: '200': description: '' content: application/json: schema: type: object x-apifox-refs: 01H5SAJZ63A1D1MSJQYWZ6SZ8Y: $ref: '#/components/schemas/response_ok' x-apifox-overrides: data: &ref_6 type: object properties: product_id: type: integer title: 管家商品ID description: 示例：219530767978565 format: int64 additionalProperties: false product_status: type: integer title: 管家商品状态 description: 示例：10 additionalProperties: false required: - product_id - product_status x-apifox-orders: - product_id - product_status additionalProperties: false x-apifox-ignore-properties: [] required: - data additionalProperties: false x-apifox-orders: - 01H5SAJZ63A1D1MSJQYWZ6SZ8Y properties: code: type: integer format: int32 additionalProperties: false default: 0 msg: type: string additionalProperties: false default: OK data: *ref_6 required: - code - msg - data x-apifox-ignore-properties: - code - msg - data examples: '1': summary: 成功示例 value: code: 0 msg: OK data: product_id: 69 product_status: 80 '2': summary: 异常示例 value: code: 25 msg: exercitation do sint headers: {} x-apifox-name: 成功 x-200:失败: description: '' content: application/json: schema: type: object properties: code: type: integer format: int32 examples: - 500 additionalProperties: false msg: type: string examples: - Internal Server Error additionalProperties: false required: - code - msg x-apifox-orders: - code - msg x-apifox-ignore-properties: [] headers: {} x-apifox-name: 失败 security: [] x-apifox-folder: 商品 x-apifox-status: released x-run-in-apifox: https://app.apifox.com/web/project/2973339/apis/api-93586379-run components: schemas: 跨境发货地区: type: object properties: region_name: type: string title: 地区名称 examples: - 香港 region_code: type: string title: 地区代码 examples: - HKG enum: - HKG - JPN x-apifox-enum: - value: HKG name: 香港 description: '' - value: JPN name: 日本 description: '' description: 注意：目前仅支持香港/日本跨境商品 x-apifox-orders: - region_name - region_code required: - region_name - region_code description: | 目前仅用于跨境商品（必填） x-apifox-ignore-properties: [] x-apifox-folder: '' sku_images: type: array items: type: object properties: src: type: string title: 图片地址 width: type: integer format: int32 title: 图片宽度 height: type: integer format: int32 title: 图片高度 sku_text: type: string title: 规格属性 examples: - 颜色:黑色 x-apifox-orders: - src - width - height - sku_text required: - src - width - height - sku_text x-apifox-ignore-properties: [] title: 规格图片 x-apifox-folder: '' images: type: array items: type: object properties: src: type: string title: 图片地址 width: type: integer format: int32 title: 图片宽度 height: type: integer format: int32 title: 图片高度 x-apifox-orders: - src - width - height required: - src - width - height x-apifox-ignore-properties: [] title: 新图片信息 x-apifox-folder: '' brand_data: type: object properties: expire: type: object properties: num: type: integer title: 保质期 minimum: 1 maximum: 9999 format: int32 examples: - 180 unit: type: string title: 单位 enum: - 天 examples: - 天 x-apifox-enum: - value: 天 name: '' description: '' required: - num - unit x-apifox-orders: - num - unit title: 有效期信息 x-apifox-ignore-properties: [] production: type: object properties: date: type: string title: 生产日期 minLength: 1 maxLength: 20 examples: - 2023-7-15 required: - date x-apifox-orders: - date title: 生产信息 x-apifox-ignore-properties: [] supplier: type: string title: 供应商名称 images: *ref_7 x-apifox-orders: - expire - production - supplier - images title: 品牌捡漏信息 x-apifox-ignore-properties: [] x-apifox-folder: '' 验货宝信息: type: object properties: trade_rule: type: string title: 交易规则 enum: - yhbOptional - yhbOnly examples: - yhbOptional x-apifox-enum: - value: yhbOptional name: '' description: 买家可选是否走验货宝 - value: yhbOnly name: '' description: 买家必须走验货宝 assume_rule: type: string title: 验货费规则 enum: - buyer - seller examples: - buyer x-apifox-enum: - value: buyer name: '' description: 买家承担验货费 - value: seller name: '' description: 卖家承担验货费 required: - trade_rule - assume_rule x-apifox-orders: - trade_rule - assume_rule x-apifox-ignore-properties: [] x-apifox-folder: '' advent_data: type: object properties: expire: type: object properties: num: type: integer title: 保质期 minimum: 1 maximum: 9999 format: int32 examples: - 180 unit: type: string title: 单位 enum: - 天 - 月 - 年 examples: - 天 x-apifox-enum: - value: 天 name: '' description: '' - value: 月 name: '' description: '' - value: 年 name: '' description: '' required: - num - unit x-apifox-orders: - num - unit title: 有效期信息 x-apifox-ignore-properties: [] production: type: object properties: date: type: string title: 生产日期 minLength: 1 maxLength: 20 examples: - 2023-7-15 required: - date x-apifox-orders: - date title: 生产信息 x-apifox-ignore-properties: [] required: - expire - production x-apifox-orders: - expire - production title: 闲鱼特卖信息 x-apifox-ignore-properties: [] x-apifox-folder: '' flash_sale_type: type: integer title: 闲鱼特卖类型 format: int32 enum: - 1 - 2 - 3 - 4 - 5 - 6 - 7 - 8 - 99 - 2601 - 2602 - 2603 - 2604 examples: - 1 x-apifox-enum: - name: '' value: 1 description: 临期 - name: '' value: 2 description: 孤品 - name: '' value: 3 description: 断码 - name: '' value: 4 description: 微瑕 - name: '' value: 5 description: 尾货 - name: '' value: 6 description: 官翻 - name: '' value: 7 description: 全新 - name: '' value: 8 description: 福袋 - name: '' value: 99 description: 其他 - name: '' value: 2601 description: 微瑕 - name: '' value: 2602 description: 临期 - name: '' value: 2603 description: 清仓 - name: '' value: 2604 description: 官翻 description: |- 枚举值： -仅闲鱼特卖类型可用- 1 : 临期 2 : 孤品 3 : 断码 4 : 微瑕 5 : 尾货 6 : 官翻 7 : 全新 8 : 福袋 99 : 其他 -仅闲鱼特卖类型可用- -仅品牌捡漏类型可用- 2601 : 微瑕 2602 : 临期 2603 : 清仓 2604 : 官翻 -仅品牌捡漏类型可用- x-apifox-folder: '' report_data: type: object properties: beauty_makeup: title: 美妆信息 $ref: '#/components/schemas/beauty_makeup' curio: title: 文玩信息 $ref: '#/components/schemas/curio' jewelry: title: 珠宝信息 $ref: '#/components/schemas/jewelry' game: title: 游戏信息 $ref: '#/components/schemas/game' used_car: title: 二手车信息 $ref: '#/components/schemas/used_car' valuable: title: 奢品信息 $ref: '#/components/schemas/valuable' yx_3c: $ref: '#/components/schemas/%E4%B8%A5%E9%80%893c%E4%BF%A1%E6%81%AF' x-apifox-orders: - beauty_makeup - curio - jewelry - game - used_car - valuable - yx_3c title: 验货报告信息 x-apifox-ignore-properties: [] x-apifox-folder: '' 严选3c信息: type: object properties: class_id: type: integer title: 品类ID subclass_id: type: integer title: 子类ID brand_id: type: integer title: 品牌ID brand_name: type: string title: 品牌名称 model_id: type: integer title: 机型ID model_name: type: string title: 机型名称 model_sn: type: string title: IMEI/序列号 report_user: type: string title: 质检人 description: 体现在商品验货报告页 report_time: type: string title: 质检时间 description: 体现在商品验货报告页 report_items: type: array items: type: object properties: answer_id: type: integer format: int32 title: 选项ID answer_name: type: string title: 选项名称 answer_type: type: integer title: 选项类型 enum: - 0 - 1 - 2 examples: - 1 format: int32 x-apifox-enum: - value: 0 name: '' description: 普通项 - value: 1 name: '' description: 正常项 - value: 2 name: '' description: 异常项 answer_desc: type: string title: 选项描述 question_name: type: string title: 问题名称 category_name: type: string title: 分类名称 group_name: type: string title: 分组名称 x-apifox-orders: - answer_id - answer_name - answer_type - answer_desc - question_name - category_name - group_name required: - answer_id - answer_name - answer_type - answer_desc - question_name - category_name - group_name x-apifox-ignore-properties: [] title: 质检报告项 description: 体现在商品验货报告页 answer_ids: type: array items: type: integer title: 质检选项ID description: 内部存储，不对外展示 required: - class_id - subclass_id - brand_id - brand_name - model_id - model_name - model_sn - report_user - report_time - report_items - answer_ids x-apifox-orders: - class_id - subclass_id - brand_id - brand_name - model_id - model_name - model_sn - report_user - report_time - report_items - answer_ids x-apifox-ignore-properties: [] x-apifox-folder: '' valuable: type: object properties: org_id: type: integer title: 检测机构ID format: int32 enum: - 161 - 162 - 163 - 164 examples: - 161 description: |- 枚举值： 161 : 中检 162 : 国检 163 : 华测 164 : 中溯 x-apifox-enum: - value: 161 name: '' description: 中检 - value: 162 name: '' description: 国检 - value: 163 name: '' description: 华测 - value: 164 name: '' description: 中溯 org_name: type: string title: 检测机构名称 examples: - 中检 qc_no: type: string title: 验货编码 examples: - xxx qc_desc: type: string title: 验货描述 images: *ref_5 required: - org_id - org_name - qc_no - qc_desc - images x-apifox-orders: - org_id - org_name - qc_no - qc_desc - images title: 奢品信息 x-apifox-ignore-properties: [] x-apifox-folder: '' used_car: type: object properties: report_url: type: string description: ' 验货报告链接' driving_license_info: type: string description: ' 行驶证主页图片' driving_license_car_photo: type: string description: ' 行驶证车辆页图片' business_license_front: type: string description: ' 营业执照图片' car_function: type: string description: ' 使用性质 : 营运/非营运' car_vin: type: string description: ' 车辆识别代码VIN码' title: OpenProductReportUsedCar x-apifox-orders: - report_url - driving_license_info - driving_license_car_photo - business_license_front - car_function - car_vin x-apifox-ignore-properties: [] x-apifox-folder: '' game: type: object properties: title: type: string title: 报告标题 examples: - 怪物猎人 platform: type: string title: 游戏平台 examples: - PS5 qc_no: type: string title: 验货编码 examples: - xxx qc_desc: type: string title: 验货描述 examples: - 符合 images: *ref_5 required: - title - platform - qc_no - qc_desc - images x-apifox-orders: - title - platform - qc_no - qc_desc - images title: 游戏信息 x-apifox-ignore-properties: [] x-apifox-folder: '' jewelry: type: object properties: shape: type: string title: 形状 examples: - 圆形 color: type: string title: 颜色 examples: - 白色 weight: type: string title: 重量 examples: - 125g org_name: type: string title: 检测机构名称 examples: - xx平台 qc_no: type: string title: 验货编码 examples: - xxx qc_desc: type: string title: 验货描述 examples: - 无瑕疵 images: *ref_5 required: - shape - color - weight - org_name - qc_no - qc_desc - images x-apifox-orders: - shape - color - weight - org_name - qc_no - qc_desc - images title: 珠宝信息 x-apifox-ignore-properties: [] x-apifox-folder: '' curio: type: object properties: size: type: string title: 尺寸 examples: - 12mmx14mm material: type: string title: 材料 examples: - 陶瓷 org_id: type: integer title: 检测机构ID format: int32 enum: - 191 - 192 - 193 - 194 - 195 - 196 - 197 - 198 - 199 - 1910 - 1911 - 1912 examples: - 191 description: |- 枚举值： 191 : NGC评级 192 : PMG评级 193 : 公博评级 194 : PCGS评级 195 : 众诚评级 196 : 保粹评级 197 : 华夏评级 198 : 爱藏评级 199 : 华龙盛世 1910 : 国鉴鉴定 1911 : 信泰评级 1912 : 闻德评级 x-apifox-enum: - value: 191 name: '' description: NGC评级 - value: 192 name: '' description: PMG评级 - value: 193 name: '' description: 公博评级 - value: 194 name: '' description: PCGS评级 - value: 195 name: '' description: 众诚评级 - value: 196 name: '' description: 保粹评级 - value: 197 name: '' description: 华夏评级 - value: 198 name: '' description: 爱藏评级 - value: 199 name: '' description: 华龙盛世 - value: 1910 name: '' description: 国鉴鉴定 - value: 1911 name: '' description: 信泰评级 - value: 1912 name: '' description: 闻德评级 org_name: type: string title: 检测机构名称 examples: - NGC评级 qc_no: type: string title: 验货编码 examples: - xxx images: *ref_5 required: - size - material - org_id - org_name - qc_no - images x-apifox-orders: - size - material - org_id - org_name - qc_no - images title: 文玩信息 x-apifox-ignore-properties: [] x-apifox-folder: '' beauty_makeup: type: object properties: brand: type: string title: 品牌 examples: - 欧莱雅 spec: type: string title: 规格 examples: - 小瓶装 level: type: string title: 成色 examples: - 全新 org_id: type: integer title: 检测机构ID format: int32 enum: - 181 - 182 examples: - 181 description: |- 枚举值： 181 : 维鉴 182 : 中检科深 x-apifox-enum: - value: 181 name: '' description: 维鉴 - value: 182 name: '' description: 中检科深 org_name: type: string title: 检测机构名称 examples: - 维鉴 images: *ref_5 required: - brand - spec - level - org_id - org_name - images x-apifox-orders: - brand - spec - level - org_id - org_name - images title: 美妆信息 x-apifox-ignore-properties: [] x-apifox-folder: '' food_data: type: object properties: brand: type: string title: 食品品牌 minLength: 1 maxLength: 30 examples: - 旺旺 spec: type: string title: 食品规格 minLength: 1 maxLength: 30 examples: - 大包 pack: type: string title: 食品包装 minLength: 1 maxLength: 10 examples: - 袋装 expire: type: object properties: num: type: integer title: 保质期 minimum: 1 maximum: 9999 format: int32 examples: - 180 unit: type: string title: 单位 enum: - 天 - 月 - 年 examples: - 天 x-apifox-enum: - value: 天 name: '' description: '' - value: 月 name: '' description: '' - value: 年 name: '' description: '' required: - num - unit x-apifox-orders: - num - unit title: 食品有效期信息 x-apifox-ignore-properties: [] production: type: object properties: date: type: string title: 食品生产日期 minLength: 1 maxLength: 20 examples: - 2023-7-15 address: type: object properties: detail: type: string title: 详细地址 minLength: 1 maxLength: 60 province: type: integer title: 生产地省份ID format: int32 examples: - 110000 city: type: integer title: 生产地城市ID format: int32 examples: - 110100 district: type: integer title: 生产地地区ID format: int32 examples: - 110101 required: - detail - province - city - district x-apifox-orders: - detail - province - city - district title: 食品生产地信息 x-apifox-ignore-properties: [] required: - date - address x-apifox-orders: - date - address title: 食品生产信息 x-apifox-ignore-properties: [] required: - brand - spec - pack - expire - production x-apifox-orders: - brand - spec - pack - expire - production title: 食品信息 x-apifox-ignore-properties: [] x-apifox-folder: '' book_data: type: object properties: isbn: type: string title: 图书ISBN码 pattern: /^((?:[0-9]{9}X|[0-9]{10})|(?:(?:97(?:8|9))[0-9]{10}))$/ additionalProperties: false examples: - '9787505720176' title: type: string title: 图书标题 additionalProperties: false examples: - 北京法源寺 author: type: string title: 图书作者 additionalProperties: false examples: - 李敖 minLength: 1 maxLength: 30 publisher: type: string title: 图书出版社 additionalProperties: false examples: - 中国友谊出版公司 minLength: 1 maxLength: 30 required: - isbn - title x-apifox-orders: - isbn - title - author - publisher title: 图书信息 x-apifox-ignore-properties: [] x-apifox-folder: '' sku_items: type: object properties: price: *ref_8 stock: type: integer title: SKU库存 maximum: 9999 format: int32 minimum: 0 examples: - 10 sku_text: type: string title: SKU规格 examples: - 颜色:黑色;内存:512G description: |- 格式：规格:属性，多个时使用";"拼接 示例：颜色:白色;容量:128G 限制：规格名称最多4个字，属性名称最多 20 个字（不分区中英文） outer_id: type: string title: SKU商品编码 examples: - '2023072101' minLength: 0 maxLength: 64 description: 注意：一个中文按2个字符算 x-apifox-orders: - price - stock - sku_text - outer_id required: - price - stock - sku_text title: SKU信息 x-apifox-ignore-properties: [] x-apifox-folder: '' express_way: type: integer title: 物流方式 format: int32 default: 0 examples: - 1 enum: - '1 ' - '2 ' - '3 ' - '5 ' x-apifox-enum: - value: '1 ' name: 包邮 description: '' - value: '2 ' name: 按距离计费 description: '' - value: '3 ' name: 统一运费 description: '' - value: '5 ' name: 无需邮寄 description: '' x-apifox-folder: '' service_support: type: string title: 商品服务项 description: |- 多个时用英文逗号`,`拼接 枚举值： SDR : 七天无理由退货 NFR : 描述不符包邮退 VNR : 描述不符全额退（虚拟类） FD_10MS : 10分钟极速发货（虚拟类） FD_24HS : 24小时极速发货 FD_48HS : 48小时极速发货 FD_GPA : 正品保障（包赔） NFGC : 不符必赔 NFR_30D : 30天描述不符可退 RSI : 运费退货险 F3P : 假⼀赔三 RISK_30D : 30天收货 RISK_90D : 90天收货 examples: - SDR,NFR x-apifox-folder: '' publish_shop: type: object properties: user_name: type: string title: 闲鱼会员名 examples: - tb924343042 province: type: integer title: 商品发货省份 format: int32 examples: - 110000 city: type: integer title: 商品发货城市 format: int32 examples: - 110100 district: type: integer title: 商品发货地区 format: int32 examples: - 110101 title: type: string title: 商品标题 description: 注意：一个中文按2个字符算 minLength: 1 examples: - iPhone 12 128G 黑色 maxLength: 60 content: type: string title: 商品描述 description: 注意：一个中文按2个字符算，不支持HTML代码，可使用\n换行 minLength: 5 maxLength: 5000 examples: - iPhone 12 128G 黑色 8新，非诚勿扰~~ images: *ref_5 white_images: type: string title: 商品白底图URL examples: - https://xxx.com/xxx1.jpg description: |- 注意 ： 1：如果传入会在闲鱼商品详情显示，并且无法删除，只能修改 2：当商品类型是特卖类型，即`item_biz_type`=24时，`white_images`为必填 service_support: *ref_9 express_way: *ref_10 is_self_pickup: type: boolean title: 是否支持自提 x-apifox-orders: - user_name - province - city - district - title - content - images - white_images - service_support - express_way - is_self_pickup required: - user_name - province - city - district - title - content - images title: 店铺发布信息 x-apifox-ignore-properties: [] x-apifox-folder: '' images1: type: array items: type: string examples: - https://xxx.com/xxx1.jpg title: 图片信息 minItems: 1 maxItems: 30 uniqueItems: true x-apifox-folder: '' stuff_status: type: integer title: 商品成色 description: |- 枚举值： 0 : 无成色（普通商品可用） 100 : 全新 -1 : 准新 99 : 99新 95 : 95新 90 : 9新 80 : 8新 70 : 7新 60 : 6新 50 : 5新 -仅品牌捡漏类型可用- 40 : 未使用·中度瑕疵 30 : 未使用·轻微瑕疵 20 : 未使用·仅拆封 10 : 未使用·准新 100 : 全新未使用 -仅品牌捡漏类型可用- 及以下注意：非普通商品类型时必填~~ format: int32 enum: - 100 - -1 - 99 - 95 - 90 - 80 - 70 - 60 - 50 - 40 - 30 - 20 - 10 - 0 default: 0 examples: - 100 x-apifox-enum: - value: 100 name: '' description: 全新 - value: -1 name: '' description: 准新 - value: 99 name: '' description: 99新 - value: 95 name: '' description: 95新 - value: 90 name: '' description: 9新 - value: 80 name: '' description: 8新 - value: 70 name: '' description: 7新 - value: 60 name: '' description: 6新 - value: 50 name: '' description: 5新及以下 - value: 40 name: '' description: 未使用·中度瑕疵 - value: 30 name: '' description: 未使用·轻微瑕疵 - value: 20 name: '' description: 未使用·仅拆封 - value: 10 name: '' description: 未使用·准新 - value: 0 name: '' description: 无 x-apifox-folder: '' express_fee: type: integer title: 运费 format: int64 x-apifox-folder: '' original_price: type: integer title: 商品原价 minimum: 0 maximum: 9999999900 format: int64 examples: - 199900 x-apifox-folder: '' price: type: integer title: 商品售价 minimum: 1 maximum: 9999999900 format: int64 examples: - 199900 x-apifox-folder: '' channel_pv: type: array items: type: object properties: property_id: type: string title: 属性ID examples: - 83b8f62c43df34e6 property_name: type: string title: 属性名称 examples: - 品牌 value_id: type: string title: 属性值ID examples: - 76f78d92eeb4f5f6eccf7d4fabef47b6 value_name: type: string title: 属性值名称 examples: - Apple/苹果 x-apifox-orders: - property_id - property_name - value_id - value_name required: - property_id - property_name - value_id - value_name x-apifox-ignore-properties: [] title: 商品属性 x-apifox-folder: '' sp_biz_type: type: integer title: 行业类型 format: int32 enum: - 1 - 2 - 3 - 8 - 9 - 16 - 17 - 18 - 19 - 20 - 21 - 22 - 23 - 24 - 25 - 27 - 28 - 29 - 30 - 31 - 33 - 99 examples: - 2 x-apifox-enum: - name: '' value: 1 description: 手机 - name: '' value: 2 description: 潮品 - name: '' value: 3 description: 家电 - name: '' value: 8 description: 乐器 - name: '' value: 9 description: 3C数码 - name: '' value: 16 description: 奢品 - name: '' value: 17 description: 母婴 - name: '' value: 18 description: 美妆个护 - name: '' value: 19 description: 文玩/珠宝 - name: '' value: 20 description: 游戏电玩 - name: '' value: 21 description: 家居 - name: '' value: 22 description: 虚拟游戏 - name: '' value: 23 description: 租号 - name: '' value: 24 description: 图书 - name: '' value: 25 description: 卡券 - name: '' value: 27 description: 食品 - name: '' value: 28 description: 潮玩 - name: '' value: 29 description: 二手车 - name: '' value: 30 description: 宠植 - name: '' value: 31 description: 工艺礼品 - name: '' value: 33 description: 汽车服务 - name: '' value: 99 description: 其他 x-apifox-folder: '' item_biz_type: type: integer title: 商品类型 format: int32 enum: - 2 - 0 - 10 - 16 - 19 - 24 - 26 - 35 examples: - 2 x-apifox-enum: - name: '' value: 2 description: 普通商品 - name: '' value: 0 description: 已验货 - name: '' value: 10 description: 验货宝 - name: '' value: 16 description: 品牌授权 - name: '' value: 19 description: 闲鱼严选 - name: '' value: 24 description: 闲鱼特卖 - name: '' value: 26 description: 品牌捡漏 - value: 35 name: '' description: 跨境商品 x-apifox-folder: '' response_ok: type: object properties: code: type: integer format: int32 additionalProperties: false default: 0 msg: type: string additionalProperties: false default: OK data: type: object properties: {} x-apifox-orders: [] additionalProperties: false x-apifox-ignore-properties: [] x-apifox-orders: - code - msg - data required: - code - msg - data title: 成功报文 x-apifox-ignore-properties: [] x-apifox-folder: '' securitySchemes: apiKey: type: apikey description: Enter JWT Bearer token **_only_** name: Authorization in: header servers: - url: https://open.goofish.pro description: 新版正式环境 security: [] ```