短信接口
目录
短信接口
短信发送状态
接口返回值说明
余额查询接口(一)
          1.概述
          ◆ 接口采用POST方式提交;
          ◆ 接口格式采用JSON定义,采用UTF-8格式编码;
          ◆ 请求参数分为URL参数和body参数,具体请求方法见接口说明;
          ◆ 对于接口返回码,非000表示失败。失败原因参考返回码定义;
          ◆ HTML头部信息Content-Type设置application/json;charset=UTF-8;
          ◆ 如在使用接口中有任何疑问,请联系客服处理。

          2.接口说明
          接口地址:http://www.lisglo.com/smssend/send
          URL请求参数:
    参数名称 必须 类型 描述信息
    userCode M String 账号编码(具备唯一性的可显标识),由工作人员提供。
    timestamp M Int 发送短信的时间戳,为UNIX纪元时间的秒数,平台允许客户端请求最大时间误差为15分钟。
    sign M String 数据签名,签名算法见后面的“签名算法介绍”。
          body请求参数:
    参数名称 必须 类型 描述信息
    phoneNumber M String 接收短信的手机号码,多个号码用英文逗号分开,最长不超过500个号码。
    sign M String 短信签名,该签名需要提前报备,生效后方可使用,不可修改,如【聆界云短信】。
    content M String 短信内容,最多350个汉字,必填,内容中不要出现【】[]这两种方括号,该字符为签名专用。

          3.签名算法介绍及请求示例
          为了防止API调用过程中被黑客恶意篡改,调用API需要携带签名,平台会根据请求参数,对签名进行验证,签名不合法的请求将会被拒绝。签名算法采用 MD5, 签名过程如下:
          A. 登录聆界短信云平台查询或者通过工作人员获取帐号编码与发送密码,即userCode与对应的key,例如:
          账户编码为0001,发送密码为tz2f37jd
          B. 对所有 API 请求参数名和参数值(除去sign外)与key拼装在一起,例如:
          userCode=0001&timestamp=1523588184tz2f37jd
          C.把拼装好的字符串采用 utf-8 编码, 使用MD5算法对编码后的字节流进行摘要,并将摘要得到的字节流结果使用十六进制表示。如对上述字符串加密后得到结果为:
          0606aa5a357642490af24bdfccfa3854
          即是所需要的sign值。
          注:MD5是128位长度的摘要算法,用16进制表示,一个十六进制的字符表示4个位,所以签名后的字符串长度固定为 32 个十六进制字符。签名后的字符串请规范为小写字符。
          因此我们得到的请求URL为:
          http://www.lisglo.com/smssend/send?userCode=001&timestamp=1523588184&sign=0606aa5a357642490af24bdfccfa3854
          把短信发送的号码、签名与内容放在POST请求的body中,例如:
    {"phoneNumber":"188XXXXXXXX","sign":"【聆界短信云平台】","content":"尊敬的用户188XXXXXXXX,您本次操作的验证码是XXXX,有效时间5分钟。"}
    php 调用接口示例 java 调用接口示例