获取模板类型列表

提供根据平台ID获取对应模板类型列表的能力，返回模板类型的ID和名称等信息。

适用场景

在需要为特定平台选择模板时，获取该平台支持的所有模板类型列表

接口类型

POST

请求频率限制

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

请求说明

请求URL

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

请求参数

Header参数

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

Body参数

根字段

参数名	类型	必填	默认值	可选值	说明
platform_id	integer	是	-	-	平台ID，可通过获取授权平台列表接口获取

响应字段说明

成功响应（HTTP 200）

根字段

字段	类型	说明
code	integer	业务状态码（0表示成功，1=服务错误，2=参数错误，3=授权无效，4=请求上限）
msg	string	错误描述信息
data	array	业务数据，包含模板类型列表

data数组字段

字段	类型	说明
template_category	integer	模板类型ID
template_category_name	string	模板类型名称

调用示例

URL请求

请求示例

{
    "platform_id":1
}

成功返回示例

{
    "code": 0,
    "msg": "",
    "data": [
        {
            "template_category": 1,
            "template_category_name": "英文通用模板"
        },
        {
            "template_category": 0,
            "template_category_name": "中文通用模板"
        }
    ]
}

失败返回示例

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

错误处理

公共错误码

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

常见问题

Q1：platform_id如何获取？

A：可以通过调用“获取授权平台列表”接口获取各个平台对应的platform_id。

Q2：为什么返回的data数组为空？

A：可能是该平台暂无对应的模板类型，可检查platform_id是否正确，或联系技术支持确认该平台是否有可用模板。

版本历史

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

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "code": 0,
    "msg": "",
    "data": [
        {
            "template_category": 4,
            "template_category_name": "速卖通（自营店和全托管店）"
        },
        {
            "template_category": 3,
            "template_category_name": "希音中英文模板"
        },
        {
            "template_category": 0,
            "template_category_name": "中文通用模板"
        }
    ]
}

获取模板类型列表

获取模板类型列表#

适用场景#

接口类型#

请求频率限制#

请求说明#

请求参数#

Header参数#

Body参数#

响应字段说明#

调用示例#

URL请求#

请求示例#

成功返回示例#

失败返回示例#

错误处理#

常见问题#

Q1：platform_id如何获取？#

Q2：为什么返回的data数组为空？#

版本历史#

请求参数

请求示例代码

返回响应

获取模板类型列表

适用场景

接口类型

请求频率限制

请求说明

请求参数

Header参数

Body参数

响应字段说明

调用示例

URL请求

请求示例

成功返回示例

失败返回示例

错误处理

常见问题

Q1：platform_id如何获取？

Q2：为什么返回的data数组为空？

版本历史