写入批量用户消息

本接口由业务应用的服务端进行调用。使用前请联系云创团队获取调用所需的app_keyapp_secret

请求

域名

  • 测试环境 https://b2c-message-test.mypaas.com.cn
  • 生产环境 https://b2c-message.mypaas.com.cn

uri

/api/v1/server/user/messages

请求方法

POST

header参数

query参数

名称 类型 必填 说明 示例
tenant_code string 租户code agile
app_key string 服务端应用key 9b437adc87a98d3ffaad4747588e30f4
app_sign string 参见app_sign生成规则 7450bc612276dfe6d71d93589e4192d

body参数

名称 类型 必填 说明 示例
union_ids string 用户id组 4ca59abae2bfb,9e8a1e5a4ddc8
msg_group_name string 消息分组名称 系统
msg_title string 消息标题 系统消息标题
msg_description string 消息描述 系统消息描述
msg_content string 消息内容 系统消息内容
msg_action string 消息动作 系统消息动作
msg_type int 默认:0(普通用户消息),消息类型业务方可自定义,但是不能为负 消息类型

app_sign 生成规则

query参数、body参数、系统参数random以及系统参数timestamp,ascii排序后&连接,在加上app_secret,md5加密转小写。

demo

测试环境可用 appKey = '9b437adc87a98d3ffaad4747588e30f4'; appSecret = 'ec2b65c0da8e7193bffabc75b733ea57';

参数:

query参数:test1=a&test2=b&app_key=9b437adc87a98d3ffaad4747588e30f4

body参数:test3=c&test4=d

系统参数 : random=radomstring&timestamp=1525510814

PHP代码

$appKey = '9b437adc87a98d3ffaad4747588e30f4';
$appSecret = 'ec2b65c0da8e7193bffabc75b733ea57';

$requestQueryApp = ['app_key'=>$appKey];
$requestQueryBiz = ['a'=>'one','b'=>'two'];
$requestBody = ['c'=>'three','d'=>'four'];
$random = uniqid();
$timestamp = time();
$requestQuerySys = ['random'=>$random,'timestamp'=>$timestamp];

$signParams = $requestQueryApp + $requestQueryBiz + $requestBody + $requestQuerySys;
ksort($signParams);
array_walk($signParams, function(&$v){
    $v === null && $v = '';
});
$signString = urldecode(http_build_query($signParams)).$appSecret;
md5($signString);

响应

响应json.data

名称 类型 说明
data.* string 进入队列成功的用户id

响应 json的demo

{
    "msg":"ok",
    "data":[
        "4ca59abae2bfb"
    ],
    "code":200
}

results matching ""

    No results matching ""