wiki:doc/interface/platform

Version 18 (modified by wangjianqiang, 14 years ago) (diff)

--

平台接口设计

设备注册接口

接口地址:

  http://pns.imofan.com/receiver/register

接口请求参数定义:

参数名说明
appkey应用的唯一标识id,由魔方系统生成

注意:

  • 参数必须用POST方式提交

接口响应JSON格式定义:

  {
    "stat": 1,
    "udid": "f432e552242535353",
    "pwd":  "12345678",
    "info": "注册失败时的额外信息"
  }

返回值定义:

返回值说明
stat取值为:1 注册成功,0 已注册过,-1 注册失败
udid推送平台分配给该设备的唯一标识,登录推送平台时作为用户名使用,仅当stat==-1时,返回值为
pwd客户端登录推送平台时的密码
info包含额外的说明信息,用于stat为-1时平台所给的错误提示

获取推送Token接口

接口地址:

  http://pns.imofan.com/app/token

接口请求参数定义:

参数名说明
appkey应用的唯一标识id,由魔方系统生成
udid推送平台分配给该设备的唯一标识
pwd客户端登录推送平台时的密码

注意:

  • 参数必须用POST方式提交

接口响应JSON格式定义:

  {
    "stat": 1,
    "token": "64tru67554fdwe12d",
    "info": "分配token失败时的额外信息"
  }

返回值定义:

返回值说明
stat取值为:1 Toekn分配成功,-1 分配失败
token推送平台分配给该客户端的推送Token,仅当stat==-1时,返回值为
info包含额外的说明信息,用于stat为-1时平台所给的错误提示

消息推送接口

接口地址:

  http://pns.imofan.com/sender/push

接口请求参数定义:

参数名说明
appkey应用的唯一标识id,由魔方系统生成
token推送平台分配给该客户端的推送Token
message要推送的消息

注意:

  • 参数必须用POST方式提交

接口响应JSON格式定义:

  {
    "stat": 1,
    "info": "分配token失败时的额外信息"
  }

返回值定义:

返回值说明
stat取值为:1 推送成功,0 延迟推送(设备不在线),-1 推送失败,-2 Token已失效
info包含额外的说明信息,用于stat为-1时平台所给的错误提示