服务端API介绍

场景	场景介绍	使用API说明
发送通知	通过taobao.baichuan.message.sendNotification (push 发送接口) 发送通知。 注意： 如果入参有mobile_number且无sms_delay_time。表示要同时短信补偿 如果入参有mobile_number且有sms_delay_time。表示无法触达 再发短信补偿	taobao.baichuan.message.sendNotification 【点开链接查看API文档】push 发送接
系统通知短信	通过taobao.baichuan.message.sendMessage (消息发送接口) 发送透传消息	taobao.baichuan.message.sendMessage 【点开链接查看API文档】消息发送接口

服务SDK下载集成

百川应用控制台->SDK下载->服务端SDK->Java等版本（如图）【前提已经开通阿里百川消息权限】

新开通权限需要重新生成SDK，再下载。

java SDK 依赖一个Apache的commons-logging包，下载地址： commons-logging 。 

根据场景介绍，实现相关API的调用。API 请求地址：http://gw.api.taobao.com/router/rest

将上一步下载的SDK集成到项目工程中。 SDK已经集成了接口签名方法，只需要引入对应于的类文件，就可以直接调用接口了。

可以直接参考各个API文档中的SDK调用示例或者参考API测试工具。API测试工具是以json传入参数的，请求示例是以对象传入的。

服务端代码集成

发送通知

java示例代码

更多示例代码可以产看API文档中的［请求示例］。

注意：

1 如果入参有mobile_number且无sms_delay_time。表示要同时短信补偿，会验证sms_signature_id和sms_template_id是否有值。如果有会发送短信补偿。

2 如果入参有mobile_number且有sms_delay_time。表示无法触达发短信补偿，会验证sms_signature_id和sms_template_id是否有值。如果有会发送短信补偿。

import com.taobao.api.ApiException;
import com.taobao.api.DefaultTaobaoClient;
import com.taobao.api.TaobaoClient;
import com.taobao.api.request.BaichuanMessageSendNotificationRequest;
import com.taobao.api.response.BaichuanMessageSendNotificationResponse;
public class BCDXTest {
        private static String appkey="612465**";
        private static String secret="1hfhfhfjfjff822010abfac****";
        private static String url="http://gw.api.taobao.com/router/rest";//api请求地址
        public static void main(String[] args) throws ApiException {
              TaobaoClient client=new DefaultTaobaoClient(url, appkey, secret);
              BaichuanMessageSendNotificationRequest req = new        BaichuanMessageSendNotificationRequest();
             Extramap objExtramap = new Extramap();//自定义参数 kv
             req.setExtraMap(objExtramap);
             req.setMessageDesc("消息描述");
             req.setMobileNumber("138000000");
             req.setSaveTimeout(1L);
             Smscontext objSmscontext = new Smscontext();//短信模板中的变量值
             req.setSmsContext(objSmscontext);
             req.setSmsDelayTime(60L);
             req.setSmsSignatureId(1L);
             req.setSmsTemplateId(10L);
      req.setTargetDeviceToken("Ao_Vn3KMXGMJZdmESPBVg_FzW05WlozDY_Xd5QgzRbWX");
           req.setContentText("hello");
 req.setLargeIcon("http://proc.iifs.ifeng.com/blog/2015/11/30/l6KhypeTec5oj4u7t7KtrtnJqqvaY3KWtoSanWVrbZlta2icamSQwm2XZ5aX3mRmlJLCZJWPYZLBo6eX.jpg");
          req.setOpenType(1L);
          req.setOpenUrl("http://www.taobao.com");
          req.setSummary("hello");
          req.setTitle("hello");
          req.setChannel(1L);
BaichuanMessageSendNotificationResponse rsp = client.execute(req);
System.out.println(rsp.getBody());
 if (response.isSuccess()) {//api请求成功
             response.getResult().getMessage();
             response.getResult().getSuccessful();//通知发送成功，不代表触达
      } else {
           response.getResult().getMessage();
             response.getResult().getSuccessful();
      }
}

发送透传消息

java示例代码

更多示例代码可以产看API文档中的［请求示例］。

import com.taobao.api.ApiException;
import com.taobao.api.DefaultTaobaoClient;
import com.taobao.api.TaobaoClient;
import com.taobao.api.request.BaichuanMessageSendMessageRequest;
import com.taobao.api.response.BaichuanMessageSendMessageResponse;
public class BCDXTest {
        private static String appkey="612465**";
        private static String secret="1hfhfhfjfjff822010abfac****";
        private static String url="http://gw.api.taobao.com/router/rest";//api请求地址
        public static void main(String[] args) throws ApiException {
              TaobaoClient client=new DefaultTaobaoClient(url, appkey, secret);
              BaichuanMessageSendMessageRequest req = new   BaichuanMessageSendMessageRequest();
              req.setChannel(1L);
              Extramap objExtramap = new Extramap();//中定义 kv
              req.setExtraMap(objExtramap);
              req.setMessageDesc("消息描述");
             req.setSaveTimeout(1L);
 req.setTargetDeviceToken("Ao_Vn3KMXGMJZdmESPBVg_FzW05WlozDY_Xd5QgzRbWX");
            req.setMessage("hello");
            BaichuanMessageSendMessageResponse rsp = client.execute(req);
System.out.println(rsp.getBody());
 if (response.isSuccess()) {//api请求成功
             response.getResult().getMessage();
             response.getResult().getSuccessful();//透传发送成功，不代表触达
      } else {
           response.getResult().getMessage();
             response.getResult().getSuccessful();
      }
}

技术咨询

旺旺群：1363288918

 

FAQ

关于此文档暂时还没有FAQ