热拍API接口文档

电商类的消息信息不存在非常强的实时性，为了避免驻留后台进程，被360手机卫士、腾讯手机管家等杀掉或在后台驻留排行榜中列出，不采取驻留后台进程维持长连接的方式，而是采用闹钟定时（间隔30分钟）唤醒后台进程，通过本接口获取属于该用户的推送信息，并显示在手机通知栏，之后自动关闭后台进程自身（不驻留后台）。

<?php
require_once("/Data/webapps/m.repai.com/m/phpapi.php"); //PHP引用方式，需要引用的框架入口文件
$parameters_array["appkey"] = "100005";
$parameters_array["appoid"] = "d19149dd97b17ce55e70abd2f9e64d3d"; //这里的appoid不是客户端提交的原始appoid，而是原始appoid md5后的值
$parameters_array["message"] = "这里是要推送的消息";
$parameters_array["opensound"] = "1"; //打开声音
$parameters_array["openmode"] = "push";
$parameters_array["openurl"] = "http://www.baidu.com/";
$result = phpapi_mvc("apush", "person_put_phpapi", $parameters_array);

if (empty($result["status"])) {
	var_dump($result); //打印出返回内容
} else {
	var_dump($result["error"]); //打印出错误内容
}
?>

• appkey 【热拍卖家版Android客户端的appkey为100005，iOS为100004；买家版HTML5为100001，iOS为100002，Android为100003】

• appoid 【设备的唯一ID的md5值，android手机取网卡mac地址的md5值作为唯一ID；iOS手机取OpenUDID作为唯一ID。这里的appoid不是客户端提交的原始appoid，而是原始appoid md5后的值】

• message 【要推送的文本消息】

• opensound 【是否打开消息提醒声音，字符串1为打开，0为关闭】

• openmode 【点击推送消息打开指定网页的模式：non不开启，push以push模式打开，present以present模式打开，browser以外部浏览器打开】

• openurl 【点击推送消息打开的指定网址】

• 写入成功，返回布尔值 true

• 写入失败，返回布尔值 false

<?php
require_once("/Data/webapps/m.repai.com/m/phpapi.php"); //PHP引用方式，需要引用的框架入口文件
$parameters_array["appkey"] = "100005";
$parameters_array["appoid"] = "d19149dd97b17ce55e70abd2f9e64d3d"; //这里的appoid不是客户端提交的原始appoid，而是原始appoid md5后的值
$parameters_array["message"] = "这里是要推送的消息";
$parameters_array["opensound"] = "1"; //打开声音
$parameters_array["openmode"] = "push";
$parameters_array["openurl"] = "http://www.baidu.com/";
$result = phpapi_mvc("apush", "club_put_phpapi", $parameters_array);

if (empty($result["status"])) {
	var_dump($result); //打印出返回内容
} else {
	var_dump($result["error"]); //打印出错误内容
}
?>

• appkey 【热拍卖家版Android客户端的appkey为100005，iOS为100004；买家版HTML5为100001，iOS为100002，Android为100003】

• rp_club_id 【俱乐部ID，根据用户喜好，会将每个用户添加到不同的俱乐部，推送给该俱乐部的消息，会同时推送给俱乐部拥有的用户】

• message 【要推送的文本消息】

• opensound 【是否打开消息提醒声音，字符串1为打开，0为关闭】

• openmode 【点击推送消息打开指定网页的模式：non不开启，push以push模式打开，present以present模式打开，browser以外部浏览器打开】

• openurl 【点击推送消息打开的指定网址】

• 写入成功，返回布尔值 true

• 写入失败，返回布尔值 false

https://m.repai.com/apush/get_api/appkey/密钥编号/appoid/手机设备唯一编号/timestamp/1402307990/token/73191b75734ea67df90cbb824ff67811

• appkey 【热拍卖家版Android客户端的appkey为100005，iOS为100004；买家版HTML5为100001，iOS为100002，Android为100003】

• appoid 【设备的唯一ID，android手机取网卡mac地址的md5值作为唯一ID；iOS手机取OpenUDID作为唯一ID】

• timestamp 【当前的UNIX时间戳，时间戳有效期20分钟】

• token 【防篡改验证串，token值的组成为，以PHP代码为例：md5(“RP”.$appkey.$appsecret.$appoid.$timestamp) 由客户端生成，其中 $appsecret为密钥，每个appkey对应的不同的密钥，密钥请询问张宴】

• JSON格式输出，错误时，status值为false，reason值为错误原因文本信息，示例如下：

{
"reason": "TOKEN验证未通过，非法请求！",
"status": false
}

• JSON格式输出，无推送消息时，status值也为false，示例如下：

{
"reason": "无消息列表。",
"status": false
}

• JSON格式输出，有消息时，status值为true，示例如下：

{
"list": [
	{
		"message": "这里是要推送的消息1",
		"openmode": "push",
		"opensound": "1",
		"openurl": "http://www.baidu.com/"
	},
	{
		"message": "这里是要推送的消息2",
		"openmode": "present",
		"opensound": "1",
		"openurl": "http://www.baidu.com/"
	},
	{
		"message": "这里是要推送的消息3",
		"openmode": "non",
		"opensound": "1"
	}
],
"reason": "获取到消息列表。",
"status": true
}

返回首页