更新时间:2024-01-19 GMT+08:00

创建APP

功能介绍

APP即应用,是一个可以访问API的身份标识。将API授权给APP后,APP即可调用API。

创建一个APP。

URI

HTTP/HTTPS请求方法以及URI如下表所示。

表1 HTTP/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