申请人相关接口

更新时间：2023-12-04

新增申请人

接口描述

本接口用于新增申请人

请求结构

> POST https://tms-api.baidu.com/v1/tms/openapi/applicants
> 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
{
    "type": "Enterprise",
    "region": "Mainland",
    "address": "北京市海淀区上地十街10号百度大厦三层",
    "name": "百度在线网络技术（北京）有限公司",
    "province": 110000,
    "contactName": "王小明",
    "contactNumber": "010-59928888",
    "contactAddress": "北京北京市海淀区上地十街10号百度大厦三层",
    "contactPostcode": "100085",
    "businessLicensePic": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD...",
    "loaPic": "data:image/jpeg;base64,/9j/4DEFDFDADSDSDSDDS...",
    "englishAddress": "",
    "contactEmail": "baidu@baidu.com",
    "idCardPic": "data:image/jpeg;base64,/9j/UDFYUDJDKFJDKF...",
    "englishBusinessLicensePic": "",
    "cardName": "",
    "englishName": "",
    "resourcePackId": "",
    "englishIdCardPic": "data:image/jpeg;base64,/9j/DKFJDUIUEIFJFD...",
    "country": "中国",
    "creditCode": "91110108717743469K",
    "loaReusePic": "",
    "idCard": ""
}

参数名称	类型	是否必需	参数位置	描述
type	string	必需	BODY	申请人类型可参考附录 ApplicantType
region	string	必需	BODY	申请人地域, 可参考附录 ApplicantRegion
englishName	string	可选	BODY	申请人英文名称
country	string	可选	BODY	申请人所在国家, 默认为中国, 当地域选择国外时，可以选择多个国家，可参考附录 ApplicantCountry
englishAddress	string	可选	BODY	申请人英文地址
idCard	string	可选	BODY	申请人身份证号码, 个人和个体工商户必填
creditCode	string	可选	BODY	申请人社会信用代码, 企业和个体工商户必填
address	string	必需	BODY	申请人地址
name	string	必需	BODY	申请人名称
province	integer	必需	BODY	申请人所在省份代码, 可参考附录 ApplicantProvince
contactName	string	必需	BODY	联系人姓名
contactNumber	string	必需	BODY	联系人电话
contactEmail	string	可选	BODY	联系人邮箱
contactAddress	string	必需	BODY	联系人地址
contactPostcode	string	必需	BODY	联系人邮编
idCardPic	string	可选	BODY	个人申请身份证图片Base64字符串, 个人和个体工商户必填，图片格式必须为jpg/jpeg，开头为 `data:image/jpeg;`、`data:image/jpg;`
englishIdCardPic	string	可选	BODY	个人英文申请身份证图片Base64字符串，图片格式必须为jpg/jpeg，开头为 `data:image/jpeg;`、`data:image/jpg;`
businessLicensePic	string	必需	BODY	营业执照副本复印件图片Base64字符串，图片格式必须为jpg/jpeg，开头为 `data:image/jpeg;`、`data:image/jpg;`
englishBusinessLicensePic	string	可选	BODY	英文营业执照副本复印件图片Base64字符串，图片格式必须为jpg/jpeg，开头为 `data:image/jpeg;`、`data:image/jpg;`
loaPic	string	必需	BODY	委托书图片Base64字符串，图片格式必须为jpg/jpeg，开头为 `data:image/jpeg;`、`data:image/jpg;`
loaReusePic	string	可选	BODY	委托书复用法律申明图片Base64字符串，图片格式必须为jpg/jpeg，开头为 `data:image/jpeg;`、`data:image/jpg;`
resourcePackId	string	可选	BODY	资源包ID，如您的申请人申请的商标需要使用资源包进行支付，此处必需要填写资源包ID，否则使用资源包申请商标填写此申请人时不可用
cardName	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
{
    "applicantId" : "TAP-ddB5evmM5dG"
}

响应头域

除公共头域外，无其它特殊头域。

响应参数

参数名称	类型	描述
applicantId	string	申请人id

更新申请人信息

接口描述

本接口用于更新申请人信息

请求结构

> PUT https://tms-api.baidu.com/v1/tms/openapi/applicants/TAP-ddB5evmM5dG
> 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
{
    "type": "Enterprise",
    "region": "Mainland",
    "address": "北京市海淀区上地十街10号百度大厦三层",
    "name": "百度在线网络技术（北京）有限公司",
    "province": 110000,
    "contactName": "王小虎",
    "contactNumber": "010-59928888",
    "contactAddress": "北京北京市海淀区上地十街10号百度大厦三层",
    "contactPostcode": "100085",
    "businessLicensePic": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD...",
    "loaPic": "data:image/jpeg;base64,/9j/4DEFDFDADSDSDSDDS...",
    "englishAddress": "",
    "contactEmail": "baidu@baidu.com",
    "idCardPic": "data:image/jpeg;base64,/9j/UDFYUDJDKFJDKF...",
    "englishBusinessLicensePic": "",
    "cardName": "",
    "englishName": "",
    "resourcePackId": "",
    "englishIdCardPic": "data:image/jpeg;base64,/9j/DKFJDUIUEIFJFD...",
    "country": "中国",
    "creditCode": "91110108717743469K",
    "loaReusePic": "",
    "idCard": ""
}

参数名称	类型	是否必需	参数位置	描述
type	string	必需	BODY	申请人类型可参考附录 ApplicantType
region	string	必需	BODY	申请人地域可参考附录 ApplicantRegion
englishName	string	可选	BODY	申请人英文名称
country	string	可选	BODY	申请人所在国家, 默认为中国, 当地域选择国外时，可以选择多个国家，可参考附录 ApplicantCountry
englishAddress	string	可选	BODY	申请人英文地址
idCard	string	可选	BODY	申请人身份证号码, 个人和个体工商户必填
creditCode	string	可选	BODY	申请人社会信用代码, 企业和个体工商户必填
address	string	必需	BODY	申请人地址
name	string	必需	BODY	申请人名称
province	integer	必需	BODY	申请人所在省份代码可参考附录 ApplicantProvince
contactName	string	必需	BODY	联系人姓名
contactNumber	string	必需	BODY	联系人电话
contactEmail	string	可选	BODY	联系人邮箱
contactAddress	string	必需	BODY	联系人地址
contactPostcode	string	必需	BODY	联系人邮编
idCardPic	string	可选	BODY	个人申请身份证图片Base64字符串, 个人和个体工商户必填，图片格式必须为jpg/jpeg，开头为 `data:image/jpeg;`、`data:image/jpg;`
englishIdCardPic	string	可选	BODY	个人英文申请身份证图片Base64字符串，图片格式必须为jpg/jpeg，开头为 `data:image/jpeg;`、`data:image/jpg;`
businessLicensePic	string	必需	BODY	营业执照副本复印件图片Base64字符串，图片格式必须为jpg/jpeg，开头为 `data:image/jpeg;`、`data:image/jpg;`
englishBusinessLicensePic	string	可选	BODY	英文营业执照副本复印件图片Base64字符串，图片格式必须为jpg/jpeg，开头为 `data:image/jpeg;`、`data:image/jpg;`
loaPic	string	必需	BODY	委托书图片Base64字符串，图片格式必须为jpg/jpeg，开头为 `data:image/jpeg;`、`data:image/jpg;`
loaReusePic	string	可选	BODY	委托书复用法律申明图片Base64字符串，图片格式必须为jpg/jpeg，开头为 `data:image/jpeg;`、`data:image/jpg;`
resourcePackId	string	可选	BODY	资源包ID，如您的申请人申请的商标需要使用资源包进行支付，此处必需要填写资源包ID，否则使用资源包申请商标填写此申请人时不可用
cardName	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
    {
        "result" : true
    }

响应头域

除公共头域外，无其它特殊头域。

响应参数

参数名称	类型	描述
result	boolean	true-成功 false-失败

获取申请人详情

接口描述

本接口用于获取申请人详情

请求结构

> GET https://tms-api.baidu.com/v1/tms/openapi/applicants/TAP-ddB5evmM5dG
> 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

参数名称	类型	是否必需	参数位置	描述
applicantId	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
{
    "applicantId": "TAP-ddB5evmM5dG",
    "type": "Enterprise",
    "region": "Mainland",
    "name": "百度在线网络技术（北京）有限公司",
    "country": "中国",
    "province": 110000,
    "address": "北京市海淀区上地十街10号百度大厦三层",
    "englishName": "",
    "englishAddress": "",
    "idCard": "",
    "creditCode": "91110108717743469K",
    "idCardUrl": "",
    "englishIdCardUrl": "",
    "businessLicenseUrl": "https://bj.bcebos.com/v1/tms-custom/xxxx",
    "englishBusinessLicenseUrl": "",
    "loaUrl": "https://bj.bcebos.com/v1/tms-custom/xxxx",
    "loaReuseUrl": "https://bj.bcebos.com/v1/xxxx",
    "contactName": "王小虎",
    "contactNumber": "010-59928888",
    "contactEmail": "baidu@baidu.com",
    "contactAddress": "北京北京市海淀区上地十街10号百度大厦三层",
    "contactPostcode": "100085",
    "status": "PASS",
    "statusInfo": "",
    "createTime": "2023-09-19T13:29:25Z",
    "updateTime": "2023-09-20T06:02:01Z"
}

响应头域

除公共头域外，无其它特殊头域。

响应参数

参数名称	类型	描述
applicantId	string	申请人id
type	string	申请人类型可参考附录 ApplicantType
region	string	申请人地域可参考附录 ApplicantRegion
name	string	申请人名称
country	string	申请人所在国家可参考附录 ApplicantCountry
province	integer	申请人所在省份可参考附录 ApplicantProvince
address	string	申请人地址
englishName	string	申请人英文名称
englishAddress	string	申请人英文地址
idCard	string	申请人证件号码
creditCode	string	申请人社会信用代码
idCardUrl	string	申请人身份证图片url，30分钟有效时间
englishIdCardUrl	string	申请人英文身份证图片url，30分钟有效时间
businessLicenseUrl	string	营业执照副本复印件图片url，30分钟有效时间
englishBusinessLicenseUrl	string	申请人英文营业执照url，30分钟有效时间
loaUrl	string	委托书图片url，30分钟有效时间
loaReuseUrl	string	委托书复用申明图片url，30分钟有效时间
contactName	string	联系人姓名
contactNumber	string	联系人电话
contactEmail	string	联系人邮箱
contactAddress	string	联系人地址
contactPostcode	string	联系人邮编
status	string	申请人状态，可参考附录 ApplicantStatus
statusInfo	string	申请人审核信息
createTime	string	申请人创建时间
updateTime	string	申请人更新时间

获取申请人列表

接口描述

本接口用于获取申请人详情

请求结构

> POST https://tms-api.baidu.com/v1/tms/openapi/applicants/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
{
    "pageNo" : 1,
    "pageSize" : 10,
    "keyword" : "",
    "type" : "Enterprise",
    "region" : "Mainland",
    "status" : "NO_PASS",
    "order" : "",
    "orderBy" : "",
    "keywordType" : "",
    "resourcePackId" : ""
}

参数名称	类型	是否必需	参数位置	描述
pageNo	integer	可选	BODY	页码从1开始默认为1
pageSize	integer	可选	BODY	页大小默认为10
keyword	string	可选	BODY	申请人名称关键字
type	string	可选	BODY	申请人类型，不能为空字符串，如不筛选可将填写`null` 可参考附录 ApplicantType
region	string	可选	BODY	申请人地域，不能为空字符串，如不筛选可将填写`null` 可参考附录 ApplicantRegion
status	string	可选	BODY	申请人状态，不能为空字符串，如不筛选可将填写`null` 可参考附录 ApplicantStatus
order	string	可选	BODY	排序方式 `asc`或`desc` 默认为`desc`
orderBy	string	可选	BODY	排序列默认为`createTime`
keywordType	string	可选	BODY	关键字选择列目前仅支持申请人名称`name`
resourcePackId	string	可选	BODY	资源包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
{
    "pageNo": 1,
    "pageSize": 10,
    "totalCount": 1,
    "result": [
        {
            "applicantId": "TAP-ddB5evmM5dG",
            "type": "Enterprise",
            "region": "Mainland",
            "name": "百度在线网络技术（北京）有限公司",
            "country": "",
            "contactName": "王小虎",
            "contactEmail": "baidu@baidu.com",
            "status": "NO_PASS",
            "auditInfo": "请填写正确的申请人资料",
            "idCard": "",
            "creditCode": "91110108717743469K"
        }
    ]
}

参数名称	类型	描述
pageNo	integer	页码
pageSize	integer	页大小
totalCount	integer	总数量
result	array	申请人列表
→ applicantId	string	申请人id
→ type	string	申请人类型可参考附录 ApplicantType
→ region	string	申请人地域可参考附录 ApplicantRegion
→ name	string	申请人姓名
→ country	string	申请人国家
→ contactName	string	联系人姓名
→ contactEmail	string	联系人邮箱
→ status	string	申请人状态，可参考附录 ApplicantStatus
→ auditInfo	string	审核信息
→ idCard	string	申请人身份证号码
→ creditCode	string	申请人企业信用代码

删除申请人

接口描述

本接口用于删除申请人

请求结构

> DELETE https://tms-api.baidu.com/v1/tms/openapi/applicants/TAP-ddB5evmM5dG
> 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

参数名称	类型	是否必需	参数位置	描述
applicantId	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-失败

错误码

商标相关接口

百度智能云

商标知产服务 TMS

商标知产服务 TMS

申请人相关接口

新增申请人

更新申请人信息

获取申请人详情

获取申请人列表

删除申请人