商品证书接口

提供查询平台支持的所有证书分类信息的能力，返回证书的唯一标识ID及分类简称。

适用场景

获取平台内所有证书的分类信息，用于证书类型筛选、展示或与商品证书信息关联等场景

接口类型

GET

请求频率限制

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

请求说明

请求URL

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

请求参数

Header参数

参数名	类型	必填	示例值	说明
Authorization	string	是	authorization	身份验证Token
Content-Type	string	否	application/json	建议传递此值，确保请求格式正确

响应字段说明

成功响应（HTTP 200）

根字段

字段	类型	说明
status	string	接口状态，`success`表示成功
message	string	状态描述，成功时返回`success`
data	array	证书分类数组，包含所有证书的分类数据

data数组字段

字段	类型	说明
id	integer	证书分类唯一标识ID
abbreviation	string	证书分类简称（如FDA、MSDS、CPNP等），与“SKU获取证书”接口返回的`abbreviation`字段对应

调用示例

URL请求

请求示例

成功返回示例

{
    "status": "success",
    "message": "success",
    "data": [
        {
            "id": 7,
            "abbreviation": "FDA"
        },
        {
            "id": 9,
            "abbreviation": "MSDS(NEW)"
        },
        {
            "id": 4,
            "abbreviation": "CPNP"
        },
        {
            "id": 3,
            "abbreviation": "SCPN"
        },
        {
            "id": 2,
            "abbreviation": "MFDS"
        },
        {
            "id": 5,
            "abbreviation": "CN"
        },
        {
            "id": 8,
            "abbreviation": "MSDS(CHEMICAL)"
        },
        {
            "id": 1,
            "abbreviation": "MSDS"
        },
        {
            "id": 16,
            "abbreviation": "NOM"
        },
        {
            "id": 18,
            "abbreviation": "CPSR"
        },
        {
            "id": 10,
            "abbreviation": "THFDA"
        },
        {
            "id": 15,
            "abbreviation": "GCC"
        },
        {
            "id": 6,
            "abbreviation": "NDC"
        },
        {
            "id": 14,
            "abbreviation": "EU DoC"
        },
        {
            "id": 11,
            "abbreviation": "COACN"
        },
        {
            "id": 17,
            "abbreviation": "NPRA"
        },
        {
            "id": 12,
            "abbreviation": "COAEN"
        },
        {
            "id": 13,
            "abbreviation": "BPOM"
        }
    ]
}

失败返回示例

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

错误处理

公共错误码

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

常见问题

Q1：证书简称（abbreviation）对应的具体证书名称是什么？

A：可参考“SKU获取证书”接口返回的assort_name字段（如FDA对应“美国化妆品监督证明”，CPNP对应“欧盟化妆品通报证明”）。

Q2：返回的证书分类是否会动态更新？

A：是的，平台可能会新增或调整证书分类，建议定期调用此接口同步最新的证书分类列表。

Q3：如何根据证书分类筛选特定证书？

A：可先通过本接口获取目标证书的id或abbreviation，再结合“SKU获取证书”接口的返回结果进行筛选。

版本历史

版本	日期	修改说明
v1.0	2025-01-01	初始版本，支持返回所有证书分类的ID和简称

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "status": "success",
    "message": "success",
    "data": [
        {
            "id": 7,
            "abbreviation": "FDA"
        },
        {
            "id": 9,
            "abbreviation": "MSDS(NEW)"
        },
        {
            "id": 1,
            "abbreviation": "MSDS"
        },
        {
            "id": 4,
            "abbreviation": "CPNP"
        },
        {
            "id": 3,
            "abbreviation": "SCPN"
        },
        {
            "id": 2,
            "abbreviation": "MFDS"
        },
        {
            "id": 5,
            "abbreviation": "CN"
        },
        {
            "id": 8,
            "abbreviation": "MSDS(CHEMICAL)"
        },
        {
            "id": 6,
            "abbreviation": "NDC"
        },
        {
            "id": 10,
            "abbreviation": "THFDA"
        },
        {
            "id": 11,
            "abbreviation": "COACN"
        },
        {
            "id": 12,
            "abbreviation": "COAEN"
        }
    ]
}

商品证书

商品证书接口#

适用场景#

接口类型#

请求频率限制#

请求说明#

请求参数#

Header参数#

响应字段说明#

调用示例#

URL请求#

请求示例#

成功返回示例#

失败返回示例#

错误处理#

常见问题#

Q1：证书简称（abbreviation）对应的具体证书名称是什么？#

Q2：返回的证书分类是否会动态更新？#

Q3：如何根据证书分类筛选特定证书？#

版本历史#

请求参数

请求示例代码

返回响应

商品证书接口

适用场景

接口类型

请求频率限制

请求说明

请求参数

Header参数

响应字段说明

调用示例

URL请求

请求示例

成功返回示例

失败返回示例

错误处理

常见问题

Q1：证书简称（abbreviation）对应的具体证书名称是什么？

Q2：返回的证书分类是否会动态更新？

Q3：如何根据证书分类筛选特定证书？

版本历史