满友科技短信接口文档

1、 行专业之服务，创恒久之价值短信平台接口说明 目录1普通短信发送31.1短信提交地址31.2参数定义31.3短信提交响应41.3.1格式说明41.3.2示例41.3.3响应状态值说明51.4注意事项51.5短信发送例子61.6参数定义61.7状态报告值61.8示例72短信接收72.1参数定义72.2示例83额度查询接口83.1接口地址83.2提交响应83.3提交响应值93.4示例94修改账户密码接口94.1接口地址94.2参数定义94.3提交响应94.4提交响应值104.5示例10本文档主要定了短信平台对用户开放的主要接口和定义。1 普通短信发送用户可通过HTTP的GET和POST方式提交短信

2、发送请求。1.1 短信提交地址短信可以提交不超过50000个手机号码，每个号码用英文逗号间隔。URL地址为：http:/url:port/manyousms/sendsms。注：其中IP:PORT为服务部署的地址和端口。 GET请求http:/ip:port/manyousms/sendsms?account=test&password= test&mobilescontent=当前验证码是：12345【满友科技】1.2 参数定义序号参数说明1account必填参数。用户账号2password必填参数。用户密码3mobiles必填参数。合法的手机号码，号码间用英文逗号

3、分隔4content必填参数。短信内容，短信内容长度不能超过585个字符。使用URL方式编码为UTF-8格式。短信内容超过70个字符（企信通是60个字符）时，会被拆分成多条，然后以长短信的格式发送。5response返回值1.3 短信提交响应用户短信通过web请求提交到服务器后，服务器返回响应码，响应码的格式如下： codetype ： ,sendmsgid: 1.3.1 格式说明短信提交响应分为两个，第一个为响应状态，第二个为服务器给出提交msgid。无论发送的号码是多少，一个发送请求只返回一个msgid。 1.3.2 示例 提交成功codetype :0,sendmsgid:1001030

4、015349555800 响应状态为0 表明那个成功提交到服务器；1001030015349555800为返回的sendmsgid，这个供状态报告匹配时使用。codetype :101,sendmsgid:1001030015349555800 提交失败本示例表明用户提交失败，返回错误码为101，服务器端并未返回msgid。1.3.3 响应状态值说明代码说明0提交成功101无此用户102密码错103提交过快（提交速度超过流速限制）104系统忙（因平台侧原因，暂时无法处理提交的短信）105敏感短信（短信内容包含敏感词）106消息长度错（536或50000或200或=0）109无发送额度（该用户可

5、用短信数已使用完）110不在发送时间内111超出该账户当月发送额度限制112产品无对应的通道115自动审核驳回116签名不合法，未带签名（用户必须带签名的前提下）117IP地址认证错,请求调用的IP地址不是系统登记的IP地址118用户没有相应的发送权限119用户已过期1.4 注意事项用户群发短信如果有审核的限制，则客户的短信必须经过管理人员的审核，审核通过后才能被提交到行业网关进行短信实际发送。用户群发短信必须满足手机号码最低个数的限制，低于系统设定的群发最小手机号码数，则该提交请求会被拒绝，响应码为108。1.5 短信发送例子http:/ip:port/manyousms/sendsms?a

6、ccount=test&password= test&mobilescontent=【满友科技】您的注册验证码是：1131.请完成注册状态报告推送如果管理员设置用户账户需要状态报告，并且也配置了账户的状态报告接收地址，则用户可以接收到其发送短信的状态报告。用户需提供一个HTTP服务用于接收状态报告。58为满友科技推送报告服务器1.6 参数定义序号参数说明1receiver接收状态报告验证的用户名（不是账户名），是按照用户要求配置的名称，可以为空2pswd接收状态报告验证的密码，可以为空3msgid提交短信时平台返回的msgid，参见1.24re

7、portTime格式YYMMDDhhmm，其中YY=年份的最后两位（00-99），MM=月份（01-12），DD=日（01-31），hh=小时（00-23），mm=分钟（00-59）5mobile单一的手机号码6status状态报告数值1.7 状态报告值状态报告的值即，status后面的数据，如下状态值(字符串)说明DELIVRD短消息转发成功EXPIRED短消息超过有效期UNDELIV短消息是不可达的UNKNOWN未知短消息状态REJECTD短消息被短信中心拒绝DTBLACK目的号码是黑名单号码ERR:104系统忙REJECT审核驳回其他网关内部状态1.8 示例http:/pushUrl?r

8、eceiver=admin&pswd=12345&msgid=12345&reportTime=1012241002&mobilestatus=DELIVRD其中，pushUrl为用户启动的服务地址。2 短信接收2.1 参数定义序号参数说明1receiver接收信息验证的用户名（不是账户名），是按照用户要求配置的名称，可以为空2pswd接收信息服务需验证的密码，可以为空3moTime格式YYMMDDhhmm，其中YY=年份的最后两位（00-99），MM=月份（01-12），DD=日（01-31），hh=小时（00-23），mm=分钟（00-59）4mobile单一的手

9、机号码5msgMO短信内容，文字内容使用UTF-8编码6destcode用户上行的目的号码7isems是否为长短信的一部分，1:是，0，不是。不带该参数，默认为普通短信8emsheadIsems为1时，本参数以ASCII码形式显示长短信的头信息。用“,”隔开，分为三个部分，第一部分标识该条长短信的ID（该ID为短信中心生成）；第二部分，表明该长短信的总条数（pk_total）；第三部分，该条短信为该长短信的第几条(pk_number)。例如：234,4,1，该短信的ID为234,该长短信的总长度为4条，1，当前为第一条。2.2 示例普通短信：http:/pushMoUrl?receiver=a

10、dmin&pswd=12345&moTime=1208212205&mobiledestcode=1065751600001&msg=hello&destcode=10657109012345EMS短信：http:/pushMoUrl?receiver=admin&pswd=12345&moTime=1208212205&mobiledestcode=1065751600001&msg=hello&destcode=10657109012345&isems=1&emshead=255,5,5其中，pushUrl为用户启动的服务地址。3 额度查

11、询接口3.1 接口地址http:/ip:port/manyousms/getbalance注：其中IP:PORT为服务部署的地址和端口。参数定义序号参数说明1account必填参数。用户账号2password必填参数。用户密码3response返回值3.2 提交响应currentBalance:1000currentBalance:-1currentBalance:1000 3.3 提交响应值代码说明大于0大于0的值为当前余额-1-1为账号密码错误或者用户不存在3.4 示例http:/ip:port/manyousms/getbalance?account=111111&password=1234564 修改账户密码接口4.1 接口地址http:/ip:port/manyousms/changepwd4.2 参数定义序号参数说明1account账号2password