创建APP
功能介绍
APP即应用,是一个可以访问API的身份标识。将API授权给APP后,APP即可调用API。
创建一个APP。
URI
HTTP/HTTPS请求方法以及URI如下表所示。
请求方法 |
URI |
---|---|
POST |
/v1/{project_id}/apigw/instances/{instance_id}/apps |
URI中的参数说明如下表所示。
名称 |
是否必选 |
类型 |
说明 |
---|---|---|---|
project_id |
是 |
String |
项目ID。可从控制台“我的凭证”中获取region下项目ID,管理员权限可查询。 |
instance_id |
是 |
String |
实例ID,可从API网关控制台的专享版实例信息中获取。 |
请求消息
参数 |
是否必选 |
类型 |
说明 |
---|---|---|---|
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" }
响应消息
参数 |
类型 |
说明 |
---|---|---|
id |
String |
编号 |
name |
String |
名称 |
status |
Integer |
状态 |
app_key |
String |
APP的key |
app_secret |
String |
密钥 |
creator |
String |
APP的创建者,取值如下:
|
register_time |
Timestamp |
创建时间 |
remark |
String |
描述 |
update_time |
Timestamp |
更新时间 |
app_type |
String |
APP类型,默认为apig |
响应消息样例:
{ "id": "14b3****37e9", "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" }
状态码
状态码 |
说明 |
---|---|
201 |
Created |
400 |
Bad Request |
401 |
Unauthorized |
403 |
Forbidden |
500 |
Server Internal Error |