售前咨询售后咨询

热线电话

0571 — 8695 0251

接入流程

一、注册亿佰云通讯,登录获得API key。

二、完成开发者认证,进行签名模板报备

三、下载SDK对接平台,调用云通讯平台开放接口。

SDK下载

语言github地址下载地址
Java点击查看Java下载
PHP点击查看PHP下载
Python点击查看Python下载
C#点击查看C#下载

注:如没有您使用语言的SDK,您可以根据下方短信API开发接口。

调用说明

短信API通过HTTP POST方式调用,请求和响应均为JSON格式。请求必须带有 apikey 属性,apikey 为用户的唯一标识,可以在软件首页下方查看。

短信API

1.发送通知短信
功能说明:

发送前,需要在软件内报备模板,系统会自动匹配审核通过的模板,如果匹配到任何一个模板即可发送,否则会发送失败。

请求地址:
https://sms.100sms.cn/api/sms/batchSubmit
请求参数:
名称类型是否必须描述
apikeystring用户唯一标识
submits[]list发送信息列表,最多1000个
submits[].mobilestring手机号码
submits[].messagestring

短信内容

短信格式为:【短信签名】短信内容。如:【亿佰云通讯】您的验证码是1234。短信签名必须在短信开头,并加上中文全角中括号。短信签名应与公司名称或品牌名称相符。短信签名也会计算字数。
请求示例:
POST:https://sms.100sms.cn/api/sms/batchSubmit
Content-Type: application/json
{
  "apikey": "a71bf24527ad11e6b5b9ac853dae864c",
  "submits": [{
    "mobile": "13800000001",
    "message": "【亿佰云通讯】您的验证码是1234"
  }, {
    "mobile": "13800000001",
    "message": "【亿佰云通讯】您的验证码是5678"
  }]
}
响应参数:
名称类型描述
codeint返回状态
messagestring返回信息
response[]list响应内容,与发送信息列表对应
response[].codestring单个号码发送状态
response[].messagestring单个号码发送信息
response[].mobilestring手机号码
response[].taskIdstring任务id,用于匹配状态报告
响应示例:
{
  "code": 200,
  "message": "发送成功",
  "response": [{
    "code": 200,
    "message": "发送成功",
    "mobile": "13800000001",
    "taskId": "9752328968043757569"
  }, {
    "code": 410,
    "message": "手机号格式错误",
    "mobile": "13800000001",
    "taskId": "9752328968043757570"
  }]
}
2.获取状态报告
功能说明:

调用此接口可以获取72小时内的状态报告,已成功获取的数据将会删除,不会再次返回。

请求地址:
https://sms.100sms.cn/api/sms/pullStatusReport
请求参数:
名称类型是否必须描述
apikeystring用户唯一标识
请求示例:
POST:https://sms.100sms.cn/api/sms/pullStatusReport
Content-Type: application/json
{
  "apikey":"a71bf24527ad11e6b5b9ac853dae864c"
}
响应参数:
名称类型描述
codeint返回状态
messagestring返回信息
response[]list响应内容
response[].taskIdstring任务id
response[].mobilestring手机号码
response[].reportstring状态报告
response[].reportTimelong状态报告时间戳
响应示例:
{
  "code": 1,
  "message": "拉取成功",
  "response": [{
    "taskId": 9752328968043757569,
    "mobile": "13800000001",
    "report": "DELIVRD",
    "reportTime": 1464784505529
  }, {
    "taskId": 9752328968043757569,
    "mobile": "13800000001",
    "report": "DELIVRD",
    "reportTime": 1464784516136
  }]
}
3.获取回复
功能说明:

调用此接口可以获取72小时内的回复短信,已成功获取的数据将会删除,不会再次返回。

请求地址:
https://sms.100sms.cn/api/sms/pullReply
请求参数:
名称类型是否必须描述
apikeystring用户唯一标识
请求示例:
POST:https://sms.100sms.cn/api/sms/pullReply
Content-Type: application/json
{
  "apikey":"a71bf24527ad11e6b5b9ac853dae864c"
}
响应参数:
名称类型描述
codeint返回状态
messagestring返回信息
response[]list响应内容
response[].mobilestring手机号码
response[].messagestring回复内容
response[].replyTimelong回复时间戳
响应示例:
{
  "code": 1,
  "message": "拉取成功",
  "response": [{
    "mobile": "13800000001",
    "message": "好的",
    "replyTime": 1464784505529
  }, {
    "mobile": "13800000001",
    "message": "知道了",
    "replyTime": 1464784516136
  }]
}
4.错误响应
响应参数:
名称类型描述
codeint错误代码
messagestring错误信息
responselist响应内容
响应示例:
{
  "code": 500,
  "message": "服务器异常",
  "response": null
}
错误列表:
错误代码 code错误信息 message处理方法
101用户缺少签名联系客服添加签名
102用户缺少模板提交模板
500服务器异常联系客服
400缺少必须参数补充必须传入的参数
401缺少apikey传入apikey
402apikey不存在提供正确的apikey或联系客服
403短信内容格式错误根据要求修改短信格式
404模板匹配失败添加相应模板或修改短信模式
405提交超过1000条不要提交超过1000条
410手机号格式错误检查该手机号填写真确的手机号码
411该号码对应的短信模板匹配失败添加相应模板或修改短信模式
412该号码短信内容格式错误根据要求修改短信格式
413余额不足充值
414短信内容匹配签名错误添加相应签名或修改短信签名模式

默认模板

序列模板内容模板参数值含义
1您的验证码是#code#code:验证码
2您的验证码是#code#。如非本人操作,请忽略本短信code:验证码
3亲爱的#name#,您的验证码是#code#。如非本人操作,请忽略本短信

name:会员名

code:验证码

4亲爱的#name#,您的验证码是#code#。有效期为#hour#小时,请尽快验证

name:会员名

code:验证码

hour:时长

5感谢您注册#app#,您的验证码是#code#

app:产品名或网站名

code:验证码

6欢迎使用#app#,您的手机验证码是#code#。本条信息无需回复

app:产品名或网站名

code:验证码

7正在找回密码,您的验证码是#code#code:验证码
8验证码是#code#。如非本人操作,请致电#tel#

code:验证码

tel:电话号码

9#code#(#app#验证码,请完成验证),如非本人操作,请忽略本短信

code:验证码

app:产品名或网站名

隐私协议

杭州夏猫科技有限公司(shomop.com 以下简称为:本网站)隐私权保护声明系本网站保护用户个人隐私的承诺。鉴于网络的特性,本网站将无可避免地与您产生直接或间接的互动关系,故特此说明本网站对用户个人信息所采取的收集、使用和保护政策,请您务必仔细阅读:


1. 使用者非个人化信息

我们将通过您的IP地址来收集非个人化的信息,例如 您的浏览器性质、操作系统种类、给您提供接入服务的ISP的域名等,以优化在您计算机屏幕上显示的页面。通过收集上述信息,我们亦进行客流量统计,从而改进网站的管理和服务。


2. 个人资料

I. 当您在本网站进行用户注册登记等活动时,在您的同意及确认下,本网站将通过注册表单等形式要求您提供一些个人资料,这些个人资料包括:

A. 个人识别资料:如姓名、性别、年龄、出生日期、身份证号码(或护照号码)、电话、通信地址、住址、电子邮箱等。

B. 个人背景:职业、教育程度、收入状况等。

C. 如果您是公司或组织用户,还需提供企业营业执照复印件加盖公章,法人代表身份证明加盖公章等资料

II. 请了解,在未经您同意及确认之前,本网站不会将您为参加本网站之特定活动所提供的资料利用于其它目的。惟按下列第6条规定应政府及法律要求披露时不在此限。


3. 信息安全

I. 本网站将对您所提供的资料进行严格的管理及保护,本网站将使用相应的技术,防止您的个人资料丢失、被盗用或遭篡改。

II. 本网站得在必要时委托专业技术人员代为对该类资料进行电脑处理,以符合专业分工时代的需求。如本网站将电脑处理之通知送达予您,而您未在通知规定的时间内主动明示反对,本网站将推定您已同意。


4. 用户权利

I. 您对于自己的个人资料享有以下权利:

A. 随时查询及请求阅览;

B. 随时请求补充或更正;

C. 随时请求删除或者被电脑处理及利用。

II. 针对以上权利,本网站为您提供相关服务,您可以发送电子邮件至p@shomop.com


5. 限制原则

本网站惟在符合下列条件之一,方对收集之个人资料进行必要范围以外之利用:

I. 已取得您的书面同意

II. 为免除您在生命、身体或财产方面之急迫危险

III. 为防止他人权益之重大危害

IV. 为增进公共利益且无害于您的重大利益


6. 个人资料之披露

当政府机关依照法定程序要求本网站披露个人资料时,本网站将根据执法单位之要求或为公共安全之目的提供个人资料。在此情况下之任何披露,本网站均不承担任何责任。


7. 未成年人

本网站仅向年满18周岁的,具有独立民事责任能力的自然人提供服务。


8. cookie

I. Cookies是指一种技术,当使用者访问设有Cookies装置的本网站时,本网站之服务器会自动发送Cookies至您的浏览器内,并储存到您的电脑硬盘内,此Cookies负责记录日后您到访本网站的种种活动、个人资料、浏览习惯、消费习惯甚至信用记录。

II. 运用Cookies技术,本网站能够为您提供更加周到的个性化服务。本网站将会运用Cookies追访您的购物喜好,从而向您提供感兴趣的信息资料或储存密码,以便您造访本网站时不必每次重复输入密码。


9. 免责

除上述第6条规定属免责外,下列情况时本网站亦毋需承担任何责任:

I. 由于您将用户密码告知他人或与他人共享注册帐户而导致的任何个人资料泄露。

II. 任何由于黑客攻击、计算机病毒侵入或发作、因政府管制而造成的暂时性关闭等影响网络正常经营之不可抗力而造成的个人资料泄露、丢失、被盗用或被篡改等。

III. 由于与本网站链接的其它网站所造成之个人资料泄露及由此而导致的任何法律争议和后果。

杭州夏猫科技有限公司 2016.5

服务协议

请您需仔细阅读本协议,无论是否实际阅读,您使用亿佰·云通讯平台即表示同意并接受本协议。


第一条 定义


I. 亿佰·云通讯平台:是由杭州夏猫科技有限公司(以下简称夏猫)提供并运营的短信开放平台。

II. 开发者:调用平台API接口进行应用开发的主体,包括公司和个人。


第二条 用户保证


I. 您同意并保证,在本协议有效期内,夏猫有权于任何时间要求您提交相关资质证明资料原件及/或其他资料信息,您对所提交信息的真实完整、合法有效性承担保证责任。

II. 您同意并保证,合法并如约使用夏猫。您对行为产生的任何法律责任自行独立承担,与夏猫无关。


第三条 用户权利与义务

I. 您有权就亿佰·云通讯平台申请账号,注册账号,应向夏猫提供真实完整且合法有效的信息。 如您的信息发生任何变更,应于变更后书面通知夏猫并提供最新资料信息。

II. 您需要自行保管帐号和密码。帐号、密码使用权仅属于初始申请注册人,禁止赠与、借用、租用、转让或者售卖,如果您进行此类操作导致密码泄露造成损失的,夏猫并不承担责任。

III. 您应按使用亿佰·云通讯平台的实际发送数量,根据亿佰·云通讯平台页面公布资费标准向夏猫支付相应的费用。

IV. 您保证所提供的手机号码列表的真实性、合法性、有效性及许可性,您有义务对手机列表进行筛选。否则夏猫有权随时终止本协议。

V. 您在使用亿佰·云通讯平台期间,承诺并保证:

A. 遵守所有中华人民共和国法律法规和国际上有关互联网和短信的协议、规定、程序和惯例;

B. 不利用亿佰·云通讯平台进行干扰或扰乱夏猫网络服务或其他正常使用;

C. 不行使其他可能给夏猫带来任何不利影响的行为或者法律及政策禁止的行为。

VI. 您不得利用亿佰·云通讯平台发送以下内容的短信:

A. 接受方事先没有提出要求或者同意接受的广告等宣传性或营销性内容;

B.含有病毒、恶意代码、色情、反动等不良信息或有害信息;

C. 地产、医疗、教育、留学、移民等相关内容;

D. 冒充任何人或机构,或以虚伪不实的方式谎称或使人误认为与任何人或任何机构有关;

E. 侵犯他人著作权或其他知识产权,或违反保密、雇佣或不披露协议披露他人商业秘密或保密信息。

VII. 您应对相关数据自行存储和备份并至少保留六十日。根据夏猫或国家主管部门的要求,您应向其提供备份内容。您使用亿佰·云通讯平台,不得于任何时间任何事件中使用夏猫的Logo、服务标记、域名及其他具有夏猫显著特征的标识。

VIII. 您应当按照本协议以及夏猫不时公布的规定,妥善使用亿佰·云通讯平台并为您的行为负责。因您的行为导致夏猫遭受诉讼、索赔及/或处罚的,您应赔偿夏猫因此造成的全部损失。

IX. 经您同意,本协议一经生效夏猫即有权永久免费使用您的商业名称、商标、Logo等信息作为案例宣传夏猫旗下的相关服务。

X. 您同意接收来自夏猫的邮件及短信,包括但不限于商业推广信息等。


第四条 夏猫的权利和义务

I. 夏猫对您的行为无审核监督义务。因您的行为给夏猫造成的一切损失,夏猫有权向您追偿。

II. 夏猫对提供给您的服务质量做出如下承诺:

A. 夏猫为客户发送的短信数量是真实可信的实际数量;

B. 夏猫会向客户提供合理的建议和协助来帮助您提高发送质量;

C. 夏猫会提供必要的客户投诉与答疑服务。

III. 夏猫有权随时调整夏猫的资费,但该调整不会对您已购买的服务产生影响。

IV. 夏猫有权对亿佰·云通讯平台进行定期或不定期的升级或完善,但应提前在相关页面进行公告。如您因此受到影响,夏猫无需为此承担任何责任。

V. 夏猫有权根据自己的判断对您是否违反本协议约定及夏猫使用规则做出认定。您若有违反的,夏猫有权随时中止或终止本协议。夏猫无需就此征得您同意或提前通知您。因非夏猫原因导致的本协议提前终止,您已经支付而尚未使用的费用夏猫有权不予退还。

VI. 鉴于互联网服务的特殊性,对因不可抗力、第三方服务、黑客攻击、政策影响及其他任何非夏猫原因引起的服务中断、数据丢失等,夏猫均无需承担任何责任。


第五条 保密条款

I. 本协议所称保密信息,是指一方(以下简称“接受方”)从对方(以下简称“披露方”)取得的、获知的、或因双方履行本协议而共同创造且具有不可分割性的商业秘密(包括财务秘密)、技术秘密、经营诀窍和(或)其他应予保密的信息和资料,无论上述信息和资料以何种形式或载于何种载体,无论披露方在披露时是否以口头、图像或书面等方式表明其具有保密性。

II. 本协议有效期内及其终止后五年内,任何一方均不应向任何第三方披露、泄漏或提供保密信息。

III. 甲乙双方应采取适当措施妥善保存对方提供的保密信息,措施的审慎程度不少于其保护自身的保密信息时的审慎程度。甲乙双方仅能将保密信息用于与本协议项下的有关用途或目的。

IV. 双方保证保密信息仅可在各自一方从事该业务的负责人和雇员范围内知悉。在双方上述人员知悉该保密信息前,应向其提示保密信息的保密性和应承担的义务,并以可证明的方式表明上述人员确实承担本协议项下的保密责任。

V. 如确有必要,接受方应按照保密信息披露方的指示将含有保密资料的所有文件或其他资料归还给披露方,或按其指示予以销毁。

VI. 本条上述限制条款不适用于以下情况:

A. 在签署本协议之时或之前,该保密信息已以合法方式属接受方所有;

B. 保密信息在通知给接受方时,已经公开或能从公开领域获得;

C. 保密信息是接受方从与其没有保密或不透露义务的第三方获得的;

D. 在不违反本协议项约定责任的前提下,该保密信息已经公开或能从公开领域获得;

E. 该保密信息是接受方或其关联或附属公司独立开发,而且未从通知方或其关联或附属公司获得的信息中获益;

F. 接受方应法院或其它法律、行政管理部门要求披露的信息(通过口头提问、询问、要求资料或文件、传唤、民事或刑事调查或其他程序)因而透露保密信息,在该种情况发生时,接受方应立即向披露方发出通知,并作出必要说明。

VII. 甲乙双方亦对本协议的具体内容负有保密责任。

VIII. 甲乙双方为了履行本协议而进行的沟通、通知、告知等文件传递或文件交换,应由双方妥善保存,不得用于不利于双方开展业务的目的。双方不得诋毁诽谤对方,亦不得在公开场合以攻击对方为目的发布不利于双方的言论。


第六条 知识产权

I. 亿佰·云通讯平台上所有内容,包括但不限于著作、图片、档案、资讯、资料、网站架构、网站画面的安排、网页设计,均由夏猫或其他权利人依法拥有其知识产权。非经夏猫或其他权利人书面同意任何人不得擅自使用、修改、复制、公开传播、改变、散布、发行或公开发表平台程序或内容

II. 未经夏猫同意,您不得擅自使用您或其关联公司的商标、名称以及夏猫相关商标及其标识。

III. 开发者独立开发的应用的知识产权归其该所有人所有;权利人同意授予夏猫及其关联公司在全球范围内享有免费的、永久性的、不可撤消的、非独家的、可转让、可分许可的许可,许可亿佰·云通讯平台使用、调用、演示产品等。该许可不受双方合作终止以及本协议终止的影响。

IV. 本协议项目合作涉及的系统、代码、数据、品牌等,均由双方各自依法拥有知识产权,未经权利拥有一方的书面同意,另一方不得擅自使用、修改、复制、公开传播、发行,否则,权利拥有一方有权立即终止本协议并要求对方赔偿全部损失(包括但不限于调查取证费用、公证费用、律师费等)。

V. 您不得将夏猫基于本项目合作开放的技术接口、源代码及算法等进行反向工程、反汇编、重构、反编译、翻译、修改、复制,或者在未经明确允许的情况下创作衍生作品。


第七条 免责条款

I. 您充分理解,使用夏猫的通信通道涉及到因特网、电信运营商的网络服务,可能会受到各个环节不稳定因素的影响,因此您同意,对因停电、计费系统故障、传输线路故障、通信故障及通信线路故障、检修升级、计算机错误或病毒、黑客攻击、信息损坏、数据丢失或其它在夏猫合理控制范围之外的原因所造成的中断、延迟或停顿等服务问题,夏猫不承担责任;为防止发生意外,请您不要仅依靠网络作为重要情况下使用的唯一通信工具,对于您利用夏猫服务开展活动而造成的损失,双方同意夏猫不向您或任何第三方承担责任。

II. 夏猫有权定期或不定期地对提供网络服务的平台或相关的设备进行检修或者维护,如因此类情况而造成网络服务在合理时间内的中断或暂停,夏猫无需为此承担任何责任。

III. 如发生下述任一情况而导致服务中断及您损失的,夏猫不承担责任:

A. 发生不可抗力情形的;

B. 黑客攻击、计算机病毒侵入或发作的;

C. 计算机系统遭到破坏、瘫痪或无法正常使用的;

D. 因政府管制而造成中止或终止服务的;

E. 其它非因夏猫的过错而引起的。

IV. 在任何情况下,夏猫均不就因使用亿佰·云通讯平台提供的服务所发生的任何间接性、后果性、惩戒性、偶然性、特殊性的损害,包括您使用亿佰·云通讯平台服务而遭受的利润损失承担责任(即使您已事先被告知该等损害发生的可能性)。


第八条 不可抗力

因不可抗力或者其他意外事件,使得本协议的履行不可能、不必要或者无意义的,遭受不可抗力、意外事件的一方不承担责任。不可抗力、意外事件是指不能预见、不能克服并不能避免且对一方或双方当事人造成重大影响的客观事件,包括但不限于自然灾害如洪水、地震、瘟疫流行等以及社会事件如战争、动乱、政府行为、电信主干线路中断、黑客、网路堵塞、电信部门技术调整和政府管制等。


第九条 协议的终止


I. 在您违反本协议约定或平台规则、规范时,夏猫有权随时暂停或终止向您提供平台服务。如您后续再直接或间接或以他人名义注册并登录平台的,夏猫有权直接单方面暂停或终止提供本协议下服务。

II. 如本协议服务终止,夏猫有权保留或删除您账号中的任何信息和全部相关数据,包括服务终止前您尚未完成的任何数据。

III. 因法律法规或政策原因导致平台业务无法继续运营的,双方合同自动解除,互不承担违约责任。

IV. 由于客观原因,致使您不能使用服务时,夏猫不承担任何责任,包括但不限于

A. 自然灾害,如台风、洪水、冰雹等;

B. 政府行为,如征收、征用等;

C. 社会异常事件,如罢工、骚乱等;

D. 计算机病毒或黑客攻击、互联网络、通信线路等原因造成服务中断。

V. 鉴于通信服务的特殊性和不可控性,夏猫可能随时中断或终止部分或全部的服务。如出现以上情形,除本协议所述不可抗拒因素外,夏猫将以合理的方式通知您。


第十条 违约责任

I. 任何一方未履行本协议项下的任何一项条款均被视为违约。违约方应按照本协议的相关约定,依法承担相应违约责任。

II. 除本协议另有约定外,任何一方违反其于本协议项下的陈述、承诺、保证或义务,而使另一方遭受任何诉讼、纠纷、索赔、处罚等的,违约方应负责解决,使另一方发生任何费用、额外责任或遭受经济损失的,应当负责赔偿。如一方发生违约行为,守约方可以书面通知方式要求违约方在指定的时限内停止违约行为,要求其消除影响。如违约方未能按时停止违约行为,则守约方有权立即终止本协议。

III. 如果因您违反本协议,而导致任何其他第三方遭受任何损失并引起纠纷,且该等纠纷解决的结果最终导致夏猫承担了任何责任,则您全额赔偿夏猫受到的损失。涉及第三方纠纷时,夏猫应及时知会您,双方共同协商,本着友好互谅的原则进行处理。


第十一条 争议解决

本协议履行中若发生争议,双方应当本着互谅互让的原则,协商解决。协商不成的,任何一方均有权向杭州市余杭区人民法院提起诉讼。


第十二条 协议的生效、续签及其他

I. 本协议内容包括协议正文及所有夏猫已经发布的或将来可能发布的平台相关规则。上述规则为本协议不可分割的一部分,与本协议正文具有同等法律效力。

II. 双方未行使或未执行本协议任何权利或规定,不构成对前述权利之放弃。

III. 本协议项下夏猫对开发者所有的通知均可通过网页公告、电子邮件、手机短信或常规的信件传送等方式进行;该等通知于发送之日视为已送达收件人。

IV. 本协议如有的调整和更新会提前7天在本网站做网页公告,如果您不接受更新后的内容,可以在7天之内邮件或书面告知平台并履行终止服务相应的责任。如果7天之内平台未收到终止服务的申请,默认您同意协议的调整和更新。

V. 若本协议中部分条款因任何原因而被认定无效,此种无效条款并不影响其他条款的有效性,且此种无效条款应自始视为不存在。

VI. 夏猫有权根据业务调整情况将本协议项下的全部权利义务一并转移给其关联公司,转让将以本协议规定的方式通知您。

VII. 协议终止后,有关知识产权、数据信息保密的条款不因协议的终止而终止。

杭州夏猫科技有限公司 2016.5