CreateApplication - 访问控制

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数


名称	类型	是否必选	示例值	描述
Action	String	是	CreateApplication	要执行的操作。取值：CreateApplication。
AppType	String	是	WebApp	应用类型。取值： WebApp：指基于浏览器交互的网络应用。 NativeApp：指操作系统中运行的本地应用，主要为运行在桌面操作系统或移动操作系统中的应用。 ServerApp：指直接访问阿里云服务，而无需依赖用户登录的应用，目前仅支持基于SCIM协议的用户同步应用。
DisplayName	String	是	myapp	应用的显示名称。最大长度为24个字符。
AppName	String	是	myapp	应用名称。最大长度为64 个字符，允许输入英文字母、数字、英文句点（.）、下划线（_）或中划线（-）。
SecretRequired	Boolean	否	true	是否需要应用密钥。取值： true false 说明对于WebApp和ServerApp类型的应用，该值会被强制设置为true，不支持修改。对于NativeApp类型的应用，可以设置为true或false，如不设置，默认为false。由于此类应用往往运行在非可信环境，无法有效保护应用密钥，因此建议您如无明确需要，不要设置为true。更多信息，请参见Native应用登录阿里云。
AccessTokenValidity	Integer	否	3600	访问令牌有效期。取值范围：900~10800。单位：秒。默认值：3600。
RefreshTokenValidity	Integer	否	2592000	刷新令牌有效期。取值范围：7200~31536000。单位：秒。默认值：对于NativeApp和ServerApp类型的应用，如果该值为空，则默认为2592000秒（即30天）。对于WebApp类型的应用，如果该值为空，则默认为7776000秒（即90天）。
PredefinedScopes	String	否	aliuid	应用权限范围。关于应用权限范围的取值和描述，请参见OAuth范围。您也可以调用ListPredefinedScopes获取不同应用类型支持的应用权限范围。输入多个应用权限范围时，以英文分号（;）分隔。
IsMultiTenant	Boolean	否	false	是否允许被其他账号安装。取值： true：对于NativeApp和ServerApp类型的应用，如果该值为空，则默认为true。 false：对于WebApp类型的应用，如果该值为空，则默认为false。
RedirectUris	String	否	https://www.example.com	回调地址。输入多个时，以英文分号（;）分隔。

返回数据


名称	类型	示例值	描述
Application	Struct		应用信息。
AccessTokenValidity	Integer	3600	访问令牌有效期。单位：秒。
AccountId	String	177242285274****	应用所属的阿里云账号ID。
AppId	String	472457090344041****	应用ID。
AppName	String	myapp	应用名称。
AppType	String	WebApp	应用类型。
CreateDate	String	2020-10-23T08:06:57Z	创建时间。
DelegatedScope	Struct		应用权限范围信息。
PredefinedScopes	Array of PredefinedScope		应用权限范围信息。
PredefinedScope
Description	String	用于获取用户的OpenID（默认权限范围，不可移除）	范围描述。
Name	String	openid	范围名称。
DisplayName	String	myapp	应用的显示名称。
IsMultiTenant	Boolean	true	是否允许被其他账号安装。
RedirectUris	List	https://www.example.com	回调地址。
RefreshTokenValidity	Integer	7776000	刷新令牌有效期。单位：秒。
SecretRequired	Boolean	true	是否需要应用密钥。
UpdateDate	String	2020-10-23T08:06:57Z	更新时间。
RequestId	String	6616F09B-2768-4C11-8866-A8EE4C4A583E	请求ID。

示例

请求示例

https://[Endpoint]/?Action=CreateApplication
&AppType=WebApp
&AppName=myapp
&DisplayName=myapp
&<公共请求参数>

正常返回示例

XML 格式

<CreateApplicationResponse>
	  <RequestId>6616F09B-2768-4C11-8866-A8EE4C4A583E</RequestId>
	  <Application>
		    <AccountId>177242285274****</AccountId>
		    <SecretRequired>true</SecretRequired>
		    <IsMultiTenant>true</IsMultiTenant>
		    <CreateDate>2020-10-23T08:06:57Z</CreateDate>
		    <AppName>myapp</AppName>
		    <UpdateDate>2020-10-23T08:06:57Z</UpdateDate>
		    <DelegatedScope>
			      <PredefinedScopes>
				        <PredefinedScope>
					          <Description>用于获取用户的OpenID（默认权限范围，不可移除）</Description>
					          <Name>openid</Name>
				        </PredefinedScope>
			      </PredefinedScopes>
		    </DelegatedScope>
		    <AppId>472457090344041****</AppId>
		    <DisplayName>myapp</DisplayName>
		    <AccessTokenValidity>3600</AccessTokenValidity>
		    <RedirectUris>
			      <RedirectUri>https://www.example.com</RedirectUri>
		    </RedirectUris>
		    <RefreshTokenValidity>7776000</RefreshTokenValidity>
		    <AppType>WebApp</AppType>
	  </Application>
</CreateApplicationResponse>

JSON 格式

{
  "RequestId": "6616F09B-2768-4C11-8866-A8EE4C4A583E",
  "Application": {
    "AccountId": "177242285274****",
    "SecretRequired": true,
    "IsMultiTenant": true,
    "CreateDate": "2020-10-23T08:06:57Z",
    "AppName": "myapp",
    "UpdateDate": "2020-10-23T08:06:57Z",
    "DelegatedScope": {
      "PredefinedScopes": {
        "PredefinedScope": [
          {
            "Description": "用于获取用户的OpenID（默认权限范围，不可移除）",
            "Name": "openid"
          }
        ]
      }
    },
    "AppId": "472457090344041****",
    "DisplayName": "myapp",
    "AccessTokenValidity": 3600,
    "RedirectUris": {
      "RedirectUri": [
        "https://www.example.com"
      ]
    },
    "RefreshTokenValidity": 7776000,
    "AppType": "WebApp"
  }
}

错误码

访问错误中心查看更多错误码。