接口对接发送彩信XML成功失败案例

最新推荐文章于 2025-06-26 10:56:07 发布

lexuntong

最新推荐文章于 2025-06-26 10:56:07 发布

阅读量1k

点赞数 30

CC 4.0 BY-SA版权

文章标签： xml 前端

本文链接：https://blog.csdn.net/lexuntong/article/details/148589611

请求协议：http

请求方式：采用post方式提交请求

请求报文

action=sendimagetext&username=zhangsan&password=E10ADC3949BA59ABBE56E057F20F883E&token=894gbhy&mobile=手机号1, 手机号2, 手机号3&title=祝福短信&message=3, txt|zsSxvg==, jpg|4AAQSkZJRgABAgAAZABk; 3, gif|ExghIhcXGRcXIiQdIB8fIB0kJCssLywrJDk5Pj45OUFBQ&rece=json&timestamp=636949832321055780&sign=96E79218965EB72C92A54

参数说明

参数名称	是否必须	描述	示例
action	是	操作类型	(固定值)action=sendimagetext
username	是	账户名	username=zhangsan
password	是	账户密码，密码必须MD5加密并且取32位大写	password=E10ADC3949BA59ABBE56E057F20F883E
token	是	产品总览页面对应产品的Token	token=894gbhy
mobile	是	发送的手机号	mobile=手机号1, 手机号2, 手机号3
title	是	短信主题	title=祝福短信
message	是	发送内容，详细请见下面说明	message=3, txt\| zsSxvg==, jpg\| 4AAQSkZJRgABAgAAZABk;
dstime	否	设置要发送短信的时间，精确到秒（yyyy-MM-dd HH:mm:ss)	2017-01-05 16:23:23
rece	否	返回类型json、xml，默认(json)	rece=json
timestamp	是	时间戳，13位时间戳，单位（毫秒）	timestamp=636949832321055780
sign	是	签名校验	sign=96E79218965EB72C92A54

message参数详细说明

彩信每一帧包含文字和图片

彩信中包含的文字信息需要使用gb2312编码格式后再转换base64

内容资源，资源内容包含的帧顺序按照由先至后的顺序，比如1帧=>n帧，帧与帧之间用半角分号(; )分隔。

每个资源内部包含多个类型信息，分别是：3, 类型 | 内容（按字节码base64编码）, 类型 | 内容（按字节码base64编码），每一帧类型和内容之间以 | 隔开，同一帧之间用半角逗号(, )分隔。

以此为例：3, txt|zsSxvg==, jpg|4AAQSkZJRgABAgAAZABk; 3, jpg|ExghIhcXGRcXIiQdIB8fIB0kJCssLywrJDk5Pj45OUFBQ

3, txt|zsSxvg==, jpg|4AAQSkZJRgABAgAAZABk; 这段参数代表这一帧发送文字和图片， txt代表这一帧文字，|后边是编码后的文字信息， jpg代表这一帧图片，|后边是编码后的图片信息。

3, jpg|ExghIhcXGRcXIiQdIB8fIB0kJCssLywrJDk5Pj45OUFBQ 这段参数代表这一帧只发送图片，jpg代表这一帧图片，|后边是编码后的图片信息。

sign参数详细说明

签名由参数action, username, password, token, timestamp进行MD5加密组成

比如这些值拼接后为action=sendimagetext&username=zhangsan&password=E10ADC3949BA59ABBE56E057F20F883E&token=894gbhy&timestamp=636949832321055780，那么就MD5加密这个参数字符串得到结果后作为sign的值sign=96E79218965EB72C92A54

响应报文

参数名称	描述	示例
returnstatus	响应状态	"returnstatus":"success"
code	响应返回码	"code":"0"
taskID	任务ID	"taskID":"15914102484990599"
remark	响应错误返回说明	"remark":"访问超时！"

XML成功返回示例

<?xml version="1.0" encoding="utf-8"?><returnsms>
  <returnstatus>success</returnstatus>
  <code>0</code>
  <taskID>15914102421552674</taskID>
</returnsms>

XML失败返回示例

<?xml version="1.0" encoding="gb2312"?><returnsms>
  <returnstatus>error</returnstatus>
  <code>-4</code>
  <remark>账户密码错误！</remark>
</returnsms>