调用BindAlias绑定别名。一次最多只能绑定10个别名,绑定别名之后立即生效。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String BindAlias

系统规定参数。取值:BindAlias

AppKey Long 23267207

AppKey信息。

DeviceId String e2ba19de97604f55b16557673****

设备在推送的唯一标识,32位,数字和小写字母组合。

AliasName String test_alias

需要绑定的别名。

一次最多只能绑定10个,多个Alias用逗号分隔,Alias最长128个字节(中文算三个字符),一个设备最多绑定128个别名,一个别名最多允许绑定128个设备。

返回数据

名称 类型 示例值 描述
RequestId String 159E4422-6624-4750-8943-DFD98D34858C

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=BindAlias
&AppKey=23267207
&DeviceId=e2ba19de97604f55b16557673****
&AliasName=test_alias
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<BindAliasResponse>
    <RequestId>159E4422-6624-4750-8943-DFD98D34858C</RequestId>
</BindAliasResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "159E4422-6624-4750-8943-DFD98D34858C"
}

错误码

HttpCode 错误码 错误信息 描述
400 Invalid%s.Format The specified %s format is invalid. 参数格式错误。
400 Invalid%s.BytesExceed The specified %s exceeds the %s bytes limit. 参数的字节数超限。
400 AccountDisabled Your account is not enabled. 功能未启用。
400 Invalid%s.NotFound The specified %s is not found. 参数错误,未找到。
500 InternalError The request processing has failed due to some unknown error. Please try again. If the error still exists, submit a ticket. 服务端错误,建议重试,仍然失败则提工单

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