<sup id="6k0c4"></sup>
<ul id="6k0c4"></ul>
  • <ul id="6k0c4"></ul>
  • <ul id="6k0c4"></ul>
  • <strike id="6k0c4"><menu id="6k0c4"></menu></strike>

    互億通信 · API接口文檔

    彩信營銷-API文檔


    彩信營銷接口文檔下載:  點擊下載

    1.概要

    1.1 文檔說明

    本文檔主要提供給互億平臺的用戶對接接口的使用說明,開發者可以利用 ihuyi 提供的 HTTP 接口,調用 ihuyi 的營銷彩信服務。

    1.2 接口內容

    本文檔包含彩信批量提交、余額查詢、彩信模板提交、回執推送、上行推送、模板審核推送。

    1.3 提交方式

    POST

    1.4 加密方式

    1、采用HTTPS協議提交請求
    2、通過MD5動態簽名方式加密

    1.5 api id / api key

    登錄用戶中心,進入“營銷彩信”模塊,在產品概覽頁面右側獲取,如下圖所示:

    1.6 彩信模版

    彩信模板是對您將要發送的彩信進行相似性提取后的內容。

    注意:付費用戶可以通過左側導航【營銷彩信-彩信發送】-【模版管理】新增彩信模板運營商審核通過之后即可正式使用。

    1.7 彩信簽名

    彩信簽名是在【】加上您的公司名稱或店鋪名稱的標識符,例如:【互億無線】。根據電信基礎運營商的規定,每條彩信必須附加彩信簽名,否則將無法正常發送。

    2. 公共請求參數(json格式)

    參數 類型 是否必填 說明
    api_id string Api的ID 如:2RYN7CQHL1M*****
    signature string 請求驗證加密簽名(非彩信簽名);
    簽名生成方式:
    僅公共參數以ASCII碼從小到大排序值,key=value,多值以"&"隔開,拼接之后md5 32位小寫; 如:md5(api_id=xxxx&api_key=xxxx&request_id=xxxx×tamp=xxxxxxx)
    timestamp int 東八時區;10位時間戳,時間允許相差±60S
    golang: time.Now().Unix()
    php: time()
    request_id string 請求方請求ID,建議使用唯一ID,比如使用uuid;我方系統會2小時內去重驗證處理,防止網絡重復攻擊;

    3. 彩信批量提交接口

    3.1 協議說明

    協議類目 說明
    請求方式 POST
    編碼格式 UTF-8
    Content-Type application/json

    3.2 請求地址

    https://api.ihuyi.com/mms/v1/batchSend

    3.3 請求參數(json格式,需要包含公共請求參數)

    參數 類型 是否必填 說明
    product_id int 產品ID,如:1001
    phone Array 手機號數組(最多1萬個號碼)如:["18800000000","18800000001"]
    sign_name string 是/否 彩信簽名(template_id未填寫則必填)
    title string 是/否 彩信標題(template_id未填寫則必填)
    content array<[][]DataItem> 是/否 彩信內容和模板ID必須傳入1個;當彩信內容和模板ID都傳入時,傳入內容生效,模板ID屬性失效 彩信元素DataItem結構:(具體參照文檔9.01)
    參數 類型 描述
    con_type int 內容類型
    ext_type string 文件擴展名
    data string 數據
    template_id int 是/否 模板ID(內容為空則必填)
    send_time string 定時發送時間 2020-08-26 16:08:14

    3.4 返回參數(json格式)

    參數 類型 說明
    task_id string 下發批次ID,推送回執相關會用作關聯
    code string 狀態碼,OK表示發送成功,其他則是錯誤
    message string 消息內容

    4. 余額查詢接口

    4.1 請求地址

    https://api.ihuyi.com/mms/v1/balance

    4.2 返回參數(json格式)

    參數 類型 說明
    task_id string 下發批次ID,推送回執相關會用作關聯
    code string 狀態碼,OK表示發送成功,其他則是錯誤
    message string 消息內容
    data array 多個數組方式返回
    DataItem結構:
    參數 類型 描述
    product_id int 產品ID
    product_name string 產品名稱
    balance float 余額

    示例:

    {

        "code": "OK",

        "message": "請求成功",

        "data": [

            {

                "product_id": 1018,

                "product_name": "營銷彩信-房產類",

                "balance": 188888

            },

            {

                "product_id": 1020,

                "product_name": "營銷彩信-商超類",

                "balance": 200000

            }

        ]

    }

    5. 彩信模板提交接口

    5.1 協議說明

    協議類目 說明

    請求方式

    POST

    編碼格式

    UTF-8

    Content-Type

    application/json

    5.2 請求地址

    https://api.ihuyi.com/mms/v1/templateCreate

    5.3 請求參數(json格式,需要包含公共請求參數)

    參數 類型 是否必填 說明
    title string 模板標題(用于標識,不會出現在彩信內容中)
    content array<[][]DataItem> 彩信元素內容DataItem結構:(具體參照文檔9.01)
    參數 類型 描述
    con_type int 內容類型
    ext_type string 文件擴展名
    data string 數據
    purpose string 應用場景描述
    sign_name string 短信簽名

    5.4返回參數(json格式)

    參數 類型 說明
    template_id int 模板ID
    code string 狀態碼,OK表示發送成功,其他則是錯誤
    message string 消息內容

    6. 回執推送

    6.1 協議說明

    協議類目 說明
    調用方式 主動回調
    請求方式 POST
    編碼格式 UTF-8
    Content-Type application/json
    數據格式 json

    6.2 回執數據定義

    參數 類型 說明
    task_id string 下發批次ID
    phone string 手機號碼
    code string 狀態碼,DELIVERED則是成功,其他則是失敗
    message string 返回消息,用戶接收成功
    send_time string 發送時間
    report_time string 回執時間

    響應說明:

    成功接收請輸出字符 “success” (不包含引號)結束推送,否則以接收失敗處理。每個回執最多推送3次。每次間隔疊加60秒。

    7. 上行推送

    7.1 協議說明

    協議類目 說明
    調用方式 主動回調
    請求方式 POST
    編碼格式 UTF-8
    Content-Type application/json
    數據格式 json

     

     

    7.2 回執數據定義

    參數 類型 說明
    task_id string 下發批次ID
    phone string 手機號碼
    content string 上行內容
    dest_code string 上行通道擴展號
    send_time string 發送時間
    receive_time string 收取時間

    響應說明:

    成功接收請輸出字符 “success” (不包含引號)結束推送,否則以接收失敗處理。每個回執最多推送3次。每次間隔疊加60秒。

    8. 模板審核推送

    8.1 協議說明

    協議類目 說明
    調用方式 主動回調
    請求方式 POST
    編碼格式 UTF-8
    Content-Type application/json
    數據格式 json

    8.2 模板審核數據定義

    參數 類型 說明
    template_id int 模板ID
    code string 狀態值(SUCCESS審核通過,FAIL審核失敗)
    message string 審核消息

    9. 參數示例說明

    9.1 內容格式定義

    1) 支持視頻、圖片、音頻和文字,圖片編碼格式為二進制后base64,文字編碼格式為utf-8;
    2) 彩信由多幀組成,同一幀中元素最多允許一段文字和一種媒體文件(即同一幀中只允許展現視頻、圖片、音頻中的一種媒體文件),多個媒體文件請分別放置在多幀中;
    3) 內容類型(con_type)支持:text(文本)、image(圖片)、audio(音頻)、video(視頻);
    4) 文件擴展名(ext_type)支持:jpg、jpeg、png、gif、mp3、mp4。

    內容格式json格式參考如下:

    [[{"con_type":"text","ext_type":"txt","data":"這是測試文本內容1"},{"con_type":"image","ext_type":"jpg","data":"這是base64內容"}],[{"con_type":"text","ext_type":"txt","data":"這是測試文本內容2"},{"con_type":"video","ext_type":"mp4","data":"這是base64內容"}],[{"con_type":"image","ext_type":"jpg","data":"這是base64內容"},{"con_type":"text","ext_type":"txt","data":"這是測試文本內容3"}],[{"con_type":"audio","ext_type":"mp3","data":"test"},{"con_type":"text","ext_type":"txt","data":"這是base64內容"}]]

     

    互億通信短信平臺支持簽名認證

    為短信加上您的公司品牌和LOGO

    更高信任度,更高轉化率

    在線咨詢
    電話咨詢

    服務熱線:

    4008 808 898

    服務熱線(工作時間):

    4008 808 898

    業務咨詢(非工作時間):

    4008 808 898

    售后咨詢(非工作時間):

    4008 808 898

    主站蜘蛛池模板: 人妻无码久久精品| 久久精品国产久精国产思思| 亚洲精品一级无码中文字幕| 日韩精品国产自在久久现线拍| 无码精品日韩中文字幕| 亚洲av无码成人精品区在线播放| 久久精品国产精品亚洲人人| 国产一区二区精品久久凹凸| 国产午夜福利精品久久| 国产精品福利区一区二区三区四区| 亚洲综合精品香蕉久久网97| 无码精品国产VA在线观看DVD| 国产区精品高清在线观看| 国产精品久久久久无码av| 国产精品成人不卡在线观看| 午夜精品久久久久久久无码| 在线精品动漫一区二区无广告| 一本久久a久久精品综合夜夜| 国产精品日韩AV在线播放 | 精品国产三级a∨在线| 人妻少妇精品视频二区 | 日批日出水久久亚洲精品tv | 99国产欧美久久久精品蜜芽| 99久久精品毛片免费播放| 久久久国产精品网站| 国产精品五月天强力打造| 国产在视频线精品视频二代| 国产精品永久久久久久久久久| 国内精品免费在线观看| 精品国产粉嫩内射白浆内射双马尾| 一本一道久久a久久精品综合| 久久精品国产一区二区三区不卡| 国产精品99久久精品爆乳| 999久久久国产精品| 在线观看国产精品普通话对白精品| 国产精品午夜免费观看网站| 国产精品无码素人福利| 好湿好大硬得深一点动态图91精品福利一区二区 | 亚洲国模精品一区| 亚洲精品人成无码中文毛片| 亚洲精品永久在线观看|