• 全部
  • 经验案例
  • 典型配置
  • 技术公告
  • FAQ
  • 漏洞说明
  • 全部
  • 全部
  • 大数据引擎
  • 知了引擎
产品线
搜索
取消
案例类型
发布者
是否解决
是否官方
时间
搜索引擎
匹配模式
高级搜索

IMC对接三方短信平台

2021-11-26提问
  • 0关注
  • 1收藏,1870浏览
粉丝:0人 关注:0人

问题描述:

 

IMC对接三方短信平台,客户给了接口文档,这个是属于那种啦,自定义接入还是通用配置接入,咋用呢这个东西??

 

 

融 合 云 信 平 台

HTTP接口文档(V1.7.1

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

联通在线


 

目录

1、文档说明............................................................................................................ 3

2、接口协议............................................................................................................ 3

2.1 短信发送接口.................................................................................................... 3

2.2 状态报告同步接口............................................................................................. 4

2.3上行短信同步接口.............................................................................................. 5

3、错误码说明......................................................................................................... 5

4JAVAMD5签名程序参考................................................................................ 6

 

 

 

 

 

 

 

 


 

1、文档说明

本文档适用于融合云信平台的HTTP方式接入的商户,正式接入之前需先在融合云信平台完成开通注册,申请HTTP能力,配置开通签名等工作。

通过联通沃云云市场入驻融合云信平台的商户,将自动开通HTTP能力,商户需在平台完成接入参数配置。

2、接口协议

请求数据协议:     HTTP POST

请求数据格式:     JSON

请求数据编码:     UTF-8

 

平台分配参数及获取方法:

参数

含义

获取途径

cpcode

商户编码

登录自服务平台,进入商户信息页,【商户编码】值为cpcode

key

私钥

登录自服务平台,进入系统设置页,【AccessKey】值为key

 

2.1 短信发送接口

接口提供者:融合云信

接口地址:***.***:8000/umcinterface/sendtempletmsg

接口调用者:商户

 

接口请求参数:

字段名

字段类型

是否必须

说明

cpcode

String

必须

渠道在融合云信平台申请的cpcode

登录自服务平台,商户信息页面中的【商户编码】

msg

String

必须

模板参数值,如果包含多个参数,以半角英文逗号分隔

mobiles

String

必须

11位手机号,如果包含多个手机号,请用半角英文逗号分隔,最多支持300个手机号

excode

String

必须

渠道自定义接入号的扩展码,可为空;为空时传空字符串””

templetid

String

必须

渠道在融合云信平台申请的模板短信ID

sign

String

必须

MD5签名,签名字符串为cpcode+ msg+mobiles+excode+templetid+key,其中key为融合云信平台分配的私钥,将签名字符串用MD5加密后转换为小写字符串。

数据举例:

{"cpcode":"XXXXXX","msg":"183001,2,10010","mobiles":"18607714703,18648807841","excode":"00000","templetid":"2","sign":"20e90defeea6ea29e643bdd8a80b18e0"}

 

接口响应

字段名

字段类型

是否必须

说明

resultcode

String

必须

错误码,请参考下节《错误码说明》

resultmsg

String

必须

错误码说明,请参考下节《错误码说明》

taskid

String

必须

内部订单号,匹配状态报告使用

数据举例:

{"resultcode":0,"resultmsg":"成功",”taskid”:” C20511170688217”}

2.2 状态报告同步接口

接口提供者:商户

接口地址:商户在自服务平台中报备

接口调用者:融合云信

 

接口说明:状态报告数据以JsonArray格式批量发送,每次最大同时发送100条状态报告。

接口请求参数:

字段名

字段类型

是否必须

说明

state

String

必须

短信发送的状态报告码,0:成功,其余失败

mobile

String

必须

11位手机号码

taskid

String

必须

内部订单号,匹配状态报告使用,字母和数字的混合

sortid

String

必须

消息序号

time

String

必须

短信状态报告到达时间,格式为yyyyMMddHHmmss

数据举例:

[{"mobile":"18607714703","state":"1","taskid":"T20511170688217",”sortid”:”0”,"time":"20170119140121"},{"mobile":"18607714704","state":"1","taskid":"T20511170688218",”sortid”:”0”,"time":"20170119140121"}]

 

接口响应

字段名

字段类型

是否必须

说明

status

Int

成功收到通知响应 0;异常1

样例:

{

         "status": 0

}

 

2.3上行短信同步接口

接口提供者:商户

接口地址:商户在自服务平台中报备

接口调用者: 融合云信

 

接口说明:上行数据以JsonArray格式批量发送,每次最大同时发送100条状态报告。

接口请求参数:

字段名

字段类型

是否必须

说明

fisp

String

必须

上行端口号

mobile

String

必须

11位手机号码

msg

String

必须

上行短信内容

time

String

必须

短信上行时间,格式为yyyyMMddHHmmss

数据举例:

[{"mobile":"18607714703","fisp":"10655512445223","time":"20170119140121","msg":"TD5"},{"mobile":"18607714704","fisp":"10655512445224","time":"20170119140121","msg":"TD5"}]

 

接口响应

字段名

字段类型

是否必须

说明

status

Int

成功收到通知响应 0;异常1

样例:

{

         "status": 0

}

 

3、错误码说明

错误码

错误码说明

0

成功

301

JSON的格式错误

302

非法商户信息

304

缺少cpid参数

305

商户状态异常

306

商户能力异常

307

模板参数值不足

308

缺少msg参数

309

msg长度非法

310

包含敏感词

311

缺少mobiles参数

312

mobiles长度非法

313

缺少excode参数

314

缺少templetid参数

315

缺少sign参数

316

签名校验不通过

317

程序异常

 

4JAVAMD5签名程序参考

 

package com.hello.test;

 

import java.io.UnsupportedEncodingException;

import java.security.MessageDigest;

import java.security.NoSuchAlgorithmException;

 

public class MD5 {

         public MD5() {

         }

         public static String makeMD5(String plainText) {

                   String re_md5 = new String();

                   try {

                            MessageDigest md = MessageDigest.getInstance("MD5");

                            md.update(plainText.getBytes("UTF-8"));

                            byte b[] = md.digest();

                            int i;

                            StringBuffer buf = new StringBuffer("");

                            for (int offset = 0; offset < b.length; offset++) {

                                     i = b[offset];

                                     if (i < 0)

                                               i += 256;

                                     if (i < 16)

                                               buf.append("0");

                                     buf.append(Integer.toHexString(i));

                            }

                            re_md5 = buf.toString().toLowerCase();

                   } catch (NoSuchAlgorithmException e) {

                            e.printStackTrace();

                   } catch (UnsupportedEncodingException e) {

                            // TODO Auto-generated catch block

                            e.printStackTrace();

                   }

                   return re_md5;

         }

        

         public static void main(String[] args) {

                   String cpcode = "AAAAAC";

                   String msg = "模板短信测试,0001";

                   String mobiles = "18607714703,18648807841";

                   String excode = "";

                   String templetid = "2";

                   String key = "f75b9467e1112239";

                   String md5source = cpcode+ msg+mobiles+excode+templetid+key;

                   String md5str = "";

                   try {

                            md5str = makeMD5(new String(md5source.getBytes("UTF-8"), "UTF-8")).toLowerCase();

                   } catch (UnsupportedEncodingException e) {

                            e.printStackTrace();

                   }

                   System.out.println(md5str);

         }

}

组网及组网描述:

无线短信认证使用

1 个回答
Xcheng 九段
粉丝:122人 关注:3人

建议联系当地H3C办事处或采购渠道H3C认证代理商方面反馈定制需求走定制流程。

那这种配置的时候就是自定义配置是吗?需要定制啥呢具体?

zhiliao_ArtOSU 发表时间:2021-11-26

定制短信模块呗,要么买IMC平台适配过的短信平台的产品 如亿美的短信包

Xcheng 发表时间:2021-11-26

编辑答案

你正在编辑答案

如果你要对问题或其他回答进行点评或询问,请使用评论功能。

分享扩散:

提出建议

    +

亲~登录后才可以操作哦!

确定

亲~检测到您登陆的账号未在http://hclhub.h3c.com进行注册

注册后可访问此模块

跳转hclhub

你的邮箱还未认证,请认证邮箱或绑定手机后进行当前操作

举报

×

侵犯我的权益 >
对根叔社区有害的内容 >
辱骂、歧视、挑衅等(不友善)

侵犯我的权益

×

泄露了我的隐私 >
侵犯了我企业的权益 >
抄袭了我的内容 >
诽谤我 >
辱骂、歧视、挑衅等(不友善)
骚扰我

泄露了我的隐私

×

您好,当您发现根叔知了上有泄漏您隐私的内容时,您可以向根叔知了进行举报。 请您把以下内容通过邮件发送到pub.zhiliao@h3c.com 邮箱,我们会尽快处理。
  • 1. 您认为哪些内容泄露了您的隐私?(请在邮件中列出您举报的内容、链接地址,并给出简短的说明)
  • 2. 您是谁?(身份证明材料,可以是身份证或护照等证件)

侵犯了我企业的权益

×

您好,当您发现根叔知了上有关于您企业的造谣与诽谤、商业侵权等内容时,您可以向根叔知了进行举报。 请您把以下内容通过邮件发送到 pub.zhiliao@h3c.com 邮箱,我们会在审核后尽快给您答复。
  • 1. 您举报的内容是什么?(请在邮件中列出您举报的内容和链接地址)
  • 2. 您是谁?(身份证明材料,可以是身份证或护照等证件)
  • 3. 是哪家企业?(营业执照,单位登记证明等证件)
  • 4. 您与该企业的关系是?(您是企业法人或被授权人,需提供企业委托授权书)
我们认为知名企业应该坦然接受公众讨论,对于答案中不准确的部分,我们欢迎您以正式或非正式身份在根叔知了上进行澄清。

抄袭了我的内容

×

原文链接或出处

诽谤我

×

您好,当您发现根叔知了上有诽谤您的内容时,您可以向根叔知了进行举报。 请您把以下内容通过邮件发送到pub.zhiliao@h3c.com 邮箱,我们会尽快处理。
  • 1. 您举报的内容以及侵犯了您什么权益?(请在邮件中列出您举报的内容、链接地址,并给出简短的说明)
  • 2. 您是谁?(身份证明材料,可以是身份证或护照等证件)
我们认为知名企业应该坦然接受公众讨论,对于答案中不准确的部分,我们欢迎您以正式或非正式身份在根叔知了上进行澄清。

对根叔社区有害的内容

×

垃圾广告信息
色情、暴力、血腥等违反法律法规的内容
政治敏感
不规范转载 >
辱骂、歧视、挑衅等(不友善)
骚扰我
诱导投票

不规范转载

×

举报说明