Jeeplus默认使用企信通短信,详细文档如下

  • 企信通接口文档

  • v3.3

  • 接口域名:http://api.cnsms.cn

  • 一、工作方式 11

  • 二、字符编码 22

  • 三、响应格式 22

  • 四、短信发送 22

  • 五、接收回复短信 33

  • 六、取剩余短信条数 44

  • 七、修改接口密码 55

一、工作方式

双方通过HTTP方式交互数据,第三方可以简单的“name=value”方式发送提交内容或响应请求内容。即通过HTTP的GET/POST方式交换。

另外双方需要保证数据传输的完整性和安全性,每次发送请求都有响应(响应返回格式为纯文本),安全验证目前采用用户名和密码的方式。

二、字符编码

服务器接收数据默认是GBK编码,如提交的内容是UTF-8编码字符,需要添加参数 encode=utf8。接入时应注意GBK编码只可以GET。 请求响应返回内容编码与请求一致。

三、响应格式

所为响应即每次向服务器提交请求后返回值 响应值格式为纯文本 状态码 如发送成功后返回 100

四、短信发送

GET/POST操作格式:

http://api.cnsms.cn/?ac=send&uid=用户账号&pwd=MD5位32密码&mobile=号码&content=内容

  • 接口参数说明:

  • 参数名 参数字段 参数说明数说明

  • uid 用户账号 6位的接口帐号,帐号, 如:100226

  • pwd 用户密码 帐号登录密码码的32位MD5加密5加密

  • mobile 接收号码 同时发送给多个号码时,号码之间用英文半角逗号分隔(,)如:13972827282,13072827282,021854188748874

  • GET  方式每次最多可以提交50条号码

  • POST 方式每次最多可以提交2000条号码[建议用POST方式提交]

  • content 短信内容 发送内容需要进行URL字符标准化转码。转码。

  • {URL字符编码说明:返回字符串,此字符串中除了-_.之外的所有非字母数字字符都将被替换成百分号(%)后跟两位十六进制数,空格则编码为加号(+)}

  • ASP:server.URLEncode("短信内容")

  • PHP:urlencode("短信内容")

  • JAVA:java.net.URLEncoder.encode("短信内容")

  • time 定时时间 可选项,及时发送时参数无发送时参数无 格式:YYYY-MM-DD HH:MM 如:"2010-05-27 12:01" (年-月-日 时:分),发送时间以北京时间为准

  • encode 字符编码 可选项,默认接收数据是GBK编码,只能GET,如提交的是UTF-8编码字符,需要添加参数添加参数 encode=utf8

  • 例:

  • 接 收 号:15901997305

  • 发送内容:企信通发送测试

  • http://api.cnsms.cn/?ac=send&uid=100860&pwd=fa246d0262c3925617b0c72bb20eeb1d&mobile=15901997305&content=%D6%D0%B9%FA%B6%CC%D0%C5%CD%F8%B7%A2%CB%CD%B2%E2%CA%D4

  • 发成功时响应状态码值:

  • 100

五、接收回复短信

  • GET操作的格式:

  • http://api.cnsms.cn/?ac=gr&uid=用户账号&pwd=MD5位32密码

  • 接口参数说明:

  • 参数 参数字段名 说明说明

  • uid 用户账号 6位的接口帐号,帐号, 如:108601

  • pwd 用户密码 小写32位MD5加密5加密

  • 例:

  • http://api.cnsms.cn/?ac=gr&uid=108601&pwd=fa246d0262c3925617b0c72bb20eeb1d

  • 响应结果为纯文本,每次可接收多条回复信息:

  • 状态码{&}回复号码||回复内容||回复时间||回复网关号{&}回复号码||回复内容||回复时间||回复网关号…….

  • 例响应结果值:

  • 100{&}13912341234||企信通测试回复||2008-05-27 12:10:11||1068112227282{&}15912343333||企信通测试回复2||2008-05-27 13:11:11||106811222728200

  • 返回发送的状态码

  • 无回复内容时返回空

  • 状态码 说明说明

  • 100 接收成功接收成功

  • 101 验证失败验证失败

六、取剩余短信条数

  • GET操作格式:

  • http://api.cnsms.cn/?ac=gc&uid=用户账号&pwd=MD5位32密码

  • 接口参数说明:

  • 参数 参数字段名 说明说明

  • uid 用户账号 6位的接口帐号,帐号, 如:108601

  • pwd 用户密码 小写32位MD5加密5加密

  • 例:

  • http://api.cnsms.cn/?ac=gc&uid=108601&pwd=fa246d0262c3925617b0c72bb20eeb1d

  • 响应结果为纯文本:

  • 状态码||剩余可发短信

  • 例响应结果值:

  • 100||22348

  • 状态码 说明说明

  • 100 请求成功请求成功

  • 101 验证失败验证失败

七、修改接口密码

  • GET操作格式:

  • http://api.cnsms.cn/?ac=gp&uid=用户账号&pwd=MD5位32密码&npwd=MD5位32密码

  • 接口参数说明:

  • 参数 参数字段名 说明说明

  • uid 用户账号 6位的接口帐号,帐号, 如:108601

  • pwd 原用户密码 小写32位MD5加密加密

  • npwd 新用户密码 小写32位MD5加密MD5加密

  • 例:

  • http://api.cnsms.cn/?ac=gp&uid=108601&pwd=fa246d0262c3925617b0c72bb20eeb1d&npwd=e10adc3949ba59abbe56e057f20f883e

  • 响应结果为纯文本:

  • 状态码

  • 状态码 说明说明

  • 100 修改成功修改成功

  • 101 验证失败验证失败

  • 107 频率过快频率过快

  • 108 新密不为空新密不为空

  • 109 帐号已已冻结帐号已已冻结

  • 114 帐号被锁帐号被锁

  • 115 操作失败操作失败

  • 116 禁止接口发送禁止接口发送

  • 117 绑定IP不正确