在短信服務中,創建自定義簽名是發送通知、驗證信息和其他類型消息的重要步驟。萬維易源提供的“三網短信驗證碼”API為開發者和企業提供了高效、便捷的自定義簽名創建服務,可以通過簡單的接口調用提交簽名給運營商審核。本文將詳細介紹如何使用該API,以及其核心功能和調用方法。
一、API概述
1. 接入點說明(以創建短信簽名為例)
- 功能:短信API接口,自定義創建短信簽名提交給運營商審核。
- 審核周期:一般3-5個工作日。
- 要求:需提交身份證正面照到客服處。
- 用途:提供了一種簡便的方式來發送通知、驗證信息和其他類型的消息。
2. 接口地址
https://route.showapi.com/28-16?appKey={your_appKey}
請將 {your_appKey}
替換為你在萬維易源平臺申請的個人 appKey
。
二、請求參數
以下是提交自定義簽名創建任務所需的請求參數:
參數名稱 | 類型 | 示例值 | 必須 | 描述 |
---|---|---|---|---|
title | String | 易源數據 | 是 | 模板簽名,使用UTF-8編碼(3-8個字符)。 |
use_for | String | 1 | 是 | 使用對象:1 自用,2 他用。 |
use_for_des | String | 1 | 是 | 簽名用途:1 已備案網站2 已上線APP3 公眾號或小程序4 電商平臺店鋪名5 已注冊商標名6 其它用途。 |
legal_name | String | (法定代表人姓名) | 是 | 營業執照法定代表人姓名(必填)。 |
legal_ID | String | (法定代表人身份證號) | 是 | 營業執照法定代表人身份證號(必填)。 |
legal | String | (法定代表人身份證正面照base64) | 是 | 營業執照法定代表人身份證正面照base64(必填)。 |
notiPhone | String | (聯系人號碼) | 是 | 聯系人號碼。 |
biz | String | (營業執照圖片base64) | 是 | 該簽名對應營業執照圖片base64,格式:jpg、png。 |
use_for_explain | String | https://www.showapi.com | 是 | 簽名用途描述(產品鏈接等)。 |
三、返回參數
以下是接口返回的參數及其描述:
參數名稱 | 類型 | 示例值 | 描述 |
---|---|---|---|
ret_code | String | 0 | 成功標記:0 表示成功,其他表示失敗。 |
remark | String | 簽名信息提交成功,請等待管理員審核,周期為3-5個工作日! | 備注信息。 |
title | String | 4324234 | 簽名。 |
四、調用示例
以下是一個使用 curl
命令調用該接口的示例:
curl 'https://route.showapi.com/28-16?appKey=your_appKey' \-H 'Content-Type: application/x-www-form-urlencoded' \-d 'use_for_des=1' \-d 'title=%E6%98%93%E6%BA%90%E6%95%B0%E6%8D%AE' \-d 'legal_ID=' \-d 'use_for_explain=https%3A%2F%2Fwww.showapi.com' \-d 'legal=' \-d 'notiPhone=' \-d 'biz=' \-d 'legal_name=' \-d 'use_for=1'
請將 your_appKey
替換為你在萬維易源平臺申請的 appKey
。
五、返回示例
以下是接口返回的JSON示例:
{"showapi_res_code": 0,"showapi_res_error": "","showapi_res_id": "ce135f6739294c63be0c021b76b6fbff","showapi_res_body": {"ret_code": "0","remark": "簽名信息提交成功,請等待管理員審核,周期為3-5個工作日!","title": "4324234"}
}
六、獲取 appKey
要獲取 appKey
,請訪問萬維易源的控制臺頁面:
查看 appKey
七、總結
萬維易源的“三網短信驗證碼”API為開發者和企業提供了一個高效、便捷的工具,可以通過簡單的接口調用提交自定義簽名給運營商審核。通過該API,可以快速創建并提交簽名,適用于短信通知、驗證信息等多種場景。希望本文能幫助你更好地了解和使用該API。如果你有任何問題或需要進一步的幫助,請隨時訪問萬維易源的官方文檔或聯系技術支持。