Scope: message.once.send 需要申请权限 需要用户授权

一次性订阅消息，是抖音开放平台为开发者提供的重要能力之一，便于开发者在自己的网页应用中实现服务的闭环和更优的体验。

功能介绍

一次性订阅消息，用于解决用户在抖音端内使用第三方网页服务后，后续服务环节的通知问题。

用户自主订阅后，开发者可在90天内下发**一条对应的服务消息，**每条消息需单独订阅，一次订阅后可发送一次。

开发者的通知消息，将在抖音APP-消息-第三方服务通知中触达用户。

申请步骤

步骤一：开发者线下提交模板消息需求（含触发场景、消息标题、消息正文、跳转页面），经开放平台运营侧审核后，获取模板id

步骤二：同时在开放平台官网-管理中心-应用详情-特殊权限中，申请增量授权权限。注：一次性订阅消息，依赖开通增量授权，即当次授权只需要传入当次授权权限，不影响历史已授权权限的可用性

步骤二：调用「一次性订阅消息发送」接口，进行相关调试。

附JSBridge部分：https://open.douyin.com/platform/resource/docs/develop/permission/js/js-bridge/js-bridge

JS授权说明：https://open.douyin.com/platform/resource/docs/develop/permission/js/permission

验证签名：https://open.douyin.com/platform/resource/docs/develop/permission/js/signature

消息模板示例：

触发场景：用户在第三方服务页面内确认订阅后，开发者可以通过第三方服务发送一条消息

消息标题：活动开始提醒

消息正文：你订阅的{ActivityName}活动开始了，点击即可参与！

跳转页面：www.douyin.com

请求地址

POST /message/once/send/

请求头

• Content-Type: application/json
• access-token: 调用/oauth/access_token/生成的token，此token需要用户授权。示例: act.1d1021d2aee3d41fee2d2add43456badMFZnrhFhfWotu3Ecuiuka27L56lr

请求参数

URL 请求

Body 请求

请求样例

响应参数

响应样例

{
  "extra": {
    "sub_error_code": 0,
    "sub_description": "",
    "logid": "202008121419360101980821035705926A",
    "now": 1597213176393,
    "error_code": 0,
    "description": ""
  },
  "data": {
    "error_code": 0,
    "description": ""
  }
}

响应错误样例

{
  "data": {
    "error_code": 2100005,
    "description": "Parameter error"
  },
  "extra": {
    "error_code": 2100005,
    "description": "Parameter error",
    "sub_error_code": 0,
    "sub_description": "",
    "now": 1594015876138,
    "log_id": "2020070614111601022506808001045D59"
  }
}