调用验证
详情参见 REST API 概述的 鉴权方式 说明。
频率控制
详情参见推送限制策略的 接口限制 说明。
个性化参数设置
调用地址
- POST http://api.push.mob.com/bind/customParam
推送对象
- 以 JSON 格式表达，表示一条推送相关的所有信息
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| appkey | string | 是 | 设备key |
| registrationId | string | 是 | 设备devicetoken |
| type | number | 是 | 1. 设置个性化参数 2. 删除个性化参数 3. 删除全部个性化参数 |
| customParam | object | 是 | 个性化参数 格式为map（k：v），type=1时会新增 type=2时会删除 type=3时可为空 |
请求示例
curl --location 'http://api.push.mob.com/bind/customParam' \
--header 'key: 2c574691c6986' \
--header 'sign: 87b67c59b24d4091b8f42ec0673c5155' \
--header 'Content-Type: application/json' \
--data '{"appkey":"2c574691c6986","registrationId":"65l1jjskqmppgcg","type":1,"customParam":{"person":"axddd"}}'
响应示例
- 请求成功
{"status": 200,"res": {"errCustomParams": {}},"error": null
}
- 请求失败
{"status": 5801,"res": null,"error": "数据校验失败"
}
- 响应参数
| 参数 | 类型 | 说明 |
|---|---|---|
| errCustomParams | object [] | 失败的自定义参数集合 |
| errCustomParams.key | string | 失败的参数 |
| errCustomParams.value | string | 失败的原因 |
| status | number | 200为成功 |
| error | string | 默认为空，rid校验未通过时错误信息会在这里 |
