商标相关接口
更新时间:2023-11-24
创建商标订单并下单支付
接口描述
本接口用于购买商标并自动支付,默认直接扣减账户余额,如填写资源包则扣减资源包额度。暂不支持使用代金券
请求结构
> POST https://tms-api.baidu.com/v1/tms/openapi/trademarks
> Authorization: authorization string
> Host: tms-api.baidu.com
> x-bce-console-rpc-id: e69c8fff-166b-4c82-87c1-7aa3ba309d5c
> x-bce-date: 2020-04-27T02:43:18Z
{
"trademarkType": 1,
"iconColor": 1,
"trademarkName": "百度",
"remark": "商标名称为 百度",
"applicantId": "TAP-ddB5evmM5dG",
"classifications": [
"20,2001,200041,家具",
"20,2001,200079,床垫",
"20,2001,200102,床",
"20,2001,200183,沙发",
"20,2001,200188,金属桌",
"20,2001,200320,衣柜",
"20,2001,,乳胶床垫",
"20,2001,,卧室家具",
"20,2001,,户外家具",
"20,2001,,橱柜"
],
"resourcePackId": "",
"iconPic": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD...",
"authorizePdfBase64": "data:application/pdf;base64,JVBERi0xLjQKJcfsj...",
"authorizeType": "PORTRAIT"
}
参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
---|---|---|---|---|
trademarkType | integer | 是 | BODY | 商标类型, 1文字, 2图片, 3图片+彩色 |
iconColor | integer | 是 | BODY | 商标颜色, 1黑白,2彩色 |
trademarkName | string | 是 | BODY | 商标名称,trademarkType=1或3时必传 |
remark | string | 是 | BODY | 商标说明 |
applicantId | string | 是 | BODY | 申请人id |
classifications | array | 是 | BODY | 商标分类详情,字符串格式数组,例如 ["20,2001,200041,家具"],如小项没有3级分类编码,则写空,如 ["20,2001,,户外家具"] |
resourcePackId | string | 否 | BODY | 资源包ID |
iconPic | string | 是 | BODY | 商标图片base64字符串 图片格式必须为jpg/jpeg,开头为 data:image/jpeg ;、data:image/jpg ; |
authorizePdfBase64 | string | 否 | BODY | 授权书 base64字符,开头为 data:application/pdf;base64, |
authorizeType | string | 否 | BODY | 授权书类型,可参考 |
响应结果
< Cache-Control: no-cache
< Content-Length: 0
< Date: Mon, 27 Apr 2020 11:48:34 GMT
< Server: BWS
< x-bce-request-id: de3f0c3e-86f6-43e7-b1bd-35a837f4b84f
{
"trademarkId" : "TTR-2GEHBFmeGzL"
}
响应头域
除公共头域外,无其它特殊头域。
响应参数
参数名称 | 类型 | 描述 |
---|---|---|
trademarkId | string | 商标ID |
修改商标
接口描述
本接口用于修改商标,支持修改商标名称,商标说明,商标图样,授权书,授权书类型;商标名称、商标说明、商标图样、(授权书、授权书类型)必须有一个,不填默认不修改
请求结构
> PUT https://tms-api.baidu.com/v1/tms/openapi/trademarks/TTR-2GEHBFmeGzL
> Authorization: authorization string
> Host: tms-api.baidu.com
> x-bce-console-rpc-id: e69c8fff-166b-4c82-87c1-7aa3ba309d5c
> x-bce-date: 2020-04-27T02:43:18Z
{
"trademarkName" : "百度智能云",
"remark" : "商标名称为 百度智能云",
"iconBase64" : "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD...",
"authorizePdfBase64" : "data:application/pdf;base64,JVBERi0xLjQKJcfsj...",
"authorizeType" : "NAME"
}
参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
---|---|---|---|---|
trademarkId | string | 是 | PATH | 要修改的商标ID |
trademarkName | string | 否 | BODY | 商标名称。如果为图形商标则商标名称为 图形 。商标名称、商标说明、商标图样、(授权书、授权书类型)必须有一个,不填默认不修改 |
remark | string | 否 | BODY | 商标说明 |
iconBase64 | string | 否 | BODY | 商标图样base64,图片格式必须为jpg/jpeg,开头为 data:image/jpeg ;、data:image/jpg ; |
authorizePdfBase64 | string | 否 | BODY | 授权书 pdf base64字符串 |
authorizeType | string | 否 | BODY | 授权书类型。不能为空字符串,无授权书将该参数去除或填写NONE 。可参考 TrademarkAuthorizeType |
响应结果
< Cache-Control: no-cache
< Content-Length: 0
< Date: Mon, 27 Apr 2020 11:48:34 GMT
< Server: BWS
< x-bce-request-id: de3f0c3e-86f6-43e7-b1bd-35a837f4b84f
{
"trademarkId" : "TTR-2GEHBFmeGzL"
}
响应头域
除公共头域外,无其它特殊头域。
响应参数
参数名称 | 类型 | 描述 |
---|---|---|
result | boolean | 操作结果:true-成功 false-失败 |
撤销申请
接口描述
本接口用于撤销申请
请求结构
> DELETE https://tms-api.baidu.com/v1/tms/openapi/trademarks/TTR-2GEHBFmeGzL
> Authorization: authorization string
> Host: tms-api.baidu.com
> x-bce-console-rpc-id: e69c8fff-166b-4c82-87c1-7aa3ba309d5c
> x-bce-date: 2020-04-27T02:43:18Z
参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
---|---|---|---|---|
trademarkId | string | 是 | PATH | 要修改的商标ID |
响应结果
< Cache-Control: no-cache
< Content-Length: 0
< Date: Mon, 27 Apr 2020 11:48:34 GMT
< Server: BWS
< x-bce-request-id: de3f0c3e-86f6-43e7-b1bd-35a837f4b84f
{
"result" : true
}
响应头域
除公共头域外,无其它特殊头域。
响应参数
参数名称 | 类型 | 描述 |
---|---|---|
result | boolean | 操作结果:true-成功 false-失败 |
获取商标详情
接口描述
本接口用于撤销申请
请求结构
> GET https://tms-api.baidu.com/v1/tms/openapi/trademarks/TTR-2GEHBFmeGzL
> Authorization: authorization string
> Host: tms-api.baidu.com
> x-bce-console-rpc-id: e69c8fff-166b-4c82-87c1-7aa3ba309d5c
> x-bce-date: 2020-04-27T02:43:18Z
参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
---|---|---|---|---|
trademarkId | string | 是 | PATH | 要获取详情的商标ID |
响应结果
< Cache-Control: no-cache
< Content-Length: 0
< Date: Mon, 27 Apr 2020 11:48:34 GMT
< Server: BWS
< x-bce-request-id: de3f0c3e-86f6-43e7-b1bd-35a837f4b84f
{
"applicant": {
"applicantId": "TAP-ddB5evmM5dG",
"type": "Enterprise",
"region": "Mainland",
"name": "百度在线网络技术(北京)有限公司",
"country": "",
"province": 110000,
"address": "北京市海淀区上地十街10号百度大厦三层",
"englishName": "",
"englishAddress": "",
"idCard": "",
"creditCode": "91110108717743469K",
"idCardUrl": "https://bj.bcebos.com/v1/tms-custom/xxx",
"englishIdCardUrl": "",
"businessLicenseUrl": "https://bj.bcebos.com/v1/tms-custom/xxx",
"englishBusinessLicenseUrl": "",
"loaUrl": "https://bj.bcebos.com/v1/tms-custom/xxx",
"loaReuseUrl": "",
"contactName": "王小明",
"contactNumber": "010-59928888",
"contactEmail": "baidu@baidu.com",
"contactAddress": "北京北京市海淀区上地十街10号百度大厦三层",
"contactPostcode": "010010",
"status": "AUDITING",
"statusInfo": "",
"createTime": "2023-09-19T13:29:25Z",
"updateTime": "2023-09-20T06:02:01Z"
},
"trademark": {
"trademarkId": "TTR-2GEHBFmeGzL",
"trademarkType": 1,
"iconUrl": "https://bj.bcebos.com/v1/tms-custom/xxx",
"authorizePdfUrl": "",
"authorizeType": "PORTRAIT",
"status": "AUDITING",
"statusDesc": "审核中",
"applicantId": "TAP-HQyhjsmmYVF",
"applicantName": "郭威",
"name": "晴晴晴骑",
"remark": "商标名称由“晴晴晴骑”组成。",
"registrationNumber": "",
"classifications": [
"20,2001,200041,家具",
"20,2001,200079,床垫",
"20,2001,200102,床",
"20,2001,200183,沙发",
"20,2001,200188,金属桌",
"20,2001,200320,衣柜",
"20,2001,,乳胶床垫",
"20,2001,,卧室家具",
"20,2001,,户外家具",
"20,2001,,橱柜"
],
"createTime": "2023-09-20T05:29:00Z",
"updateTime": "2023-09-20T05:29:29Z",
"statusInfo": {
"rejectionReason": "",
"message": ""
}
}
}
响应头域
除公共头域外,无其它特殊头域。
响应参数
参数名称 | 类型 | 描述 |
---|---|---|
applicant | object | 申请人信息 |
→ applicantId | string | 申请人id |
→ type | string | 申请人类型,可参考ApplicantType |
→ region | string | 申请人地域,可参考ApplicantRegion |
→ name | string | 申请人名称 |
→ country | string | 申请人所在国家,可参考ApplicantRegion |
→ province | integer | 申请人所在省份,可参考ApplicantProvince |
→ address | string | 申请人地址 |
→ englishName | string | 申请人英文名称 |
→ englishAddress | string | 申请人英文地址 |
→ idCard | string | 申请人证件号码 |
→ creditCode | string | 申请人社会信用代码 |
→ idCardUrl | string | 申请人身份证图片url |
→ englishIdCardUrl | string | 申请人英文身份证图片url |
→ businessLicenseUrl | string | 营业执照副本复印件图片url |
→ englishBusinessLicenseUrl | string | 申请人英文营业执照url |
→ loaUrl | string | 委托书图片url |
→ loaReuseUrl | string | 委托书复用申明图片url |
→ contactName | string | 联系人姓名 |
→ contactNumber | string | 联系人电话 |
→ contactEmail | string | 联系人邮箱 |
→ contactAddress | string | 联系人地址 |
→ contactPostcode | string | 联系人邮编 |
→ status | string | 申请人状态 |
→ statusInfo | string | 申请人审核信息 |
→ createTime | string | 申请人创建时间 |
→ updateTime | string | 申请人更新时间 |
trademark | object | 商标信息 |
→ trademarkId | string | 商标id |
→ trademarkType | integer | 商标类型 |
→ iconUrl | string | 商标图片url |
→ authorizePdfUrl | string | 授权pdf文件url |
→ authorizeType | string | 授权书类型,可参考TrademarkAuthorizeType |
→ status | string | 商标状态,可参考TrademarkStatus |
→ statusDesc | string | 商标状态中文描述 |
→ applicantId | string | 申请人id |
→ applicantName | string | 申请人姓名 |
→ name | string | 商标名称 |
→ remark | string | 商标说明 |
→ registrationNumber | string | 商标注册号 |
→ classifications | array | 商标分类详情 |
→ createTime | string | 创建时间 |
→ updateTime | string | 更新时间 |
→ statusInfo | object | 状态信息 |
→ → rejectionReason | string | 被拒原因,多个被拒原因用; 分割,可参考TrademarkRejectionReason |
→ → message | string | 商标状态详细信息 |
获取商标列表
接口描述
本接口用于获取商标列表
请求结构
> POST https://tms-api.baidu.com/v1/tms/openapi/trademarks/list
> Authorization: authorization string
> Host: tms-api.baidu.com
> x-bce-console-rpc-id: e69c8fff-166b-4c82-87c1-7aa3ba309d5c
> x-bce-date: 2020-04-27T02:43:18Z
{
"keyword" : "",
"keywordType" : "",
"trademarkType" : 1,
"status" : null,
"orderBy" : "",
"order" : "",
"pageNo" : 1,
"pageSize" : 10,
"startTime" : "2020-01-01 00:00:00",
"endTime" : "2023-01-01 00:00:00"
}
参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
---|---|---|---|---|
keyword | string | 否 | BODY | 商标关键字 |
keywordType | string | 否 | BODY | 根据商标名称搜索-trademarkName 根据申请人名称搜索-applicantName |
trademarkType | integer | 否 | BODY | 商标类型,1-文字,2-图片,3-图片+文字,如不筛选请填写null ,不能填写空字符串 |
status | string | 否 | BODY | 商标状态,如不筛选请填写null ,不能填写空字符串,可参考TrademarkStatus |
orderBy | string | 否 | BODY | 排序列 默认为createTime |
order | string | 否 | BODY | 排序方式 asc desc 默认为desc |
pageNo | integer | 否 | BODY | 页码 默认为1 |
pageSize | integer | 否 | BODY | 页大小 默认为10 |
startTime | string | 否 | BODY | 筛选开始时间 |
endTime | string | 否 | BODY | 筛选结束时间 |
响应结果
< Cache-Control: no-cache
< Content-Length: 0
< Date: Mon, 27 Apr 2020 11:48:34 GMT
< Server: BWS
< x-bce-request-id: de3f0c3e-86f6-43e7-b1bd-35a837f4b84f
{
"pageNo": 1,
"pageSize": 10,
"totalCount": 2,
"result": [
{
"trademarkId": "TTR-zGoHpNvfvUB",
"trademarkType": 1,
"iconUrl": "https://bj.bcebos.com/v1/tms-custom/xxx",
"authorizePdfUrl": "",
"authorizeType": "NONE",
"status": "AUDITING",
"statusDesc": "审核中",
"applicantId": "TAP-wV5kTQxgG9t",
"applicantName": "百度在线网络技术(北京)有限公司",
"name": "百度",
"remark": "商标名称由“百度”组成。",
"registrationNumber": "",
"classifications": [
"01,0103,,原子堆用燃料",
"01,0103,,天然铀",
"01,0103,,镭",
"01,0103,010018,锕",
"01,0103,010087,核反应堆用燃料",
"01,0103,010115,锫",
"01,0103,010253,重水",
"01,0103,010297,核能用可裂变物质",
"01,0103,010314,钫",
"01,0103,010369,工业用同位素"
],
"createTime": "2022-04-08T07:34:14Z",
"updateTime": "2022-04-08T07:49:03Z",
"statusInfo": {
"rejectionReason": null,
"message": "。"
}
},
{
"trademarkId": "TTR-Xj6sMdubdLW",
"trademarkType": 1,
"iconUrl": "https://bj.bcebos.com/v1/tms-custom/xxx",
"authorizePdfUrl": "",
"authorizeType": "NONE",
"status": "AUDITING",
"statusDesc": "审核中",
"applicantId": "TAP-FuJHYMjePsV",
"applicantName": "百度在线网络技术(北京)有限公司",
"name": "百度",
"remark": "商标名称由“百度”组成。",
"registrationNumber": "",
"classifications": [
"01,0101,,一氧化碳",
"01,0101,,二氧化氯",
"01,0101,,二氧化硫",
"01,0101,,亚硫酸气体(二氧化硫)",
"01,0101,,光气(碳酰氯)",
"01,0101,,六氟化硫"
],
"createTime": "2022-04-28T10:41:08Z",
"updateTime": "2022-05-09T02:27:52Z",
"statusInfo": {
"rejectionReason": null,
"message": "。"
}
}
]
}
响应头域
除公共头域外,无其它特殊头域。
响应参数
参数名称 | 类型 | 描述 |
---|---|---|
pageNo | integer | 页码 |
pageSize | integer | 页大小 |
totalCount | integer | 总数量 |
result | array | 商标列表 |
→ trademarkId | string | 商标id |
→ trademarkType | integer | 商标类型,1文字,2图片,3图片+文字 |
→ iconUrl | string | 商标图片url,30分钟有效时间 |
→ authorizePdfUrl | string | 授权pdf文件url,30分钟有效时间 |
→ authorizeType | string | 授权书类型 |
→ status | string | 商标状态,可参考附录TrademarkStatus |
→ statusDesc | string | 商标状态中文描述 |
→ applicantId | string | 申请人id |
→ applicantName | string | 申请人姓名 |
→ name | string | 商标名称 |
→ remark | string | 商标说明 |
→ registrationNumber | string | 商标注册号 |
→ classifications | array | 商标分类详情 |
→ createTime | string | 创建时间 |
→ updateTime | string | 更新时间 |
→ statusInfo | object | 状态信息 |
→ → rejectionReason | string | 被拒原因,多个用";"隔开 可参考 TrademarkRejectionReason |
→ → message | string | 商标状态详细信息 |
通过商标名创建商标图片
接口描述 本接口用于通过商标名创建商标图片
请求结构
> POST https://tms-api.baidu.com/v1/tms/openapi/trademarks/icon
> Authorization: authorization string
> Host: tms-api.baidu.com
> x-bce-console-rpc-id: e69c8fff-166b-4c82-87c1-7aa3ba309d5c
> x-bce-date: 2020-04-27T02:43:18Z
{
"name" : "百度"
}
参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
---|---|---|---|---|
name | string | 是 | BODY | 商标名称 |
响应结果
< Cache-Control: no-cache
< Content-Length: 0
< Date: Mon, 27 Apr 2020 11:48:34 GMT
< Server: BWS
< x-bce-request-id: de3f0c3e-86f6-43e7-b1bd-35a837f4b84f
{
"materialKey": "BOS:/tms-custom/xxx",
"materialUrl": "https://bj.bcebos.com/v1/tms-custom/xxx",
"materialBase64": "data:image/jpeg;base64,/9j/xxx"
}
响应头域
除公共头域外,无其它特殊头域。
响应参数
参数名称 | 类型 | 描述 |
---|---|---|
materialUrl | string | 商标图样Url,30分钟有效时间 |
materialBase64 | string | 商标图样base64 |
检查商标名称是否合法
接口描述 本接口用于检查商标名称是否合法
请求结构
> POST https://tms-api.baidu.com/v1/tms/openapi/trademarks/check-name
> Authorization: authorization string
> Host: tms-api.baidu.com
> x-bce-console-rpc-id: e69c8fff-166b-4c82-87c1-7aa3ba309d5c
> x-bce-date: 2020-04-27T02:43:18Z
{
"trademarkName" : "百度",
"resourcePackId" : ""
}
参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
---|---|---|---|---|
trademarkName | string | 是 | BODY | 商标名称 |
resourcePackId | string | 否 | BODY | 资源包ID,如商标需要通过资源包进行提交,则需要填写资源包ID |
响应结果
< Cache-Control: no-cache
< Content-Length: 0
< Date: Mon, 27 Apr 2020 11:48:34 GMT
< Server: BWS
< x-bce-request-id: de3f0c3e-86f6-43e7-b1bd-35a837f4b84f
{
"result": "PASS",
"message": "不违规",
"illegalKeyword": null
}
响应头域
除公共头域外,无其它特殊头域。
响应参数
参数名称 | 类型 | 描述 |
---|---|---|
result | string | 结果 PASS-通过 NO_PASS-不通过 |
message | string | 原因 |
illegalKeyword | string | 违禁词 |
商标小项全量获取
接口描述 本接口用于商标小项全量获取
请求结构
> GET https://tms-api.baidu.com/v1/tms/openapi/trademarks/classifications
> Authorization: authorization string
> Host: tms-api.baidu.com
> x-bce-console-rpc-id: e69c8fff-166b-4c82-87c1-7aa3ba309d5c
> x-bce-date: 2020-04-27T02:43:18Z
响应结果
< Cache-Control: no-cache
< Content-Length: 0
< Date: Mon, 27 Apr 2020 11:48:34 GMT
< Server: BWS
< x-bce-request-id: de3f0c3e-86f6-43e7-b1bd-35a837f4b84f
{
"result": [
{
"name": "化学制剂",
"code": "01",
"parentCode": "",
"level": 1,
"children": [
{
"name": "工业气体,单质",
"code": "0101",
"parentCode": "01",
"level": 2,
"children": [
{
"name": "碱土金属",
"code": "010039",
"parentCode": "0101",
"level": 3,
"children": null
},
{
"name": "氨",
"code": "010061",
"parentCode": "0101",
"level": 3,
"children": null
}...
响应头域
除公共头域外,无其它特殊头域。
响应参数
参数名称 | 类型 | 描述 | 子元素描述 |
---|---|---|---|
result | array | 结果集 | |
→ name | string | 小项名称 | |
→ code | string | 小项代码 | |
→ parentCode | string | 小项父类代码 | |
→ level | integer | 小项级别 | |
→ children | array | 小项子类 | |
→ name | string | 小项名称 | |
→ code | string | 小项代码 | |
→ parentCode | string | 小项父类代码 | |
→ level | integer | 小项级别 | |
→ children | array | 小项子类 |