python接入片云网短信验证--单条发送

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
}