# 创建工单
#### 功能介绍
用户在使用产品的过程中，遇到问题或者需要帮助时可以提交工单。
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/OSM/doc?api=CreateCases)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### URI
POST /v2/servicerequest/cases
#### 请求参数
表1请求Header参数 
| 参数                 | 是否必选 | 参数类型   | 描述                                                                                                                                                                                   |
|:---|:---|:---|:---|
| X-Auth-Token       | 是    | String | 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 最小长度：**1** 最大长度：**5000**          |
| X-Language         | 否    | String | 语言环境，值为通用的语言描述字符串，比如zh-cn等，默认为zh-cn。 会根据语言环境对应展示一些国际化的信息，比如工单类型名称等。 最小长度：**1** 最大长度：**32** |
| X-Time-Zone        | 否    | String | 环境时区，值为通用的时区描述字符串，比如GMT+8等，默认为GMT+8。 涉及时间的数据会根据环境时区处理。 最小长度：**1** 最大长度：**32**           |
| x-phone-verifiedid | 否    | String | 手机验证序列号id，如果选择非注册手机号提醒，如果是非注册联系方式则必填，通过"查询已验证的列表"接口查询获取 最小长度：**1** 最大长度：**32**                                          |
| x-email-verifiedid | 否    | String | 邮件验证序列号id，如果选择非注册邮箱提醒，如果是非注册联系方式则必填，通过"查询已验证的列表"接口查询获取 最小长度：**1** 最大长度：**32**                                            |
   
表2请求Body参数 
| 参数                         | 是否必选 | 参数类型                 | 描述                                                                                                                                                                  |
|:---|:---|:---|:---|
| incident_sub_type_id       | 否    | String               | 工单子类，通过"查询工单类目列表"接口获取 最小长度：**0** 最大长度：**32**                                                            |
| product_category_id        | 否    | String               | 工单产品类型，通过"查询工单类目列表"接口获取(如果该字段不传值，默认使用产品类型为"用户中心"b5f0be5c9639466184abf80e01f9fa1d) 最小长度：**0** 最大长度：**64** |
| business_type_id           | 是    | String               | 工单问题类型，通过"查询问题类型列表"接口获取 最小长度：**0** 最大长度：**512**                                                         |
| region_id                  | 否    | String               | 区域ID，根据business_type_id对应工单类型是5则必填，通过"查询问题类型列表"查看 最小长度：**0** 最大长度：**64**                               |
| simple_description         | 是    | String               | 问题描述 最小长度：**0** 最大长度：**2000**                                                                          |
| source_id                  | 是    | String               | 工单来源，当前固定为83aeb0f2834c4df49826c781d32a963e 最小长度：**0** 最大长度：**32**                                       |
| remind_mobile              | 否    | String               | 提醒手机号 最小长度：**0** 最大长度：**32**                                                                             |
| remind_mail                | 否    | String               | 提醒邮箱 最小长度：**0** 最大长度：**128**                                                                            |
| remind_time                | 否    | String               | 提醒时间 最小长度：**0** 最大长度：**16**                                                                             |
| project_id                 | 否    | String               | ProjectId 最小长度：**0** 最大长度：**64**                                                                          |
| accessory_ids              | 否    | Array of strings     | 附件id列表，"上传附件"接口返回的id 最小长度：**0** 最大长度：**100**                                                           |
| extends_map                | 否    | Map\<String,Object\> | 附加参数 数组范围：**0-100**（每个元素key值长度范围0-32）                                                                                                  |
| extension_map              | 否    | Map\<String,Object\> | 扩展参数 数组范围：**0-100**（每个元素key值长度范围0-32）                                                                                                  |
| severity_id                | 否    | String               | 严重性id，通过"查询问题严重性列表"接口获取 最小长度：**0** 最大长度：**64**                                                             |
| verify_code                | 否    | String               | 验证码，如果是非注册联系方式，需要通过"获取验证码"获取验证码 最小长度：**0** 最大长度：**6**                                                  |
| area_code                  | 否    | String               | 国家码 最小长度：**0** 最大长度：**32**                                                                             |
| incident_service_type      | 否    | String               | 服务类型，IncidentService：工单服务，IntelligentCustomerService：在线服务 最小长度：**0** 最大长度：**32**                          |
| session_ids                | 否    | Array                | 会话ID列表 数组范围：**0-5**，每个元素长度不超过64                                                                                                       |
| agreement_signed_record_id | 否    | Integer              | 协议签署记录id                                                                                                                                                            |
| ask_for_case_words         | 否    | String               | 用户大模型问答场景下触发转人工的话术，如果是点击按钮转人工, 则留空                                                                                                                                  |
| agent_code                 | 否    | String               | 在智能客服创建工单时传入，0原智能客服的CRMAgent, 1盘古助手Agent，2盘古助手Agent工单                                                                                                               |
   
#### 响应参数
**状态码： 200**
表3响应Body参数 
| 参数          | 参数类型   | 描述                                                                                      |
|:---|:---|:---|
| incident_id | String | 工单id 最小长度：**0** 最大长度：**64** |
   
#### 请求示例
```
POST https://{endpoint}/v2/servicerequest/cases
{
  "incident_sub_type_id" : "123",
  "product_category_id" : "123",
  "business_type_id" : "123",
  "region_id" : "cn-north-1",
  "simple_description" : "test",
  "source_id" : "123",
  "remind_mobile" : null,
  "remind_mail" : null,
  "remind_time" : "9:00-18:00",
  "project_id" : null,
  "accessory_ids" : [ ],
  "extends_map" : [ ],
  "extension_map" : [ ],
  "severity_id" : "123",
  "verify_code" : null,
  "area_code" : 86
}
```
#### 响应示例
**状态码： 200**
成功返回工单号
```
{
  "incident_id" : "123"
}
```
#### 状态码
| 状态码 | 描述      |
|:---|:---|
| 200 | 成功返回工单号 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-ticket/ErrorCode.html)。