
# 创建商标申请
#### 功能介绍
创建智能商标注册申请。
在华为云商标注册服务创建一个智能注册商标的申请。
#### 接口约束
该接口调用前需要按照参数列表准备相关参数，部分参数需要依赖其他接口获得，如商标类别，委托书模板等，请参考对应接口指导进行操作。
#### URI
POST /v1/trademark-application
表1请求Header参数说明 
| 参数             | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                            |
|:---|:---|:---|:---|
| X-Auth-Token   | 是    | String | 用户IAM Token信息，参考[认证鉴权](https://support.huaweicloud.com/api-trademark/trademark_0302.html)章节获得。                                                                                                                                |
| X-Client-Token | 是    | String | - 幂等性参数，用户自定义。  - 取值范围16\~36，允许大小写字母、数字、下划线、连接符。   |
   
表2请求body参数说明 
| 参数                                        | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
|:---|:---|:---|:---|
| logo                                      | 否    | File   | - 商标图样文件。  - 非必传，在商标类型为文字商标时不传的情况下系统自动按照商标内容生成图样；其他情况下需要上传。  - 商标图样应为200KB以内的JPG格式图片，分辨率为400\*400-1500\*1500。                                                                                                                                                                                             |
| id_card                                   | 否    | File   | - 证件照片。 - 大陆场景下为身份证  - 其他场景下为护照    - 非必传，在申请人资质为企业的场景下无需上传。  - 上传证件图片分辨率在1000\*1000-5000\*5000之间；大小不超过1MB的JPG/PNG/JPEG格式图片。   |
| business_license                          | 否    | File   | - 营业执照。  - 非必传，在申请人资质为个人/个体户的场景下无需上传。  - 上传证件图片分辨率在1000\*1000-5000\*5000之间；大小不超过1MB的JPG/PNG/JPEG格式图片。                                                                                                                                                                                             |
| attorney_letter                           | 是    | File   | - 委托书文件。  - 需要通过委托书下载接口下载并盖章（企业）或签字（个人）后拍照。  - 上传委托书模板图片分辨率在600\*600-4000\*4000之间；上传委托书模板图片大小不能超过2MB的JPG格式图片；上传委托书模板公章清晰完整；纸面工整顺平，不能有褶皱、反光等。  - 申请人地址修改后委托书文件需重新下载并上传。                                                          |
| translation_document                      | 否    | File   | - 翻译件文件。  - 当为海外英语场景下，需要提供证件翻译件。                                                                                                                                                                                                                                                                                                                                          |
| legal_statement_document                  | 是    | File   | - 委托书复用法律声明文件。  - 通过委托书下载接口获得。                                                                                                                                                                                                                                                                                                                                                  |
| create_trademark_application_request_body | 是    | String | - 创建商标申请请求体，包含创建商标的基本信息。  - 按照**[表3]**整理成Json字符串。                                                                                                                                                                                                                                                                                     |
   
 表3create_trademark_application_request_body参数说明 
| 参数        | 是否必选 | 参数类型                                                              | 描述     |
|:---|:---|:---|:---|
| trademark | 是    | [trademarkInfoParam] object | 商标信息。  |
| applicant | 是    | [applicantInfoParam] object | 申请人信息。 |
   
 表4trademarkInfoParam 
| 参数            | 是否必选 | 参数类型                                                                         | 描述                                                                                                                                                                                                                                                                                                                                                   |
|:---|:---|:---|:---|
| name          | 否    | String                                                                       | 商标名称，纯图形商标时非必传。                                                                                                                                                                                                                                                                                                                                      |
| type          | 是    | Integer                                                                      | 商标类型。 取值范围： - 1：文字商标  - 2：图形商标  - 3：文字及图形商标   |
| has_color     | 是    | Integer                                                                      | 商标标样颜色。 取值范围： - 0：黑白标样  - 1：彩色标样                                                                                 |
| category_list | 是    | Array of [trademarkCategoryInfo] object | 商标分类列表，调用查询商标类别接口获得。                                                                                                                                                                                                                                                                                                                                 |
| remark        | 是    | String                                                                       | 对商标的说明。                                                                                                                                                                                                                                                                                                                                              |
   
 表5trademarkCategoryInfo 
| 参数                       | 是否必选 | 参数类型                                                                      | 描述        |
|:---|:---|:---|:---|
| category_sequence_number | 是    | String                                                                    | 注册类别大类编号。 |
| category_name            | 是    | String                                                                    | 注册类别大类名称。 |
| items                    | 是    | Array of [trademarkItemInfo] object | 商标小项分类。   |
   
 表6trademarkItemInfo 
| 参数         | 是否必选 | 参数类型   | 描述    |
|:---|:---|:---|:---|
| code       | 是    | String | 小项编号。 |
| name       | 是    | String | 小项名称。 |
| group_code | 是    | String | 群组编号。 |
   
 表7applicantInfoParam 
| 参数                   | 是否必选 | 参数类型                                                      | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
|:---|:---|:---|:---|
| type                 | 是    | Integer                                                   | 申请人类别。 取值范围： - 1：企业/其他组织  - 2：自然人                                                                                                                                                                                                                                             |
| country_type         | 是    | Integer                                                   | 申请人国家类型。 取值范围： - 1：中国大陆  - 2：中国香港  - 3：中国澳门  - 4：中国台湾  - 5：海外   |
| country_code         | 否    | String                                                    | 国家编码。 地区为海外时必填，参考[国家码对照表](https://support.huaweicloud.com/api-trademark/trademark_0503.html)。                                                                                                                                                                                                                                                                                                                                                                                           |
| name_cn              | 是    | String                                                    | 申请人中文姓名。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| name_en              | 否    | String                                                    | 申请人英文姓名，海外场景下必传。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| province_cn          | 否    | String                                                    | 申请人中文省份名称，大陆场景下必传。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| province_en          | 否    | String                                                    | 申请人英文省份名称，大陆场景下必传。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| address_cn           | 否    | String                                                    | 申请人中文地址。 - 大陆场景去除证件地址中的省份或直辖市信息后的地址。  - 其他场景地址与证件一致。                                                                                                                                                                                                                                                          |
| address_en           | 否    | String                                                    | - 申请人英文地址，海外场景下必填。                                                                                                                                                                                                                                                                                                                                                                                                   |
| card_type            | 否    | Integer                                                   | - 申请人证件类型（1：身份证 2：护照），非必传，个人/个体户场景下需。                                                                                                                                                                                                                                                                                                                                                                               |
| card_id              | 否    | String                                                    | - 申请人证件号码，非必传，个人/个体户场景下需要。                                                                                                                                                                                                                                                                                                                                                                                       |
| credit_code          | 否    | String                                                    | 统一社会信用代码，非必传，企业场景下需要。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| certificate_language | 否    | String                                                    | 证件语种，海外场景下需要，参考[附表2翻译件支持语种集合](https://support.huaweicloud.com/api-trademark/trademark_0504.html)。                                                                                                                                                                                                                                                                                                                                                                                                                        |
| name_foreign         | 否    | String                                                    | 非中文、英文场景下对应语种的外文姓名。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| address_foreign      | 否    | String                                                    | 非中文、英文场景下对应语种的外文地址。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| contact_info         | 是    | [contactInfo] object | 联系人信息。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
   
 表8contactInfo 
| 参数           | 是否必选 | 参数类型   | 描述       |
|:---|:---|:---|:---|
| name         | 是    | String | 联系人姓名。   |
| phone_number | 是    | String | 联系人电话。   |
| email        | 是    | String | 联系人邮箱。   |
| address      | 是    | String | 联系人地址。   |
| postcode     | 是    | String | 联系人邮政编码。 |
   
#### 响应参数
表9请求响应参数说明 
| 参数              | 参数类型             | 描述      |
|:---|:---|:---|
| application_ids | Array of strings | 申请单号列表。 |
   
#### 请求示例
在华为云创建一个商标智能注册申请
```
POST https://{Endpoint}//v1/trademark-application
{
"trademark": {
"name": "样例",
"type": 1,
"has_color": 0,
"remark": "该商标由“样例”构成",
"category_list": [{
"category_sequence_number": "8",
"category_name": "08类 手工器械",
"items": [{
"code": "080002",
"name": "磨具（手工具）",
"group_code": "0801"
}]
}]
},
"applicant": {
"name_cn": "张三",
"name_en": "张三",
"type": 1,
"country_type": 1,
"credit_code": "100000000000000",
"contact_info": {
"name": "张三",
"phone_number": "18100000000",
"email": "test@163.com",
"address": "陕西省西安市雁塔区",
"postcode": "710000"
},
"address_cn": "西安市雁塔区",
"address_en": "xi an shi yan ta qu",
"province_cn": "陕西省",
"province_en": "Shaanxi"
}
}
```
#### 响应示例
```
{
"application_ids": ["CS23011416262F0J2"]
}
```
#### 错误码
错误码请参见[错误码](https://support.huaweicloud.com/api-trademark/trademark_0502.html)。
