Creating an App

Function

This API is used to create an app. An app is an identity for accessing an API. An app can call the APIs to which it has been authorized.

URI

The following table lists the HTTP/HTTPS request method and URI of the API.

**Table 1** HTTP/HTTPS request method and URI
Request Method	URI
POST	/v1.0/apigw/apps

Request

**Table 2** Parameter description
Parameter	Mandatory	Type	Description
name	Yes	String	App name An app name consists of 3–64 characters, starting with a letter. Only letters, digits, and underscores (_) are allowed.
remark	No	String	Description of the app The description cannot exceed 255 characters.
app_key	No	String	AppKey An AppKey consists of 8–64 characters, starting with a letter or digit. Only letters, digits, underscores (_), and hyphens (-) are allowed. NOTE: This parameter is available in some regions.
app_secret	No	String	AppSecret An AppSecret consists of 8–64 characters, starting with a letter or digit. Only letters, digits, and the following special characters are allowed: _-!@#$% NOTE: This parameter is available in some regions.

Example request:

{
  "name": "app_001",
  "remark": "first app",
  "app_key": "app_key_sample",
  "app_secret": "app_secret_sample"
}

Response

**Table 3** Parameter description
Parameter	Type	Description
id	String	App ID
name	String	App name
status	Integer	App status
app_key	String	AppKey
app_secret	String	AppSecret
creator	String	App creator, which can be: USER: The app is created by the API user. MARKET: The app is allocated by the marketplace.
register_time	Timestamp	Time when the app is registered
remark	String	Description of the app
update_time	Timestamp	Time when the app was last updated
app_type	String	App type. The default value is apig.

Example response:

{
	"id": "14b399ac-967f-4115-bb62-c0346b4537e9",
	"name": "app_001",
	"status": 1,
	"app_key": "d49b1cbf-cc81-4a5f-b2a0-61b568e376eb",
	"app_secret": "******",
	"creator": "USER",
	"remark": "First app"
	"register_time": "2017-12-28T12:26:54.2345858Z",
	"update_time": "2017-12-28T12:26:54.2345858Z",
        "app_type": "apig"
}