调用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. | 服务端错误,建议重试,仍然失败则提工单 |
访问错误中心查看更多错误码。