python接入片云網(wǎng)短信驗(yàn)證
-
簽名和模板審核失敗, 就聯(lián)系客服, 客服會(huì)幫你通過
-
接入python的相關(guān)代碼
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 ) : """ 發(fā)送驗(yàn)證碼 :param code: 驗(yàn)證碼 :param mobile: 手機(jī)號(hào)碼 :return: """ params = { "apikey" : self . api_key , "mobile" : mobile , # 這個(gè)text的值要跟你模板內(nèi)容一模一樣 "text" : "【簽名】您的驗(yàn)證碼是%s。如非本人操作,請(qǐng)忽略本短信" % code } # 發(fā)送post請(qǐng)求 請(qǐng)求的地址self.single_send_url 發(fā)送的數(shù)據(jù)data=params response = requests . post ( self . single_send_url , data = params ) # response.text是json數(shù)據(jù) # 把json數(shù)據(jù)轉(zhuǎn)換成字典 re_dict = json . loads ( response . text ) print ( re_dict ) if __name__ == "__main__" : # 參數(shù)是你的apikey yunpian = YunPian ( apikey ) # 填寫你要發(fā)送的驗(yàn)證碼 和 手機(jī)號(hào)碼 yunpian . send_sms ( code , mobile )
云片網(wǎng)官網(wǎng)
國(guó)內(nèi)短信 API 列表
調(diào)用方式
| 接口 | 請(qǐng)求地址 | 描述 |
|---|---|---|
| 單條發(fā)送 |
https://sms.yunpian.com/v2/sms/single_send.json
|
一次發(fā)送一條短信,常用于短信驗(yàn)證、找回密碼、短信登錄、監(jiān)控報(bào)警 |
| 批量發(fā)送相同內(nèi)容 |
https://sms.yunpian.com/v2/sms/batch_send.json
|
批量發(fā)送訂單狀態(tài)通知,活動(dòng)信息群發(fā) |
| 指定模板單發(fā) |
https://sms.yunpian.com/v2/sms/tpl_single_send.json
|
指定模板傳入變量單發(fā) |
| 指定模板群發(fā) |
https://sms.yunpian.com/v2/sms/tpl_batch_send.json
|
指定模板傳入變量群發(fā) |
| 推送狀態(tài)報(bào)告 | / | 云片為您實(shí)時(shí)推送最新的短信發(fā)送狀態(tài)報(bào)告。此接口實(shí)時(shí)性高 |
| 獲取狀態(tài)報(bào)告 |
https://sms.yunpian.com/v2/sms/pull_status.json
|
您通過本接口定期獲取狀態(tài)報(bào)告 |
| 推送回復(fù)短信 | / | 云片為您實(shí)時(shí)推送最新的回復(fù)短信。此接口實(shí)時(shí)性高 |
| 獲取回復(fù)短信 |
https://sms.yunpian.com/v2/sms/pull_reply.json
|
您通過本接口定期獲取回復(fù)短信 |
| 添加模板 |
https://sms.yunpian.com/v2/tpl/add.json
|
通過接口添加模板 |
| 取模板 |
https://sms.yunpian.com/v2/tpl/get.json
|
獲取賬戶內(nèi)的全部模板 |
| 修改模板 |
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
|
通過接口修改簽名 |
| 查短信發(fā)送記錄 |
https://sms.yunpian.com/v2/sms/get_record.json
|
通過接口查詢短信發(fā)送記錄 |
| 注冊(cè)成功回調(diào) |
https://sms.yunpian.com/v2/sms/reg_complete.json
|
使用 v2/single_send.json 發(fā)送驗(yàn)證碼短信,用戶注冊(cè)成功后調(diào)用接口告訴云片用戶注冊(cè)成功。云片給出相應(yīng)報(bào)表和統(tǒng)計(jì)。 |
| 生成短鏈接 |
https://sms.yunpian.com/v2/short_url/shorten.json
|
使用此接口生成短鏈接 |
| 獲取短鏈接統(tǒng)計(jì) |
https://sms.yunpian.com/v2/short_url/stat.json
|
使用此接口獲取短鏈接點(diǎn)擊統(tǒng)計(jì) |
| 日賬單導(dǎo)出 |
https://sms.yunpian.com/v2/sms/get_total_fee.json
|
使用 v2/single_send.json 發(fā)送驗(yàn)證碼短信,用戶注冊(cè)成功后調(diào)用接口告訴云片用戶注冊(cè)成功。云片給出相應(yīng)報(bào)表和統(tǒng)計(jì)。 |
單條發(fā)送接口
提示:
- 因?yàn)檫\(yùn)營(yíng)商政策,請(qǐng)先在后臺(tái)完成報(bào)備簽名、模板及做相關(guān)設(shè)置(詳見接入引導(dǎo)),再開發(fā) API。
- 驗(yàn)證碼類短信,請(qǐng)?jiān)谑謾C(jī)驗(yàn)證環(huán)節(jié),加入行為驗(yàn)證碼,以免被惡意攻擊。
HTTP 頭信息:
Accept:application/json;charset=utf-8;
Content-Type:application/x-www-form-urlencoded;charset=utf-8;
請(qǐng)求
URL:https://sms.yunpian.com/v2/sms/single_send.json
注意:海外服務(wù)器地址 us.yunpian.com
訪問方式:POST
支持 https 與 http 兩種訪問,建議使用 https
請(qǐng)求參數(shù)
| 參數(shù)名 | 類型 | 是否必傳 | 是否默認(rèn)開放 | 描述 | 示例 |
|---|---|---|---|---|---|
| apikey | string | 是 | 是 | 用戶唯一標(biāo)識(shí),在管理控制臺(tái)獲取 | 9b11127a9701975c734b8aee81ee3526 |
| mobile | string | 是 | 是 | 接收的手機(jī)號(hào),僅支持單號(hào)碼發(fā)送,不需要帶+86 前綴 | 15205201314 |
| text | string | 是 | 是 | 需要發(fā)送的短信內(nèi)容,需要與已審核的短信模板相匹配 | 【云片網(wǎng)】您的驗(yàn)證碼是 1234 |
| extend | string | 否 | 否 | 下發(fā)號(hào)碼擴(kuò)展號(hào),純數(shù)字 | 001 |
| uid | string | 否 | 否 | 該條短信在您業(yè)務(wù)系統(tǒng)內(nèi)的 ID,如訂單號(hào)或者短信發(fā)送記錄流水號(hào)。默認(rèn)不開放,如有需要請(qǐng)聯(lián)系客服申請(qǐng)。 | 10001 |
| callback_url | string | 否 | 是 | 短信發(fā)送后將向這個(gè)地址推送(運(yùn)營(yíng)商返回的)發(fā)送報(bào)告。 如推送地址固定,建議在"數(shù)據(jù)推送與獲取”做批量設(shè)置。 如后臺(tái)已設(shè)置地址,且請(qǐng)求內(nèi)也包含此參數(shù),將以請(qǐng)求內(nèi)地址為準(zhǔn) |
http://your_receive_url_address
|
| register | boolean | 否 | 否 | 是否為注冊(cè)驗(yàn)證碼短信,如果傳入 true,則該條短信作為注冊(cè)驗(yàn)證碼短信統(tǒng)計(jì)注冊(cè)成功率,需聯(lián)系客服開通。 | true |
| mobile_stat | boolean | 否 | 是 | 若短信中包含云片短鏈接,此參數(shù)傳入 true 將會(huì)把短鏈接替換為目標(biāo)手機(jī)號(hào)的專屬鏈接,用于統(tǒng)計(jì)哪些號(hào)碼的機(jī)主點(diǎn)擊了短信中的鏈接,可在云片后臺(tái)查看。詳情參考短信點(diǎn)擊統(tǒng)計(jì)。 | true |
響應(yīng)
| 名稱 | 類型 | 描述 |
|---|---|---|
| code | integer | 0 代表發(fā)送成功,其他 code 代表出錯(cuò),詳細(xì)見"返回值說明"頁面 |
| msg | text | 例如"“發(fā)送成功”",或者相應(yīng)錯(cuò)誤信息 |
| count | integer | 發(fā)送成功短信的計(jì)費(fèi)條數(shù)(計(jì)費(fèi)條數(shù):70 個(gè)字一條,超出 70 個(gè)字時(shí)按每 67 字一條計(jì)費(fèi)) |
| fee | double | 扣費(fèi)金額,單位:元,類型:雙精度浮點(diǎn)型/double |
| unit | string | 計(jì)費(fèi)單位;例如:“RMB” |
| mobile | string | 發(fā)送手機(jī)號(hào) |
| sid | long(64 位) | 短信 id,64 位整型, 對(duì)應(yīng) Java 和 C#的 long,不可用 int 解析 |
Json 返回示例
{
"code"
:
0
,
"msg"
:
"發(fā)送成功"
,
"count"
:
1
,
"fee"
:
0.05
,
"unit"
:
"RMB"
,
"mobile"
:
"13200000000"
,
"sid"
:
3310228982
}
更多文章、技術(shù)交流、商務(wù)合作、聯(lián)系博主
微信掃碼或搜索:z360901061
微信掃一掃加我為好友
QQ號(hào)聯(lián)系: 360901061
您的支持是博主寫作最大的動(dòng)力,如果您喜歡我的文章,感覺我的文章對(duì)您有幫助,請(qǐng)用微信掃描下面二維碼支持博主2元、5元、10元、20元等您想捐的金額吧,狠狠點(diǎn)擊下面給點(diǎn)支持吧,站長(zhǎng)非常感激您!手機(jī)微信長(zhǎng)按不能支付解決辦法:請(qǐng)將微信支付二維碼保存到相冊(cè),切換到微信,然后點(diǎn)擊微信右上角掃一掃功能,選擇支付二維碼完成支付。
【本文對(duì)您有幫助就好】元

