功能介绍 / Introduction
- 短信验证码 · 最优通道，优先发送
- 短信通知 · 独享通道，业务隔离
- 三网合一短信通道，3秒可达
- 电信级运营保障，99%到达率、支持大容量高并发
- 超低资费，多种阶梯套餐任意选择
适用于各类网站、APP等短信验证码、通知短信等，自助化短信内容报备，申请即可使用。自定义签名、99%到达率、3秒送达、专业的客服团队保驾护航。
功能示例 / Example
业务场景 / Scenes
-
网站/APP
适用于网站/APP用户注册、登录、找回密码、支付等需要验证手机号码的环节。
-
电商物流
适用于电商平台的验证码信息、密码重置提醒、订单支付提醒、订单状态通知、发货通知等。
-
会议活动
可应用于开会或内部通知、面试通知、活动通知。
快速调用API / FastCall
推荐接口 / Recommend
-
金融短信
适用于发送金融、营销类短信
按实际订单收费
-
语音验证码
通过手机接听验证码实现验证功能
￥0.0399/次
-
身份证实名认证
检测姓名和身份证号是否一致，身份证验证。
￥0.1000/次 (每人限10份)
-
全国天气预报
全国3000多个省市的实时天气预报，未来7天、常用生活指数等
￥0.0010/次 (每人限1份)
请求参数说明：
| 名称 | 必填 | 类型 | 说明 | |
|---|---|---|---|---|
| mobile | 是 | string | 接收短信的手机号码 | |
| tpl_id | 是 | int | 短信模板ID，请参考个人中心短信模板设置 | |
| tpl_value | 是 | string | 变量名和变量值对，如：#code#=431515，整串值需要urlencode，比如正确结果为：%23code%23%3d431515。如果你的变量名或者变量值中带有#&=中的任意一个特殊符号，请先分别进行utf-8 urlencode编码后再传递， 详细说明> | |
| key | 是 | string | 应用APPKEY(应用详细页查询) | |
| dtype | 否 | string | 返回数据的格式,xml或json，默认json |
返回参数说明：
| 名称 | 类型 | 说明 | |
|---|---|---|---|
| error_code | int | 返回码 | |
| reason | string | 返回说明 |
JSON返回示例：
/****失败示例**/
{
"reason": "错误的短信模板ID,请通过后台确认!!!",
"result": [],
"error_code": 205402
}
/****成功示例**/
{
"reason": "短信发送成功",
"result": {
"count": 1, /*发送数量*/
"fee": 1, /*扣除条数*/
"sid": "23d6bc4913614919a823271d820662af" /*短信ID*/
},
"error_code": 0 /*发送成功*/
}
服务级错误码参照(error_code)：
| 错误码 | 说明 | |
|---|---|---|
| 205401 | 错误的手机号码 | |
| 205402 | 错误的短信模板ID | |
| 205403 | 网络错误,请重试 | |
| 205404 | 发送失败，具体原因请参考返回reason | |
| 205405 | 号码异常/同一号码发送次数过于频繁 | |
| 205406 | 不被支持的模板 |
系统级错误码参照：
| 错误码 | 说明 | 旧版本（resultcode） | |
|---|---|---|---|
| 10001 | 错误的请求KEY | 101 | |
| 10002 | 该KEY无请求权限 | 102 | |
| 10003 | KEY过期 | 103 | |
| 10004 | 错误的OPENID | 104 | |
| 10005 | 应用未审核超时，请提交认证 | 105 | |
| 10007 | 未知的请求源 | 107 | |
| 10008 | 被禁止的IP | 108 | |
| 10009 | 被禁止的KEY | 109 | |
| 10011 | 当前IP请求超过限制 | 111 | |
| 10012 | 请求超过次数限制 | 112 | |
| 10013 | 测试KEY超过请求限制 | 113 | |
| 10014 | 系统内部异常 (调用充值类业务时，请务必联系客服或通过订单查询接口检测订单，避免造成损失) | 114 | |
| 10020 | 接口维护 | 120 | |
| 10021 | 接口停用 | 121 |
错误码格式说明（示例：200201）：
| 2 | 002 | 01 | |
|---|---|---|---|
| 服务级错误（1为系统级错误） | 服务模块代码(即数据ID) | 具体错误代码 |
完整教学代码示例：
| 语言 | 标题 | 提供者 | 时间 |
|---|
常见问题：
| 内容 | 详细 | |
|---|---|---|
| 常见问题: | ## |
一、定义
建云短信API服务：由建云数据平台提供的短信API服务。
用户： 以任何形式使用建云的自然人、法人或其他组织。
二、用户保证
1.用户同意并保证，在本协议有效期内，建云有权于任何时间要求用户提交相关资质证明资料原件及/或其他资料信息，用户对其所提交信息的真实完整、合法有效性承担保证责任。
2. 用户同意并保证，合法并如约使用建云短信API服务。用户对其行为产生的任何法律责任自行独立承担，与建云无关。
三、用户的权利与义务
1. 用户有权就建云申请账号，用户注册账号，应向建云提供真实完整且合法有效的信息。 如用户信息发生任何变更，用户应于变更后书面通知建云并提供最新资料信息。
2. 用户需要自行保管其帐号和密码。用户帐号、密码使用权仅属于初始申请注册人，禁止赠与、借用、租用、转让或者售卖，如果用户进行此类操作导致密码泄露造成损失的，建云并不承担责任。
3. 用户应按使用建云的实际发送数量，根据建云页面公布资费标准向建云支付相应的费用。
4. 用户保证其所提供的手机号码列表的真实性、合法性、有效性及许可性，用户有义务对手机列表进行筛选。否则建云有权随时终止本协议。
5. 用户在使用建云短信API服务期间，承诺并保证：
（1） 遵守所有中华人民共和国法律法规和国际上有关互联网和短信的协议、规定、程序和惯例；
（2） 不利用建云短信API服务进行干扰或扰乱建云网络服务或其他正常使用；
（3） 不行使其他可能给建云带来任何不利影响的行为或者法律及政策禁止的行为。
6. 用户不得利用建云短信API服务发送以下内容的短信：
（1）接受方事先没有提出要求或者同意接受的广告等宣传性或营销性内容；
（2）含有病毒、恶意代码、色情、反动等不良信息或有害信息
（3）地产、医疗、教育、留学、移民等相关内容
（4）冒充任何人或机构，或以虚伪不实的方式谎称或使人误认为与任何人或任何机构有关。
（5）侵犯他人著作权或其他知识产权，或违反保密、雇佣或不披露协议披露他人商业秘密或保密信息。
7. 用户应对相关数据自行存储和备份并至少保留六十日。根据建云或国家主管部门的要求，用户应向其提供备份内容。用户使用建云短信API服务，不得于任何时间任何事件中使用建云的Logo、服务标记、域名及其他具有建云显著特征的标识。
8. 用户应当按照本协议以及建云不时公布的规定，妥善使用建云短信API服务并为其行为负责。因用户行为导致建云遭受诉讼、索赔及/或处罚的，用户应赔偿建云因此造成的全部损失。
9. 本协议一经生效建云即有权永久免费使用用户的商业名称、商标、Logo等信息作为案例宣传建云旗下的相关服务。
10. 用户同意接收来自建云的邮件及短信，包括但不限于商业推广信息等。
四、建云的权利与义务
1. 建云对用户行为无审核监督义务。因用户行为给建云造成的一切损失，建云有权向用户追偿。
2. 建云对其提供给用户的服务质量做出如下承诺：
（1）建云为客户发送的短信数量是真实可信的实际数量
（2）建云会向客户提供合理的建议和协助来帮助用户提高发送质量。
（3）建云会提供必要的客户投诉与答疑服务。
3. 建云有权随时调整建云短信API服务的资费，但该调整不会对用户已购买的服务产生影响。
4. 建云有权对建云短信API服务进行定期或不定期的升级或完善，但应提前在相关页面进行公告。如用户因此受到影响，建云无需为此承担任何责任。
5. 建云有权根据自己的判断对用户是否违反本协议约定及建云短信API服务使用规则做出认定。用户若有违反的，建云有权随时中止或终止本协议。建云无需就此征得用户同意或提前通知用户。
6. 因非建云原因导致的本协议提前终止，用户已经支付而尚未使用的费用建云有权不予退还。
7. 鉴于互联网服务的特殊性，对因不可抗力、第三方服务、黑客攻击、政策影响及其他任何非建云原因引起的服务中断、数据丢失等，建云均无需承担任何责任。
五、知识产权
1. 建云服务中包含的任何文字、图表、音频、视频和/或软件（包括但不限于软件中包含的图表、动画、音频、视频、界面实际、数据和程序、代码、文档）等信息或材料均受著作权法、商标法或其它法律法规的保护，未经相关权利人书面同意，用户不得以任何方式使用该等信息或材料，但出于使用建云服务目的而使用的除外。
2. 除本协议明确允许的以外，用户不得以任何形式或任何方式对建云服务部分或全部内容进行修改、出租、租赁、出借、出售、分发、复制、创作衍生品或用于任何商业用途。
3. 用户使用建云发布的信息不得侵犯任何第三人的知识产权，未经相关权利人之事先书面同意，用户不得以任何方式上传、发布、修改、传播或复制任何受著作权保护的材料、商标或属于其他人的专有信息。
4. 若您认为您的知识产权或其他合法权益被侵犯，请向建云提供以下资料：
（1） 对涉嫌侵权内容拥有知识产权或其他合法权益的权属证明；
（2） 权利人具体的主体资质和联络信息，包括个人的姓名、身份证或护照复印件、单位的营业执照复印件或者其他资质证明复印件、通信地址及电话号码等；
（3） 涉嫌侵权内容在本网站上的位置；
（4） 对侵权情况的详细描述；
（5） 在权利通知中加入如下关于通知内容真实性的声明：“由以上操作所引起的一切后果，与建云无关，由我本人/公司承担。”在签字或加盖公章后发往以下邮箱： jianyunfazhan
六、 隐私权
1. 保护用户的隐私是建云的一项基本政策。
2. 适用于用户的隐私的相关条款请参见 《隐私协议》
七、 免责声明
1. 鉴于网络服务的特殊性，建云不保证网络服务的绝对及时性、安全性和准确性，用户同意建云有权不经事先通知，随时变更、中断或终止部分或全部的网络服务而无论同意与否，建云对用户和任何第三人均无需承担任何责任。
2. 用户经由建云服务与广告商进行通讯联系或商业往来或参与促销活动，完全属于用户与广告商之间的行为，与建云没有任何关系，若因商业行为所产生之任何损害或损失，建云不承担任何责任。
3. 用户明确同意其使用建云服务所存在的风险及其后果将完全由其自己承担，建云对用户不承担任何责任。如因用户违反有关法律、法规或本协议项下的任何条款而给建云或任何其他第三人造成损失，用户同意承担由此造成的损害赔偿责任。
八、其他
1. 本协议的版权归建云，建云保留对本协议的一切解释和修改权利。
2. 本协议的订立、执行和争议的解决均应适用中华人民共和国法律。如双方就本协议内容或其执行发生任何争议，双方应尽量友好协商解决；协商不成时，任何一方均可向建云所在地有管辖权的人民法院提起诉讼。
3. 建云行使本协议的任何权利或规定，不构成对前述权利之放弃。
4. 如本协议中的任何条款完全或部分无效，本协议的其余条款仍有效并且有约束力。