360小程序 消息API

2019-07-08 13:07 更新

360小程序支持通過調(diào)用api向指定的用戶推送消息,接入方法如下:

注:為了保護小程序用戶的隱私,開發(fā)者必須校驗小程序用戶的登錄狀態(tài),在登錄狀態(tài)的用戶才可推送消息,否則 360 則對小程序開發(fā)者進行封禁處理。

接入要求


開發(fā)者需要使用appId和appSecret對消息簽名

消息格式


請求路徑:https://mp.#/miniplatform/open/api/msg

POST消息體為JSON結(jié)構(gòu),字段如下:

參數(shù)名 類型 必填 說明
msg_id string 消息ID,作為消息的標識符,長度20個字符以內(nèi)
uid string 需要推送消息的用戶ID,多個用戶ID以逗號分隔。開發(fā)者使用qihoo.GetMid()獲取用戶UID
title string 消息標題,長度15個字符以內(nèi)
digest string 消息摘要,長度50個字符以內(nèi)
click_url string 點擊跳轉(zhuǎn)鏈接

代碼實例

{ 
"msg_id":"2019010112319999", 
"uid":"aaa,bbb,ccc,ddd", 
"title":"歡迎登錄xxx", 
"digest":"hello xxx, welcome to my world!", 
"click_url":"https://www.xxx.cn/aaa", 
}

簽名方式

各個字段按照字典序排序,值做base64處理, 使用&連接,最后加上key=&secret=&ts=<unix_timestamp>,將字符串做MD5的結(jié)果就是sign, 將認證字段放到http header中,X-API-KEY填寫appId, X-API-TS填寫當(dāng)前unix timestamp格式的時間戳(秒),X-API-SIGN填寫簽名信息

例如

appId=qhzdhs1y8jypm3pefb, appSecret=tchvzxx9mqxkqn1fc78383mwnq34sqae, 當(dāng)前時間戳為1557460800 (單位秒, 時區(qū)為北京時間) 針對示例的json,拼接后的字符串如下:

click_url=aHR0cHM6Ly93d3cueHh4LmNuL2FhYQ==&digest=aGVsbG8geHh4LCB3ZWxjb21lIHRvIG15IHdvcmxkIQ==&msg_id=MjAxOTAxMDExMjMxOTk5OQ==&title=5qyi6L+O55m75b2VeHh4&uid=YWFhLGJiYixjY2MsZGRk&key=qhzdhs1y8jypm3pefb&secret=tchvzxx9mqxkqn1fc78383mwnq34sqae&ts=1557460800

計算MD5后的簽名值為

57ad8c210dc748338ab9c160e1840509 

注:360 將會對違規(guī)使用消息 api 的開發(fā)者進行封禁處理。 


以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號