商标相关接口
更新时间:2023-11-24
创建商标订单并下单支付
接口描述
本接口用于购买商标并自动支付,默认直接扣减账户余额,如填写资源包则扣减资源包额度。暂不支持使用代金券
请求结构
Plain Text
1> POST https://tms-api.baidu.com/v1/tms/openapi/trademarks
2> Authorization: authorization string
3> Host: tms-api.baidu.com
4> x-bce-console-rpc-id: e69c8fff-166b-4c82-87c1-7aa3ba309d5c
5> x-bce-date: 2020-04-27T02:43:18Z
6{
7 "trademarkType": 1,
8 "iconColor": 1,
9 "trademarkName": "百度",
10 "remark": "商标名称为 百度",
11 "applicantId": "TAP-ddB5evmM5dG",
12 "classifications": [
13 "20,2001,200041,家具",
14 "20,2001,200079,床垫",
15 "20,2001,200102,床",
16 "20,2001,200183,沙发",
17 "20,2001,200188,金属桌",
18 "20,2001,200320,衣柜",
19 "20,2001,,乳胶床垫",
20 "20,2001,,卧室家具",
21 "20,2001,,户外家具",
22 "20,2001,,橱柜"
23 ],
24 "resourcePackId": "",
25 "iconPic": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD...",
26 "authorizePdfBase64": "data:application/pdf;base64,JVBERi0xLjQKJcfsj...",
27 "authorizeType": "PORTRAIT"
28}
参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
---|---|---|---|---|
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 | 授权书类型,可参考 |
响应结果
Plain Text
1< Cache-Control: no-cache
2< Content-Length: 0
3< Date: Mon, 27 Apr 2020 11:48:34 GMT
4< Server: BWS
5< x-bce-request-id: de3f0c3e-86f6-43e7-b1bd-35a837f4b84f
6{
7 "trademarkId" : "TTR-2GEHBFmeGzL"
8}
响应头域
除公共头域外,无其它特殊头域。
响应参数
参数名称 | 类型 | 描述 |
---|---|---|
trademarkId | string | 商标ID |
修改商标
接口描述
本接口用于修改商标,支持修改商标名称,商标说明,商标图样,授权书,授权书类型;商标名称、商标说明、商标图样、(授权书、授权书类型)必须有一个,不填默认不修改
请求结构
Plain Text
1> PUT https://tms-api.baidu.com/v1/tms/openapi/trademarks/TTR-2GEHBFmeGzL
2> Authorization: authorization string
3> Host: tms-api.baidu.com
4> x-bce-console-rpc-id: e69c8fff-166b-4c82-87c1-7aa3ba309d5c
5> x-bce-date: 2020-04-27T02:43:18Z
6{
7 "trademarkName" : "百度智能云",
8 "remark" : "商标名称为 百度智能云",
9 "iconBase64" : "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD...",
10 "authorizePdfBase64" : "data:application/pdf;base64,JVBERi0xLjQKJcfsj...",
11 "authorizeType" : "NAME"
12}
参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
---|---|---|---|---|
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 |
响应结果
Plain Text
1< Cache-Control: no-cache
2< Content-Length: 0
3< Date: Mon, 27 Apr 2020 11:48:34 GMT
4< Server: BWS
5< x-bce-request-id: de3f0c3e-86f6-43e7-b1bd-35a837f4b84f
6{
7 "trademarkId" : "TTR-2GEHBFmeGzL"
8}
响应头域
除公共头域外,无其它特殊头域。
响应参数
参数名称 | 类型 | 描述 |
---|---|---|
result | boolean | 操作结果:true-成功 false-失败 |
撤销申请
接口描述
本接口用于撤销申请
请求结构
Plain Text
1> DELETE https://tms-api.baidu.com/v1/tms/openapi/trademarks/TTR-2GEHBFmeGzL
2> Authorization: authorization string
3> Host: tms-api.baidu.com
4> x-bce-console-rpc-id: e69c8fff-166b-4c82-87c1-7aa3ba309d5c
5> x-bce-date: 2020-04-27T02:43:18Z
参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
---|---|---|---|---|
trademarkId | string | 是 | PATH | 要修改的商标ID |
响应结果
Plain Text
1< Cache-Control: no-cache
2< Content-Length: 0
3< Date: Mon, 27 Apr 2020 11:48:34 GMT
4< Server: BWS
5< x-bce-request-id: de3f0c3e-86f6-43e7-b1bd-35a837f4b84f
6{
7 "result" : true
8}
响应头域
除公共头域外,无其它特殊头域。
响应参数
参数名称 | 类型 | 描述 |
---|---|---|
result | boolean | 操作结果:true-成功 false-失败 |
获取商标详情
接口描述
本接口用于撤销申请
请求结构
Plain Text
1> GET https://tms-api.baidu.com/v1/tms/openapi/trademarks/TTR-2GEHBFmeGzL
2> Authorization: authorization string
3> Host: tms-api.baidu.com
4> x-bce-console-rpc-id: e69c8fff-166b-4c82-87c1-7aa3ba309d5c
5> x-bce-date: 2020-04-27T02:43:18Z
参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
---|---|---|---|---|
trademarkId | string | 是 | PATH | 要获取详情的商标ID |
响应结果
Plain Text
1< Cache-Control: no-cache
2< Content-Length: 0
3< Date: Mon, 27 Apr 2020 11:48:34 GMT
4< Server: BWS
5< x-bce-request-id: de3f0c3e-86f6-43e7-b1bd-35a837f4b84f
6{
7 "applicant": {
8 "applicantId": "TAP-ddB5evmM5dG",
9 "type": "Enterprise",
10 "region": "Mainland",
11 "name": "百度在线网络技术(北京)有限公司",
12 "country": "",
13 "province": 110000,
14 "address": "北京市海淀区上地十街10号百度大厦三层",
15 "englishName": "",
16 "englishAddress": "",
17 "idCard": "",
18 "creditCode": "91110108717743469K",
19 "idCardUrl": "https://bj.bcebos.com/v1/tms-custom/xxx",
20 "englishIdCardUrl": "",
21 "businessLicenseUrl": "https://bj.bcebos.com/v1/tms-custom/xxx",
22 "englishBusinessLicenseUrl": "",
23 "loaUrl": "https://bj.bcebos.com/v1/tms-custom/xxx",
24 "loaReuseUrl": "",
25 "contactName": "王小明",
26 "contactNumber": "010-59928888",
27 "contactEmail": "baidu@baidu.com",
28 "contactAddress": "北京北京市海淀区上地十街10号百度大厦三层",
29 "contactPostcode": "010010",
30 "status": "AUDITING",
31 "statusInfo": "",
32 "createTime": "2023-09-19T13:29:25Z",
33 "updateTime": "2023-09-20T06:02:01Z"
34 },
35 "trademark": {
36 "trademarkId": "TTR-2GEHBFmeGzL",
37 "trademarkType": 1,
38 "iconUrl": "https://bj.bcebos.com/v1/tms-custom/xxx",
39 "authorizePdfUrl": "",
40 "authorizeType": "PORTRAIT",
41 "status": "AUDITING",
42 "statusDesc": "审核中",
43 "applicantId": "TAP-HQyhjsmmYVF",
44 "applicantName": "郭威",
45 "name": "晴晴晴骑",
46 "remark": "商标名称由“晴晴晴骑”组成。",
47 "registrationNumber": "",
48 "classifications": [
49 "20,2001,200041,家具",
50 "20,2001,200079,床垫",
51 "20,2001,200102,床",
52 "20,2001,200183,沙发",
53 "20,2001,200188,金属桌",
54 "20,2001,200320,衣柜",
55 "20,2001,,乳胶床垫",
56 "20,2001,,卧室家具",
57 "20,2001,,户外家具",
58 "20,2001,,橱柜"
59 ],
60 "createTime": "2023-09-20T05:29:00Z",
61 "updateTime": "2023-09-20T05:29:29Z",
62 "statusInfo": {
63 "rejectionReason": "",
64 "message": ""
65 }
66 }
67}
响应头域
除公共头域外,无其它特殊头域。
响应参数
参数名称 | 类型 | 描述 |
---|---|---|
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 | 商标状态详细信息 |
获取商标列表
接口描述
本接口用于获取商标列表
请求结构
Plain Text
1> POST https://tms-api.baidu.com/v1/tms/openapi/trademarks/list
2> Authorization: authorization string
3> Host: tms-api.baidu.com
4> x-bce-console-rpc-id: e69c8fff-166b-4c82-87c1-7aa3ba309d5c
5> x-bce-date: 2020-04-27T02:43:18Z
6{
7 "keyword" : "",
8 "keywordType" : "",
9 "trademarkType" : 1,
10 "status" : null,
11 "orderBy" : "",
12 "order" : "",
13 "pageNo" : 1,
14 "pageSize" : 10,
15 "startTime" : "2020-01-01 00:00:00",
16 "endTime" : "2023-01-01 00:00:00"
17}
参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
---|---|---|---|---|
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 | 筛选结束时间 |
响应结果
Plain Text
1< Cache-Control: no-cache
2< Content-Length: 0
3< Date: Mon, 27 Apr 2020 11:48:34 GMT
4< Server: BWS
5< x-bce-request-id: de3f0c3e-86f6-43e7-b1bd-35a837f4b84f
6{
7 "pageNo": 1,
8 "pageSize": 10,
9 "totalCount": 2,
10 "result": [
11 {
12 "trademarkId": "TTR-zGoHpNvfvUB",
13 "trademarkType": 1,
14 "iconUrl": "https://bj.bcebos.com/v1/tms-custom/xxx",
15 "authorizePdfUrl": "",
16 "authorizeType": "NONE",
17 "status": "AUDITING",
18 "statusDesc": "审核中",
19 "applicantId": "TAP-wV5kTQxgG9t",
20 "applicantName": "百度在线网络技术(北京)有限公司",
21 "name": "百度",
22 "remark": "商标名称由“百度”组成。",
23 "registrationNumber": "",
24 "classifications": [
25 "01,0103,,原子堆用燃料",
26 "01,0103,,天然铀",
27 "01,0103,,镭",
28 "01,0103,010018,锕",
29 "01,0103,010087,核反应堆用燃料",
30 "01,0103,010115,锫",
31 "01,0103,010253,重水",
32 "01,0103,010297,核能用可裂变物质",
33 "01,0103,010314,钫",
34 "01,0103,010369,工业用同位素"
35 ],
36 "createTime": "2022-04-08T07:34:14Z",
37 "updateTime": "2022-04-08T07:49:03Z",
38 "statusInfo": {
39 "rejectionReason": null,
40 "message": "。"
41 }
42 },
43 {
44 "trademarkId": "TTR-Xj6sMdubdLW",
45 "trademarkType": 1,
46 "iconUrl": "https://bj.bcebos.com/v1/tms-custom/xxx",
47 "authorizePdfUrl": "",
48 "authorizeType": "NONE",
49 "status": "AUDITING",
50 "statusDesc": "审核中",
51 "applicantId": "TAP-FuJHYMjePsV",
52 "applicantName": "百度在线网络技术(北京)有限公司",
53 "name": "百度",
54 "remark": "商标名称由“百度”组成。",
55 "registrationNumber": "",
56 "classifications": [
57 "01,0101,,一氧化碳",
58 "01,0101,,二氧化氯",
59 "01,0101,,二氧化硫",
60 "01,0101,,亚硫酸气体(二氧化硫)",
61 "01,0101,,光气(碳酰氯)",
62 "01,0101,,六氟化硫"
63 ],
64 "createTime": "2022-04-28T10:41:08Z",
65 "updateTime": "2022-05-09T02:27:52Z",
66 "statusInfo": {
67 "rejectionReason": null,
68 "message": "。"
69 }
70 }
71 ]
72}
响应头域
除公共头域外,无其它特殊头域。
响应参数
参数名称 | 类型 | 描述 |
---|---|---|
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 | 商标状态详细信息 |
通过商标名创建商标图片
接口描述 本接口用于通过商标名创建商标图片
请求结构
Plain Text
1> POST https://tms-api.baidu.com/v1/tms/openapi/trademarks/icon
2> Authorization: authorization string
3> Host: tms-api.baidu.com
4> x-bce-console-rpc-id: e69c8fff-166b-4c82-87c1-7aa3ba309d5c
5> x-bce-date: 2020-04-27T02:43:18Z
6{
7 "name" : "百度"
8}
参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
---|---|---|---|---|
name | string | 是 | BODY | 商标名称 |
响应结果
Plain Text
1< Cache-Control: no-cache
2< Content-Length: 0
3< Date: Mon, 27 Apr 2020 11:48:34 GMT
4< Server: BWS
5< x-bce-request-id: de3f0c3e-86f6-43e7-b1bd-35a837f4b84f
6{
7 "materialKey": "BOS:/tms-custom/xxx",
8 "materialUrl": "https://bj.bcebos.com/v1/tms-custom/xxx",
9 "materialBase64": "data:image/jpeg;base64,/9j/xxx"
10}
响应头域
除公共头域外,无其它特殊头域。
响应参数
参数名称 | 类型 | 描述 |
---|---|---|
materialUrl | string | 商标图样Url,30分钟有效时间 |
materialBase64 | string | 商标图样base64 |
检查商标名称是否合法
接口描述 本接口用于检查商标名称是否合法
请求结构
Plain Text
1> POST https://tms-api.baidu.com/v1/tms/openapi/trademarks/check-name
2> Authorization: authorization string
3> Host: tms-api.baidu.com
4> x-bce-console-rpc-id: e69c8fff-166b-4c82-87c1-7aa3ba309d5c
5> x-bce-date: 2020-04-27T02:43:18Z
6{
7 "trademarkName" : "百度",
8 "resourcePackId" : ""
9}
参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
---|---|---|---|---|
trademarkName | string | 是 | BODY | 商标名称 |
resourcePackId | string | 否 | BODY | 资源包ID,如商标需要通过资源包进行提交,则需要填写资源包ID |
响应结果
Plain Text
1< Cache-Control: no-cache
2< Content-Length: 0
3< Date: Mon, 27 Apr 2020 11:48:34 GMT
4< Server: BWS
5< x-bce-request-id: de3f0c3e-86f6-43e7-b1bd-35a837f4b84f
6{
7 "result": "PASS",
8 "message": "不违规",
9 "illegalKeyword": null
10}
响应头域
除公共头域外,无其它特殊头域。
响应参数
参数名称 | 类型 | 描述 |
---|---|---|
result | string | 结果 PASS-通过 NO_PASS-不通过 |
message | string | 原因 |
illegalKeyword | string | 违禁词 |
商标小项全量获取
接口描述 本接口用于商标小项全量获取
请求结构
Plain Text
1> GET https://tms-api.baidu.com/v1/tms/openapi/trademarks/classifications
2> Authorization: authorization string
3> Host: tms-api.baidu.com
4> x-bce-console-rpc-id: e69c8fff-166b-4c82-87c1-7aa3ba309d5c
5> x-bce-date: 2020-04-27T02:43:18Z
响应结果
Plain Text
1< Cache-Control: no-cache
2< Content-Length: 0
3< Date: Mon, 27 Apr 2020 11:48:34 GMT
4< Server: BWS
5< x-bce-request-id: de3f0c3e-86f6-43e7-b1bd-35a837f4b84f
6{
7 "result": [
8 {
9 "name": "化学制剂",
10 "code": "01",
11 "parentCode": "",
12 "level": 1,
13 "children": [
14 {
15 "name": "工业气体,单质",
16 "code": "0101",
17 "parentCode": "01",
18 "level": 2,
19 "children": [
20 {
21 "name": "碱土金属",
22 "code": "010039",
23 "parentCode": "0101",
24 "level": 3,
25 "children": null
26 },
27 {
28 "name": "氨",
29 "code": "010061",
30 "parentCode": "0101",
31 "level": 3,
32 "children": null
33 }...
响应头域
除公共头域外,无其它特殊头域。
响应参数
参数名称 | 类型 | 描述 | 子元素描述 |
---|---|---|---|
result | array | 结果集 | |
→ name | string | 小项名称 | |
→ code | string | 小项代码 | |
→ parentCode | string | 小项父类代码 | |
→ level | integer | 小项级别 | |
→ children | array | 小项子类 | |
→ name | string | 小项名称 | |
→ code | string | 小项代码 | |
→ parentCode | string | 小项父类代码 | |
→ level | integer | 小项级别 | |
→ children | array | 小项子类 |