|
彩信开发接口HTTP协议
服务器地址
基本流程
1>上传资源文件
2>提交彩信发送任务
上传彩信文件mms_upload.asp
输入：
POST /cgi/mms_upload.asp
Content-Type: multipart/form-data
表单中的数据：
User=帐号
Pass=密码
file=上传的资源文件(文件名与数据)
返回：
|
100 SUCCESS(上传成功)?FileName=filename
|
返回的filename为服务器上存储的文件文件名，扩展名于源文件一致。
如果发生错误，返回数据的状态代码小于0.例如：
HTML 演示：
|
<form action="mms_upload.asp" method="post" enctype="multipart/form-data">
账号: <input name=User /><br />
密码: <input name=Pass type="password" /><br />
文件: <input type=file name=file /><br />
<input type=submit value="提交" />
</form>
|
测试地址:
/cgi/test_mms_upload.asp
群发彩信mms_sendgroup.asp
输入：
POST /cgi/mms_sendgroup.asp
Content-Type: application/x-www-form-urlencoded
表单中的数据:
User=帐号&Pass=密码&Count=号码数量&Mobile1=手机号码&Title1=标题&Content1=文件名
如果是多个号码，表单中的数据参数使用以下类似格式:
Mobile2=号码2&Title2=标题2&Content2=文件名2
每次调用Count的值最大为100；
Title标题不要太长，推荐10个汉字以内，最长20个汉字。
Content参数中的文件名应当使用服务器端的文件名，此文件名为调用mms_upload.asp时返回的。
群发时，不同的号码可以使用不同的标题或者文件名。
返回:
|
success_count?Code=success_count&Error=TextForError
|
如果成功，错误代码为提交成功的数量
如果失败，错误代码为负数，Error指出了错误的具体原因。
说明：
返回成功仅表示服务器已经成功接收客户提交的任务，并不表示对方已经收到彩信。
所有参数应该使用URLEncode编码。
查询余额querycount.asp
原型：
querycount.asp? User=UserName&Pass=UserPass
返回值：
返回值小于0表示失败。返回值为100表示修改成功。成功信息如下：
|
100 Report?Count=10000&Send=6000&Left=4000
|
Count表示购买量，Send表示已经发送数量，Left表示剩余可发送数量。
修改密码qchangepass.asp
原型：
qchangepass.asp? User=UserName&Pass=UserPass&NewPass=NewPass
返回值：
返回值小于0表示失败。返回值为100表示修改成功。成功信息如下：
发送WAPPush
原型：
sendsmsplus.asp?User=[User]&Pass=[Pass]&Mobile=[SendTo]&MsgType=5
&Text=[Text]
说明：
[Text]=urlencode({URL}#{Title})
短信内容由网址和标题两部分组成，中间用#分开。最后使用urlencode对短信内容进行编码。不能直接使用#在浏览器地址栏进行测试，应当使用%23代替#。
URL地址可以指向WML，jpg,gif,midi等信息类型。
平台接入客户可以将资源上传到自己的服务器，然后使用此接口将信息发送给手机用户。
WapPush支持联通用户。
返回值：
返回值大于0表示成功，小于0表示失败。如果失败，返回信息还包括失败原因的文字描述。
说明：
返回成功仅表示服务器已经成功接收客户提交的任务，并不表示对方已经收到短信。客户提交的短信会在服务器进行排队，然户按提交顺序发送出去。
示例：
sendsmsplus?User=test&Pass=pass&Mobile=13566668888&MsgType=5&Text=http://wap.waytide.com/%23Waytide
|
