= 平台接口设计 =

== 设备注册接口 ==

接口地址：
{{{
  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 推送成功，-1 推送失败||
||info||包含额外的说明信息，用于stat为-1时平台所给的错误提示||