短信提交接口说明文档.doc

短信通 短信接口V2014.11.11常见问题：(接口调用规则第2页）1问：“短信长度”如何收费？70字符1条收费，超70字，按65/条，多条收费。(通道行业标准，部分通道67字符单条）2问：“短信模板”是什么？短信模板如：您的订单编码：【变量】。如需帮助请联系客服。 实际短信：您的订单编码：888888。如需帮助请联系客服。其中的【变量】= 888888“【变量】”部分可变动，其余文字格式必须和“短信模板”完全一致，才可下发！包括空格、标点符号等。3问：“短信签名”是什么？短信签名是短信末尾或前面跟的品牌签名如：您的订单编码：888888。如需帮助请联系客服。【会员验证通知】 短信签名 = 会员验证通知（一般是公司或产品简称）4问：是否支持自定义“短信签名”和自定义“短信模板”？由于短信行业受运营商政策管制，只有政策允许且你的帐号级别够的时候，才支持。若帐号无权限或系统未开放时，只能选用系统默认的通用性短信签名和短信模版。如果都支持，编辑好签名、模板，后台提交，我们报备运营商，审批下来后就可以按贵公司的格式进行发送了。（以后台通告为准）提交时，签名不用加“【】”号，模板中属于变量的地方用“【变量】”代替，否则系统识别不出来。小批量应用【部分自定义内容和签名】实现方法：短信模板：您的订单编码：【变量】。如需帮助请联系客服。实际内容：您的订单编码：20140208 客服热线4006668280【速度网络】。如需帮助请联系客服。【会员验证通知】可以把订单编码、客服热线、【店铺名称】，都融入到 一个【变量】里。短信模板：您的订单编码：【变量】。如需帮助请联系客服。实际内容：您的订单编码：8888【速度网络】。如需帮助请联系客服。【会员验证通知】可以把验证码、网站或软件名称，都融入到 一个【变量】里。5问：我可以绑定IP吗？为了避免各种原因的帐号盗用情况，造成贵公司短信被滥用，所以我们的系统有ip验证功能，只发送您这边认可的ip地址提交的短信。6问：接口调试返回“104 内容未审核”错误？发送内容未按系统模板或备案的模板下发 或 程序编码gbk、utf-8和接口不一致短信通 HTTP接口文档一、工作方式双方通过HTTP方式交互数据，第三方可以简单的“name=value”方式发送提交内容或响应请求内容。即通过HTTP的GET/POST方式交换。另外双方需要保证数据传输的完整性和安全性，每次发送请求都有响应(响应返回格式为纯文本)，安全验证目前采用用户名和密码的方式。二、字符编码不同的编码方式请使用不同的接口地址三、国内触发类短信接口|验证码/订单提醒*非群发类！（国内群发类是“五”）GET/POST操作格式，URL调试专用模版：GBK编码发送接口地址/gbk/sms.aspx?account=用户账号&password=接口密码&mobile=号码&content=您的订单编码：888888。如需帮助请联系客服。UTF-8编码发送接口地址/utf8/sms.aspx?account=用户账号&password=接口密码&mobile=号码&content=您的订单编码：888888。如需帮助请联系客服。*特别注意：小批量调试或应用订购 短信内容只能用“系统公共模版”相对固定格式，否则会报错104“内容未审核”。短信内容模版：您的订单编码：【变量】。如需帮助请联系客服。实际短信内容：您的订单编码：888888。如需帮助请联系客服。其中【变量】是可以自定义内容，其它都要和模板一致，包括空格、标点符号等！自定义短信模版、签名 需要审批和备案，年消费3-5万条。具体流程请联系在线客服。*返回发送的状态码说明：状态码说明100发送成功101验证失败102手机号码格式不正确103会员级别不够104内容未审核105内容过多106账户余额不足107Ip受限108手机号码发送太频繁，请换号或隔天再发109帐号被锁定110手机号发送频率持续过高，黑名单屏蔽数日120系统升级接口参数说明:参数名参数字段参数说明account用户账号注册时的用户名password接口密码注意！非帐号登录密码！管理后台“接口设置”里设置。mobile接收号码注意！1个号码接收频率5次/天。不然易引起运营商网关屏蔽数天。果大量调试，多个手机号码轮换调试。如果需要更高频率联系客服申请。content短信内容发送内容需要进行URL字符标准化转码。URL字符编码说明:返回字符串，此字符串中除了-_.之外的所有非字母数字字符都将被替换成百分号（%）后跟两位十六进制数，空格则编码为加号（+）ASP：server.URLEncode(短信内容)PHP：urlencode(短信内容)JAVA：.URLEncoder.encode(短信内容)专用调试模版：您的订单编码：888888。如需帮助请联系客服。例: 接 收 号ET/POST操作格式，URL调试专用模版：/utf8/sms.aspx?account=9999&password=接口密码&mobilecontent=您的订单编码：888888。如需帮助请联系客服。发成功时响应状态码值: 100*特别注意：小批量调试或应用订购 短信内容只能用“系统公共模版”相对固定格式，否则会报错104“内容未审核”。短信内容模版：您的订单编码：【变量】。如需帮助请联系客服。实际短信内容：您的订单编码：888888。如需帮助请联系客服。其中【变量】是可以自定义内容，其它都要和模板一致，包括空格、标点符号等！自定义短信模版、签名 需要审批和备案，年消费3-5万条。具体流程请联系在线客服。*四、*国际短信接口*非国内！（国内触发是“三”群发“五”）GET/POST操作格式：GBK编码发送接口地址：/gbk/worldapi.aspx?account=用户账号&password=接口密码&mobile=号码&content=内容UTF-8编码发送接口地址：/utf8/worldapi.aspx?account=用户账号&password=接口密码&mobile=号码&content=内容未充值用户 调试专用 内容 模板：内容 = 尊敬的用户您已经注册成功，用户名：0 密码：1 感谢您的注册！备注： 0=帐号用户名，1=帐号密码（无需中括弧） 必须是真实注册信息，否则会返回104错误。返回发送的状态码说明：状态码说明100发送成功101验证失败102手机号码格式不正确103会员级别不够104内容未审核105内容过多106账户余额不足107Ip受限108手机号码发送太频繁，请换号或隔天再发109帐号被锁定110发送通道不正确111当前时间段禁止短信发送120系统升级接口参数说明:参数名参数字段参数说明account用户账号注册时的用户名password接口密码注意！非帐号登录密码！管理后台“接口设置”里设置。mobile接收号码手机号码，如多个以英文逗号分隔（建议100个及以内的手机号码，,超过系统上限将会返回参数错误）。 如:德国手机举例：国际区码：49地区区码：0179手机号码：1234567 填写的正确格式为：491791234567 注意！地区城市区码的0或00不用加content短信内容发送内容需要进行URL字符标准化转码。URL字符编码说明:返回字符串，此字符串中除了-_.之外的所有非字母数字字符都将被替换成百分号（%）后跟两位十六进制数，空格则编码为加号（+）ASP：server.URLEncode(短信内容)PHP：urlencode(短信内容)JAVA：.URLEncoder.encode(短信内容)调试专用模版(未充值用户)：/utf8/worldapi.aspx?account=9999&password=接口密码&mobile=手机号码&content=尊敬的用户您已经注册成功，用户名：0 密码：1 感谢您的注册！未充值用户 调试专用 内容 模板：内容 = 尊敬的用户您已经注册成功，用户名：0 密码：1 感谢您的注册！备注： 0=帐号用户名，1=帐号密码（无需中括弧） 必须是真实注册信息，否则会返回104错误。有充值记录帐号，即可自定义短信内容。发成功时响应状态码值: 100五、国内群发类短信接口！（不支持单条频繁提交）*非触发类！（验证码、订单等是“三”）GET/POST操作格式：GBK编码发送接口地址/gbk/openapi.aspx?account=用户账号&password=接口密码&mobile=号码&content=内容UTF-8编码发送接口地址/utf8/openapi.aspx?account=用户账号&password=接口密码&mobile=号码&content=内容未充值用户 调试专用 内容 模板：内容 = 尊敬的用户您已经注册成功，用户名：0 密码：1 感谢您的注册！备注： 0=帐号用户名，1=帐号密码（无需中括弧） 必须是真实注册信息，否则会返回104错误。返回发送的状态码说明：状态码说明100发送成功101验证失败102手机号码格式不正确103会员级别不够104内容未审核105内容过多106账户余额不足107Ip受限108手机号码发送太频繁，请换号或隔天再发109帐号被锁定110发送通道不正确111当前时间段禁止短信发送120系统升级接口参数说明:参数名参数字段参数说明account用户账号注册时的用户名password接口密码注意！非帐号登录密码！管理后台“接口设置”里设置。mobile接收号码手机号码，如多个以英文逗号分隔（建议1000个及以内的手机号码，,超过系统上限将会返回参数错误）。 如:content短信内容发送内容需要进行URL字符标准化转码。URL字符编码说明:返回字符串，此字符串中除了-_.之外的所有非字母数字字符都将被替换成百分号（%）后跟两位十六进制数，空格则编码为加号（+）ASP：server.URLEncode(短信内容)PHP：urlencode(短信内容)JAVA：.URLEncoder.encode(短信内容)例: 接 收 号RL调试专用模版(未充值用户)：/utf8/sms.aspx?account=9999&password=接口密码&mobilecontent=尊敬的用户您已经注册成功，用户名：0 密码：1 感谢您的注册！未充值用户 调试专用 内容 模板：内容 = 尊敬的用户您已经注册成功，用户名：0 密码：1 感谢您的注册！备注： 0=帐号用户名，1=帐号密码（无需中括弧） 必须是真实注册信息，否则会返回104错误。有充值记录帐号，即可自定义短信内容。