平台应用类服务-小程序端接入指南

什么是平台应用类服务移动端版?

抖音服务市场有两种类型的服务,分别是第三方服务和平台应用类服务。

其中平台应用类服务是指用户下单后,无需线下对接或交付产品,可直接在服务市场打开进行使用的服务,如:剪辑工具、数据产品等;

抖音服务市场平台类应用在移动端(抖音app)内的呈现形式有两种,分别是以H5和小程序为载体。

服务商需要开发自己的服务抖音小程序或者H5应用,用户在抖音app内完成订购后,可直接打开抖音小程序或者H5应用进行使用。

抖音服务市场移动端入口:

打开抖音app-搜索“抖音服务市场”

开发者接入说明:

小程序应用接入:

1.创建小程序应用服务

首先,你需要有一个自己的小程序服务,你可通过【抖音开放平台】-【管理中心】-【应用管理】-【小程序】-【创建应用】

 其次,发布平台类应用服务,应用配置需要选择“服务市场移动端”,“应用使用平台”选择“小程序接入”,绑定你的小程序信息,并提交审核。

通过审核后,即可在抖音app-服务市场内找到你的平台类应用服务。 

2.服务端校验用户身份

如果你的小程序服务是付费服务,需要进行以下身份校验配置,防止用户通过其他手段绕开服务市场付费流程,自行打开小程序,从而给服务商带来损失;

身份校验配置:在用户进入你的抖音小程序时,进行用户授权,判断该用户是否付费:

  • 若已完成付费,则可正常使用小程序服务;

  • 若未付费,则需要服务商自行在小程序内设置阻断流程,引导用户前往抖音服务市场完成购买;

对于用户付费身份的校验,建议采用服务端校验的方式:

我们会将必要的参数以小程序启动参数的形式传递给你的小程序,我们使用的字段是“service_market”

你可在用户进行登录授权后,将code和service_market字段一同发送到自己小程序的服务端后,

通过code获取用户的openId

在获取到openId之后,即可以请求开放平台,校验用户的付费身份

前置步骤

  1. 从启动参数中获取 “service_market”的值,参考:https://microapp.bytedance.com/docs/zh-CN/mini-app/develop/framework/logic-layer/start-app

  2. 获取用户的openId,参考:https://microapp.bytedance.com/docs/zh-CN/mini-app/develop/api/open-interface/authorization/tt-show-douyin-open-auth/

校验用户身份

开发者可以在自己的服务端请求“获取用户的服务状态”接口,具体参见下面的服务端接口部分的内容。

开发者可以通过response中的“purchase_status”字段判断用户的付费状态:purchase_status == 1 用户已购买,purchase_status ==0 未购买

至此,你就已经获取了用户的付费状态。

如用户已付费,即可向用户正常展示服务。

如用户没有付费,可以提示用户到开放平台购买服务后再访问。

我们会将服务市场小程序的service_market_app_id、service_market_path一起下发,可以根据这些参数并参考小程序跳转小程序进行配置,让用户快捷方便的进入到服务详情页进行购买。

为了展示更美观,可以使用service_market_title,service_market_icon 对跳转组件进行装饰。

H5应用接入:

1.创建H5应用服务

首先,你需要有一个自己的网站服务,你可通过【抖音开放平台】-【管理中心】-【应用管理】-【网站应用】-【创建应用】

 其次,发布平台类应用服务,应用配置需要选择“服务市场移动端”,“应用使用平台”选择“H5接入”,补充H5应用的信息,并提交审核。

通过审核后,即可在抖音app-服务市场内找到你的平台类应用服务。 

2.登录授权

如果你需要使用抖音的开放能力,一般需要完成授权,H5应用可以接入WEB授权或者JS授权。

WEB授权,参考:https://open.douyin.com/platform/resource/docs/develop/permission/web/permission

JS授权,参考:https://open.douyin.com/platform/resource/docs/develop/permission/js/permission

3.服务端校验用户身份

如果你提供的H5应用为付费服务,需进行**身份校验配置(**防止用户绕开付费,自行打开H5应用)。

你可联系平台客服申请「H5应用校验身份接口」(说明:该接口内测中,暂未开放)

服务端接口

获取用户的服务状态

请求地址

GET https://open.douyin.com/aweme/v2/creator/service_market/user/service/status

请求参数

属性

数据类型

说明

open_id

string

通过code获取的用户ID

params

string

启动参数中service_market的值

Curl举例:

curl --location -g --request GET 'https://open.douyin.com/aweme/v2/creator/service_market/user/service/status/?open_id=3e76c5a0-eedc-4209-bd58-bb2aa69720c8¶ms=service_market 

返回值 

属性

数据类型

说明

purchase_status

int

purchase_status == 1 用户已购买,purchase_status ==0 未购买

message

string

用户未购买服务时向用户展示的提示话术

service_market_title

string

抖音服务市场的名称

service_market_icon

string

抖音服务市场的图标链接

service_market_app_id

string

抖音服务市场小程序的appID,跳转到服务市场小程序时使用

service_market_path

string

你在服务市场中的服务详情页面,跳转到服务市场小程序时使用

诚邀您对本文档易读易用性进行评价
好用
不好用