python接入片云网短信验证
-
申请自己的签名和模板
-
签名和模板审核失败, 就联系客服, 客服会帮你通过
-
在你的系统设置里面IP白名单, 填写你的服务器ip
-
这个ip直接取浏览器搜索ip查看
-
接入python的相关代码
import requests import json class YunPian ( object ) : def __init__ ( self , api_key ) : self . api_key = api_key self . single_send_url = "https://sms.yunpian.com/v2/sms/single_send.json" def send_sms ( self , code , mobile ) : """ 发送验证码 :param code: 验证码 :param mobile: 手机号码 :return: """ params = { "apikey" : self . api_key , "mobile" : mobile , # 这个text的值要跟你模板内容一模一样 "text" : "【签名】您的验证码是%s。如非本人操作，请忽略本短信" % code } # 发送post请求 请求的地址self.single_send_url 发送的数据data=params response = requests . post ( self . single_send_url , data = params ) # response.text是json数据 # 把json数据转换成字典 re_dict = json . loads ( response . text ) print ( re_dict ) if __name__ == "__main__" : # 参数是你的apikey yunpian = YunPian ( apikey ) # 填写你要发送的验证码 和 手机号码 yunpian . send_sms ( code , mobile ) -
效果图
云片网官网
国内短信 API 列表
调用方式
| 接口 | 请求地址 | 描述 |
|---|---|---|
| 单条发送 |
https://sms.yunpian.com/v2/sms/single_send.json
|
一次发送一条短信，常用于短信验证、找回密码、短信登录、监控报警 |
| 批量发送相同内容 |
https://sms.yunpian.com/v2/sms/batch_send.json
|
批量发送订单状态通知，活动信息群发 |
| 指定模板单发 |
https://sms.yunpian.com/v2/sms/tpl_single_send.json
|
指定模板传入变量单发 |
| 指定模板群发 |
https://sms.yunpian.com/v2/sms/tpl_batch_send.json
|
指定模板传入变量群发 |
| 推送状态报告 | / | 云片为您实时推送最新的短信发送状态报告。此接口实时性高 |
| 获取状态报告 |
https://sms.yunpian.com/v2/sms/pull_status.json
|
您通过本接口定期获取状态报告 |
| 推送回复短信 | / | 云片为您实时推送最新的回复短信。此接口实时性高 |
| 获取回复短信 |
https://sms.yunpian.com/v2/sms/pull_reply.json
|
您通过本接口定期获取回复短信 |
| 添加模板 |
https://sms.yunpian.com/v2/tpl/add.json
|
通过接口添加模板 |
| 取模板 |
https://sms.yunpian.com/v2/tpl/get.json
|
获取账户内的全部模板 |
| 修改模板 |
https://sms.yunpian.com/v2/tpl/update.json
|
修改指定模板 |
| 删除模板 |
https://sms.yunpian.com/v2/tpl/del.json
|
删除指定模板 |
| 添加签名 |
https://sms.yunpian.com/v2/sign/add.json
|
通过接口添加签名 |
| 获取签名 |
https://sms.yunpian.com/v2/sign/get.json
|
通过接口获取签名 |
| 修改签名 |
https://sms.yunpian.com/v2/sign/update.json
|
通过接口修改签名 |
| 查短信发送记录 |
https://sms.yunpian.com/v2/sms/get_record.json
|
通过接口查询短信发送记录 |
| 注册成功回调 |
https://sms.yunpian.com/v2/sms/reg_complete.json
|
使用 v2/single_send.json 发送验证码短信，用户注册成功后调用接口告诉云片用户注册成功。云片给出相应报表和统计。 |
| 生成短链接 |
https://sms.yunpian.com/v2/short_url/shorten.json
|
使用此接口生成短链接 |
| 获取短链接统计 |
https://sms.yunpian.com/v2/short_url/stat.json
|
使用此接口获取短链接点击统计 |
| 日账单导出 |
https://sms.yunpian.com/v2/sms/get_total_fee.json
|
使用 v2/single_send.json 发送验证码短信，用户注册成功后调用接口告诉云片用户注册成功。云片给出相应报表和统计。 |
单条发送接口
提示：
- 因为运营商政策，请先在后台完成报备签名、模板及做相关设置(详见接入引导)，再开发 API。
- 验证码类短信，请在手机验证环节，加入行为验证码，以免被恶意攻击。
HTTP 头信息:
Accept:application/json;charset=utf-8;
Content-Type:application/x-www-form-urlencoded;charset=utf-8;
请求
URL：https://sms.yunpian.com/v2/sms/single_send.json
注意：海外服务器地址 us.yunpian.com
访问方式：POST
支持 https 与 http 两种访问，建议使用 https
请求参数
| 参数名 | 类型 | 是否必传 | 是否默认开放 | 描述 | 示例 |
|---|---|---|---|---|---|
| apikey | string | 是 | 是 | 用户唯一标识，在管理控制台获取 | 9b11127a9701975c734b8aee81ee3526 |
| mobile | string | 是 | 是 | 接收的手机号，仅支持单号码发送，不需要带+86 前缀 | 15205201314 |
| text | string | 是 | 是 | 需要发送的短信内容，需要与已审核的短信模板相匹配 | 【云片网】您的验证码是 1234 |
| extend | string | 否 | 否 | 下发号码扩展号，纯数字 | 001 |
| uid | string | 否 | 否 | 该条短信在您业务系统内的 ID，如订单号或者短信发送记录流水号。默认不开放，如有需要请联系客服申请。 | 10001 |
| callback_url | string | 否 | 是 | 短信发送后将向这个地址推送(运营商返回的)发送报告。 如推送地址固定，建议在"数据推送与获取”做批量设置。 如后台已设置地址，且请求内也包含此参数，将以请求内地址为准 |
http://your_receive_url_address
|
| register | boolean | 否 | 否 | 是否为注册验证码短信，如果传入 true，则该条短信作为注册验证码短信统计注册成功率，需联系客服开通。 | true |
| mobile_stat | boolean | 否 | 是 | 若短信中包含云片短链接，此参数传入 true 将会把短链接替换为目标手机号的专属链接，用于统计哪些号码的机主点击了短信中的链接，可在云片后台查看。详情参考短信点击统计。 | true |
响应
| 名称 | 类型 | 描述 |
|---|---|---|
| code | integer | 0 代表发送成功，其他 code 代表出错，详细见"返回值说明"页面 |
| msg | text | 例如"“发送成功”"，或者相应错误信息 |
| count | integer | 发送成功短信的计费条数(计费条数：70 个字一条，超出 70 个字时按每 67 字一条计费) |
| fee | double | 扣费金额，单位：元，类型：双精度浮点型/double |
| unit | string | 计费单位；例如：“RMB” |
| mobile | string | 发送手机号 |
| sid | long(64 位) | 短信 id，64 位整型， 对应 Java 和 C#的 long，不可用 int 解析 |
Json 返回示例
{
"code"
:
0
,
"msg"
:
"发送成功"
,
"count"
:
1
,
"fee"
:
0.05
,
"unit"
:
"RMB"
,
"mobile"
:
"13200000000"
,
"sid"
:
3310228982
}
