抖音开放平台Logo
控制台

删除导入的外部订购数据

收藏
我的收藏

接口说明

Scope: market.service.user 需要申请权限 不需要用户授权

该接口供服务商对历史导入的外部订购数据进行删除。

使用限制

  • 该接口仅适用于平台应用类服务
  • 服务商只能对自己创建的服务进行操作
  • 服务商只能对自己导入的外部订购数据进行删除，无法使用该接口删除用户在平台侧的下单数据

基本信息

名称描述
HTTP URL
https://open.douyin.com/market/service/user/delete/purchase/info/
HTTP Method
POST
Scope
market.service.user
权限要求
  • 需要申请服务市场服务订购相关权限（scope：market.service.user），申请路径：抖音开放平台控制台 > 移动应用（或网站应用） > 应用详情 > 能力管理 > 特殊权限
  • 不需要用户授权

请求头

名称字段类型是否必填示例描述
access-tokenString是clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ
调用https://open.douyin.com/oauth/client_token/生成的token
content-typeString是application/json
固定值"application/json"

请求参数

Body

名称字段类型是否必填示例描述
open_idString是ba253642-0590-40bc-9bdf-9a1334b94059

查询订阅信息目标用户的唯一标识，通过/oauth/access_token/获取

out_trade_noString是1

外部开发者单号id，用于唯一标识同一服务同一规格下要删除的订购数据和保证当前撤销操作的幂等性，最大长度为128

service_idString是7021602203591118688

服务id，服务的唯一标识，可在发布“平台应用类”功能中【应用配置页】和【服务详情页】中获取

service_mode_idString是free

用户订购的服务规格id，由服务商在创建服务时设置，可在发布“平台应用类”功能中【应用配置页】和【服务详情页】获取

请求示例

curl --location --request POST 'https://open.douyin.com/market/service/user/delete/purchase/info/' \
--header 'access-token: clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1******' \
--header 'Content-Type: application/json' \
--data-raw '{
    "open_id": "ba253642-0590-40bc-9bdf-9a1334******",
    "service_id": "7021602203591******",
    "service_mode_id": "standard_2",
    "out_trade_no": "1680613917339688"
}'

响应参数

Body

名称字段类型是否必填示例描述

响应示例

正常响应示例

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

异常响应示例

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

错误码

http状态码错误码错误码描述排查建议
2002190008
access_token过期，请刷新或重新授权
参考生成 client_token 获取接口（https://developer.open-douyin.com/docs/resource/zh-CN/dop/develop/openapi/account-permission/client-token）调用的凭证 client_access_token
2002190002
access_token无效
检查请求头的access-token参数
2002100007
无权限操作
检查请求参数的service_id
2002100004
系统繁忙，此时请开发者稍候再试
稍后重试
2002100005
参数不合法
检查请求参数