# 创建APP
#### 功能介绍
APP即应用，是一个可以访问API的身份标识。将API授权给APP后，APP即可调用API。
创建一个APP。
#### URI
HTTP/HTTPS请求方法以及URI如下表所示。
表1HTTP/HTTPS请求方法以及URI 
| 请求方法 | URI              |
|:---|:---|
| POST | /v1.0/apigw/apps |
   
#### 请求消息
表2参数说明 
| 参数         | 是否必选 | 类型     | 说明                                                                                                                                                                                                                                                                        |
|:---|:---|:---|:---|
| name       | 是    | String | APP的名称 支持汉字，英文，数字，"_"，且只能以英文和汉字开头，3 \~ 64个字符。 说明： 中文字符必须为UTF-8或者unicode编码。                       |
| remark     | 否    | String | APP描述。 字符长度不能大于255 说明： 中文字符必须为UTF-8或者unicode编码。                                                  |
| app_key    | 否    | String | APP的key 支持英文，数字，"_","-",且只能以英文或数字开头，8 \~ 64个字符。 说明： 只支持部分region自定义。                     |
| app_secret | 否    | String | 密钥 支持英文，数字，"_","-","_","!","@","#","$","%",且只能以英文或数字开头，8 \~ 64个字符。 说明： 只支持部分region自定义。 |
   
请求消息样例：
```
{
  "name": "app_001",
  "remark": "first app",
  "app_key": "app_key_sample",
  "app_secret": "app_secret_sample"
}
```
#### 响应消息
表3参数说明 
| 参数            | 类型        | 说明                                                                                                                                                                                                                                                                                                                                                                                                                     |
|:---|:---|:---|
| id            | String    | 编号                                                                                                                                                                                                                                                                                                                                                                                                                     |
| name          | String    | 名称                                                                                                                                                                                                                                                                                                                                                                                                                     |
| status        | Integer   | 状态                                                                                                                                                                                                                                                                                                                                                                                                                     |
| app_key       | String    | APP的key                                                                                                                                                                                                                                                                                                                                                                                                                |
| app_secret    | String    | 密钥                                                                                                                                                                                                                                                                                                                                                                                                                     |
| creator       | String    | APP的创建者，取值如下： - USER：用户自行创建  - MARKET：云商店分配   |
| register_time | Timestamp | 创建时间                                                                                                                                                                                                                                                                                                                                                                                                                   |
| remark        | String    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                     |
| update_time   | Timestamp | 更新时间                                                                                                                                                                                                                                                                                                                                                                                                                   |
| app_type      | String    | APP类型，默认为apig                                                                                                                                                                                                                                                                                                                                                                                                          |
   
响应消息样例：
```
{
"id": "14b3****537e9",
"name": "app_001",
"status": 1,
"app_key": "d49b1****376eb",
"app_secret": "******",
"creator": "USER",
"remark": "第一个应用",
"register_time": "2017-12-28T12:26:54.2345858Z",
"update_time": "2017-12-28T12:26:54.2345858Z",
        "app_type": "apig"
}
```
#### 状态码
表4返回消息说明 
| 状态码 | 说明                    |
|:---|:---|
| 201 | Created               |
| 400 | Bad Request           |
| 401 | Unauthorized          |
| 403 | Forbidden             |
| 500 | Server Internal Error |