send

2020-02-12 16:56 更新
提示本接口在服務(wù)器端調(diào)用目前只有今日頭條支持，抖音和 lite 接入中

發(fā)送模版消息


接口地址

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


輸入

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

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

SubData

SubData 也是 dict，結(jié)構(gòu)如下：

名稱類型是否必填
valueString是


輸出

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

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

errcode

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


示例

請(qǐng)求：

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)容是否對(duì)您有幫助：
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)