send

2020-02-15 01:38 更新
本接口在服務(wù)器端調(diào)用

發(fā)送模版消息


接口地址

POST https://developer.toutiao.com/api/apps/game/template/send


輸入

以下參數(shù)均在 JSON body 中。

名稱類型必填含義
access_tokenString服務(wù)端 API 調(diào)用標識,獲取方法
touserString要發(fā)送給用戶的 open id, open id 的獲取請參考登錄
template_idString在開發(fā)者平臺配置消息模版后獲得的模版 id
pageString點擊消息卡片之后打開的小程序頁面地址,空則無跳轉(zhuǎn)
form_idString可以通過<form />組件獲得 form_id, 獲取方法
datadict<String, SubData>模板中填充著的數(shù)據(jù),key 必須是 keyword 為前綴

SubData

SubData 也是 dict,結(jié)構(gòu)如下:

名稱類型是否必填
valueString


輸出

接口響應(yīng)時一個 JSON body。結(jié)構(gòu)如下:

名稱類型含義
errcodeNumber錯誤碼
errmsgString成功為"success", 錯誤為具體 message

errcode

code含義
0成功
-1發(fā)生系統(tǒng)內(nèi)部錯誤
40001http 包體無法解析
40002access_token 無效
40014參數(shù)無效
40037錯誤的模版 id
40038小程序被禁止發(fā)送消息通知
40039form_id 不正確,或者過期
40040form_id 已經(jīng)被使用
40041錯誤的頁面地址


示例

請求:

POST /api/apps/game/template/send HTTP/1.1
Host: developer.toutiao.com
Content-Type: application/json

{"access_token": "YOUR_ACCESS_TOKEN", "app_id": "YOUR_APP_ID", "data": {"keyword1": {"value": "v1"}, "keyword2": {"value": "v2"}}, "page": "pages/index", "form_id": "YOUR_FORM_ID", "touser": "USER_OPEN_ID", "template_id": "YOUR_TPL_ID"}

響應(yīng):

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{"errcode":0,"errmsg":"success"}


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

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號