平台应用类服务-小程序端接入指南
什么是平台应用类服务移动端版?
抖音服务市场有两种类型的服务,分别是第三方服务和平台应用类服务。
其中平台应用类服务是指用户下单后,无需线下对接或交付产品,可直接在服务市场打开进行使用的服务,如:剪辑工具、数据产品等;
抖音服务市场平台类应用在移动端(抖音app)内的呈现形式有两种,分别是以H5和小程序为载体。
服务商需要开发自己的服务抖音小程序或者H5应用,用户在抖音app内完成订购后,可直接打开抖音小程序或者H5应用进行使用。
抖音服务市场移动端入口:
打开抖音app-搜索“抖音服务市场”
开发者接入说明:
小程序应用接入:
1.创建小程序应用服务
首先,你需要有一个自己的小程序服务,你可通过【抖音开放平台】-【管理中心】-【应用管理】-【小程序】-【创建应用】

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

通过审核后,即可在抖音app-服务市场内找到你的平台类应用服务。
2.服务端校验用户身份
如果你的小程序服务是付费服务,需要进行以下身份校验配置,防止用户通过其他手段绕开服务市场付费流程,自行打开小程序,从而给服务商带来损失;
身份校验配置:在用户进入你的抖音小程序时,进行用户授权,判断该用户是否付费:
-
若已完成付费,则可正常使用小程序服务;
-
若未付费,则需要服务商自行在小程序内设置阻断流程,引导用户前往抖音服务市场完成购买;
对于用户付费身份的校验,建议采用服务端校验的方式:
我们会将必要的参数以小程序启动参数的形式传递给你的小程序,我们使用的字段是“service_market”
你可在用户进行登录授权后,将code和service_market字段一同发送到自己小程序的服务端后,
通过code获取用户的openId
在获取到openId之后,即可以请求开放平台,校验用户的付费身份
前置步骤
-
从启动参数中获取 “service_market”的值,参考:https://microapp.bytedance.com/docs/zh-CN/mini-app/develop/framework/logic-layer/start-app
-
获取用户的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 | 你在服务市场中的服务详情页面,跳转到服务市场小程序时使用 |