品牌授权记录接口

提供品牌授权记录的查询能力，支持多条件筛选，可获取品牌授权申请的详细信息，包括申请状态、平台信息、品牌信息等。

适用场景

查询品牌授权的申请记录及详细信息

按条件筛选特定状态、平台、品牌等的授权记录

了解品牌授权的申请进度和相关详情

接口类型

POST

请求频率限制

默认频率：以平台配额为准

请求说明

请求URL

正式环境：https://www.westmonth.com/openapi/brandAuthorizing/list
测试环境：https://testing.westmonth.com/openapi/brandAuthorizing/list

请求参数

Header参数

参数名	类型	必填	示例值	说明
Authorization	string	是	authorization	身份验证Token
Content-Type	string	是	application/json	建议固定传此值

Body参数

根字段

参数名	类型	必填	默认值	可选值	说明
shop_id	string	是	-	-	店铺ID
platform_name_cn	string	是	-	-	平台中文名称
brand_name	string	是	-	-	品牌名称
brand_category_name	string	是	-	-	品牌类别名称
status	string	是	-	1: 待审核, 2: 已完成, 3: 已拒绝, 4: 失效, 5: 作废, 6: 作废中, 7: 作废无效	状态
period_of_validity	array	是	-	-	授权结束日期，例：["2025-04-03", "2025-04-04"]
apply_time	array	是	-	-	申请日期，例：["2025-04-03", "2025-04-04"]
serial_number	string	是	-	-	流水号
page	integer	是	1	-	页码
per_page	integer	是	10	-	每页条数

响应字段说明

成功响应（HTTP 200）

根字段

字段	类型	说明
code	integer	错误码（0=成功 1=服务错误 2=参数错误 3=授权无效 4=请求上限）
msg	string	错误描述
data	object	业务数据

data对象字段

字段	类型	说明
list	array	列表
ossPathFix	string	OSS域名
pagination	object	分页信息

list数组字段

字段	类型	说明
id	integer	申请记录分组ID
status	integer	状态 (1: 待审核, 2: 已完成, 3: 已拒绝, 4: 失效, 5: 作废, 6: 作废中, 7: 作废无效)
customer_id	integer	用户ID
created_at	string	申请时间
updated_at	string	更新时间
brand_authorizings	array	授权申请记录
serial	integer	-

brand_authorizings数组字段

字段	类型	说明
id	integer	授权申请ID
status	integer	状态 (1: 待审核, 2: 已完成, 3: 已拒绝, 4: 失效, 5: 作废, 6: 作废中, 7: 作废无效)
customer_id	integer	-
batch_number	string	流水号
main_id	integer	-
serial_number	null	-
work_order_no	string	-
template_type	integer	-
template_category	integer	-
template_category_name	string	模板类型名称
platform_id	integer	-
platform_name_cn	string	授权平台名称
platform_name_en	string	-
partner_license_id	string	-
partner_license_name_me	null	-
partner_license_name_cn	string	-
partner_legal_representative	string	-
partner_legal_representative_name	null	-
partner_license_name_en	string	-
partner_address_en	null	-
shop_id	string	店铺id
include_shop_info	integer	-
additional_shop_info	string	-
authorization_start_date	string	授权开始日期
authorization_end_date	string	授权结束日期
seal_date	string	-
required_seal_file	null	-
contract_templates	string	-
legal_representative_seal_type	integer	-
brand_id	integer	-
brand_name	string	授权品牌名称
trademark_number	string	-
authorized_company	string	-
authorized_person_id	null	-
authorized_person_name	null	-
authorized_person_id_number	null	-
authorized_company_name_en	string	-
country_id	integer	-
country_name_cn	string	品牌申请国家名称
country_name_en	string	-
brand_category_id	integer	-
brand_category_name	string	品牌类别名称
certificate_attachment	string	-
legal_representative_name_en	string	-
certificate_attachment_path	array	证书/回执附件信息
brand_authorization_letter_path	array	品牌授权书信息
remarks	null	-
system_service_scope	string	-
feedback	integer	-
created_at	string	-
updated_at	string	-
statusText	string	状态
applicant	string	申请人电话

certificate_attachment_path数组字段

字段	类型	说明
filePath	string	文件路径
fileName	string	文件名称

brand_authorization_letter_path数组字段

字段	类型	说明
filePath	string	文件路径
fileName	string	文件名称

pagination对象字段

字段	类型	说明
total	integer	总条数
perPage	integer	每页条数
currentPage	integer	当前页码
lastPage	integer	最后一页页码

调用示例

URL请求

请求示例

{
    "shop_id": "",
    "platform_name_cn": "",
    "brand_name": "",
    "brand_category_name": "",
    "status": "",
    "period_of_validity": [],
    "apply_time": [],
    "serial_number": "",
    "page": 1,
    "per_page": 10
}

成功返回示例

{
    "code": 0,
    "msg": "",
    "data": {
        "list": [
            {
                "id": 49174,
                "status": 2,
                "customer_id": 880,
                "created_at": "2025-07-11 18:21:46",
                "updated_at": "2025-07-11 19:02:17",
                "serial": 1,
                "brand_authorizings": [
                    {
                        "id": 204353,
                        "status": 2,
                        "customer_id": 880,
                        "batch_number": "PPSQ_49174",
                        "main_id": 49174,
                        "serial_number": "YZSQPPSQ20250711200",
                        "work_order_no": "",
                        "template_type": 0,
                        "template_category": 0,
                        "template_category_name": "中文通用模板",
                        "platform_id": 1,
                        "platform_name_cn": "Allegro",
                        "platform_name_en": "Allegro",
                        "partner_license_id": "0",
                        "partner_license_name_me": null,
                        "partner_license_name_cn": "xxx",
                        "partner_legal_representative": "0",
                        "partner_legal_representative_name": null,
                        "partner_license_name_en": "xxx",
                        "partner_address_en": null,
                        "shop_id": "1000062260",
                        "include_shop_info": 3,
                        "additional_shop_info": "12345",
                        "authorization_start_date": "2025-07-11",
                        "authorization_end_date": "2026-07-11",
                        "seal_date": "2025-07-11",
                        "required_seal_file": null,
                        "contract_templates": "5",
                        "legal_representative_seal_type": 0,
                        "brand_id": 3447,
                        "brand_name": "EELHOE",
                        "trademark_number": "76983487",
                        "authorized_company": "1047",
                        "authorized_person_id": null,
                        "authorized_person_name": null,
                        "authorized_person_id_number": null,
                        "authorized_company_name_en": "Shantou yihao daily chemical technology co., ltd.",
                        "country_id": 1,
                        "country_name_cn": "中国",
                        "country_name_en": "China",
                        "brand_category_id": 10,
                        "brand_category_name": "11类",
                        "certificate_attachment": "668276",
                        "legal_representative_name_en": "Liao Jianna",
                        "certificate_attachment_path": [
                            {
                                "filePath": "westmonth/authorization/band_file/extracted/668276/商标注册证转让_76983487_1733084360314.pdf",
                                "fileName": "商标注册证转让_76983487_1733084360314.pdf",
                                "docid": "668276"
                            }
                        ],
                        "brand_authorization_letter": "1139073",
                        "brand_authorization_letter_path": [
                            {
                                "filePath": "westmonth/authorization/band_file/extracted/1139073/YZSQPPSQ20250711200第三方系统审批代理2650762.pdf",
                                "fileName": "YZSQPPSQ20250711200第三方系统审批代理2650762.pdf",
                                "docid": "1139073"
                            }
                        ],
                        "remarks": "审核通过",
                        "system_service_scope": "电热水壶；便携式冰箱；熨斗加热器；自动浇水装置；蒸脸器具(蒸汽浴)；家用水龙头过滤器；牙刷消毒器；热水袋",
                        "feedback": 1,
                        "failed_remarks": "",
                        "created_at": "2025-07-11 18:21:49",
                        "updated_at": "2025-07-11 19:02:20",
                        "contact": "",
                        "email": "",
                        "mobile": "",
                        "statusText": "已完成",
                        "applicant": "+86 19074250376"
                    }
                ]
            }
        ],
        "ossPathFix": "https://westmonth-oss.oss-rg-china-mainland.aliyuncs.com/",
        "pagination": {
            "total": 6,
            "perPage": 10,
            "currentPage": 1,
            "lastPage": 1
        }
    }
}

失败返回示例

{
    "code": 3,
    "msg": "授权无效 authorization timestamp error",
    "data": []
}

错误处理

公共错误码

HTTP status code	错误码	错误信息	描述

常见问题

Q1：如何根据状态筛选特定的品牌授权记录？

A：在请求参数的status字段中传入对应的状态值即可，例如1表示待审核，2表示已完成等。

Q2：返回结果中的“ossPathFix”字段有什么作用？

A：“ossPathFix”是OSS域名，可与证书/回执附件信息、品牌授权书信息中的filePath拼接，获取完整的文件访问路径。

版本历史

版本	日期	修改说明
v1.0	2025-07-09	初始版本

application/json

Bodyapplication/json

示例

{
    "code": 0,
    "msg": "",
    "data": {
        "list": [
            {
                "id": 10061,
                "status": 1,
                "customer_id": 880,
                "created_at": "2025-05-19 17:16:38",
                "updated_at": "2025-05-19 17:16:38",
                "serial": 1,
                "brand_authorizings": [
                    {
                        "id": 10499,
                        "status": 1,
                        "customer_id": 880,
                        "batch_number": "PPSQ_10061",
                        "main_id": 10061,
                        "serial_number": null,
                        "work_order_no": "",
                        "template_type": 0,
                        "template_category": 0,
                        "template_category_name": "中文通用模板",
                        "platform_id": 1,
                        "platform_name_cn": "Allegro",
                        "platform_name_en": "Allegro",
                        "partner_license_id": "0",
                        "partner_license_name_me": null,
                        "partner_license_name_cn": "xxx",
                        "partner_legal_representative": "0",
                        "partner_legal_representative_name": null,
                        "partner_license_name_en": "xxx",
                        "partner_address_en": null,
                        "shop_id": "1234",
                        "include_shop_info": 3,
                        "additional_shop_info": "12345",
                        "authorization_start_date": "2025-05-19",
                        "authorization_end_date": "2026-05-19",
                        "seal_date": "2025-05-19",
                        "required_seal_file": null,
                        "contract_templates": "5",
                        "legal_representative_seal_type": 0,
                        "brand_id": 3296,
                        "brand_name": "Dreahoe",
                        "trademark_number": "019018046",
                        "authorized_company": "1229",
                        "authorized_person_id": null,
                        "authorized_person_name": null,
                        "authorized_person_id_number": null,
                        "authorized_company_name_en": "GUANGDONG XIZHIYUE TECHNOLOGY CO., LTD.",
                        "country_id": 3,
                        "country_name_cn": "欧盟",
                        "country_name_en": "EU",
                        "brand_category_id": 2,
                        "brand_category_name": "3类",
                        "certificate_attachment": "252086",
                        "legal_representative_name_en": "Chen Jing",
                        "certificate_attachment_path": [],
                        "brand_authorization_letter": null,
                        "brand_authorization_letter_path": [],
                        "remarks": null,
                        "system_service_scope": "beautymasks;cleaningpreparations;cosmeticpencils;cosmeticpreparationsforskincare;cosmeticpreparationsforslimmingpurposes;cosmetics;cosmeticsforanimals;deodorantsforpets;hairconditioners;hairdyes;hairlotions;leatherpreservatives[polishes];make-up;nailpolish;shampoos;skinwhiteningcreams;toothpaste;waxesforleather.",
                        "feedback": 1,
                        "created_at": "2025-05-19 17:16:38",
                        "updated_at": "2025-05-19 17:16:38",
                        "statusText": "待审核",
                        "applicant": "+86 19074250376"
                    },
                    {
                        "id": 10500,
                        "status": 1,
                        "customer_id": 880,
                        "batch_number": "PPSQ_10061",
                        "main_id": 10061,
                        "serial_number": null,
                        "work_order_no": "",
                        "template_type": 0,
                        "template_category": 0,
                        "template_category_name": "中文通用模板",
                        "platform_id": 1,
                        "platform_name_cn": "Allegro",
                        "platform_name_en": "Allegro",
                        "partner_license_id": "0",
                        "partner_license_name_me": null,
                        "partner_license_name_cn": "xxx",
                        "partner_legal_representative": "0",
                        "partner_legal_representative_name": null,
                        "partner_license_name_en": "xxx",
                        "partner_address_en": null,
                        "shop_id": "1234",
                        "include_shop_info": 3,
                        "additional_shop_info": "12345",
                        "authorization_start_date": "2025-05-19",
                        "authorization_end_date": "2026-05-19",
                        "seal_date": "2025-05-19",
                        "required_seal_file": null,
                        "contract_templates": "5",
                        "legal_representative_seal_type": 0,
                        "brand_id": 3447,
                        "brand_name": "EELHOE",
                        "trademark_number": "76983487",
                        "authorized_company": "1047",
                        "authorized_person_id": null,
                        "authorized_person_name": null,
                        "authorized_person_id_number": null,
                        "authorized_company_name_en": "Shantou yihao daily chemical technology co., ltd.",
                        "country_id": 1,
                        "country_name_cn": "中国",
                        "country_name_en": "China",
                        "brand_category_id": 10,
                        "brand_category_name": "11类",
                        "certificate_attachment": "668276",
                        "legal_representative_name_en": "Liao Jianna",
                        "certificate_attachment_path": [],
                        "brand_authorization_letter": null,
                        "brand_authorization_letter_path": [],
                        "remarks": null,
                        "system_service_scope": "电热水壶；便携式冰箱；熨斗加热器；自动浇水装置；蒸脸器具(蒸汽浴)；家用水龙头过滤器；牙刷消毒器；热水袋",
                        "feedback": 1,
                        "created_at": "2025-05-19 17:16:38",
                        "updated_at": "2025-05-19 17:16:38",
                        "statusText": "待审核",
                        "applicant": "+86 19074250376"
                    }
                ]
            }
        ],
        "ossPathFix": "https://westmonth.oss-rg-china-mainland.aliyuncs.com/",
        "pagination": {
            "total": 1,
            "perPage": 10,
            "currentPage": 1,
            "lastPage": 1
        }
    }
}

品牌授权记录

品牌授权记录接口

适用场景

接口类型

请求频率限制

请求说明

请求参数

Header参数

Body参数

响应字段说明

调用示例

URL请求

请求示例

成功返回示例

失败返回示例

错误处理

常见问题

Q1：如何根据状态筛选特定的品牌授权记录？

Q2：返回结果中的“ossPathFix”字段有什么作用？

版本历史

请求参数

请求示例代码

返回响应

品牌授权记录

品牌授权记录接口#

适用场景#

接口类型#

请求频率限制#

请求说明#

请求参数#

Header参数#

Body参数#

响应字段说明#

调用示例#

URL请求#

请求示例#

成功返回示例#

失败返回示例#

错误处理#

常见问题#

Q1：如何根据状态筛选特定的品牌授权记录？#

Q2：返回结果中的“ossPathFix”字段有什么作用？#

版本历史#

请求参数

请求示例代码

返回响应

品牌授权记录接口

适用场景

接口类型

请求频率限制

请求说明

请求参数

Header参数

Body参数

响应字段说明

调用示例

URL请求

请求示例

成功返回示例

失败返回示例

错误处理

常见问题

Q1：如何根据状态筛选特定的品牌授权记录？

Q2：返回结果中的“ossPathFix”字段有什么作用？

版本历史