- 移动/网站应用 OpenAPI SDK 总览
- OpenAPI 列表
- 状态码排查工具
- 用户授权
- 用户管理
- 视频管理
- 互动管理
- 搜索管理
- 数据开放服务
- 企业号开放能力(内测结束暂不开放)
- 生活服务开放能力
- 工具能力
- 服务市场开放能力
- 小程序推广计划
- 联合授权
删除导入的外部订购数据
收藏
我的收藏接口说明
Scope: market.service.user 需要申请权限 不需要用户授权
该接口供服务商对历史导入的外部订购数据进行删除。
- 注意事项:抖音的 OAuth API 以 https://open.douyin.com 开头
使用限制
- 该接口仅适用于平台应用类服务
- 服务商只能对自己创建的服务进行操作
- 服务商只能对自己导入的外部订购数据进行删除,无法使用该接口删除用户在平台侧的下单数据
基本信息
名称 | 描述 |
---|---|
HTTP URL | https://open.douyin.com/market/service/user/delete/purchase/info/ |
HTTP Method | POST |
Scope | market.service.user |
权限要求 |
|
请求头
名称 | 字段类型 | 是否必填 | 示例 | 描述 |
---|---|---|---|---|
access-token | String | 是 | clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ | |
content-type | String | 是 | application/json | 固定值"application/json" |
请求参数
Body
名称 | 字段类型 | 是否必填 | 示例 | 描述 |
---|---|---|---|---|
open_id | String | 是 | ba253642-0590-40bc-9bdf-9a1334b94059 | 查询订阅信息目标用户的唯一标识,通过/oauth/access_token/获取 |
out_trade_no | String | 是 | 1 | 外部开发者单号id,用于唯一标识同一服务同一规格下要删除的订购数据和保证当前撤销操作的幂等性,最大长度为128 |
service_id | String | 是 | 7021602203591118688 | 服务id,服务的唯一标识,可在发布“平台应用类”功能中【应用配置页】和【服务详情页】中获取 |
service_mode_id | String | 是 | 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 | Struct | 是 | ||
extra | Struct | 否 |
响应示例
正常响应示例
{
"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状态码 | 错误码 | 错误码描述 | 排查建议 |
---|---|---|---|
200 | 2190008 | access_token过期,请刷新或重新授权 | 参考生成 client_token 获取接口(https://developer.open-douyin.com/docs/resource/zh-CN/dop/develop/openapi/account-permission/client-token)调用的凭证 client_access_token |
200 | 2190002 | access_token无效 | 检查请求头的access-token参数 |
200 | 2100007 | 无权限操作 | 检查请求参数的service_id |
200 | 2100004 | 系统繁忙,此时请开发者稍候再试 | 稍后重试 |
200 | 2100005 | 参数不合法 | 检查请求参数 |
该文档是否有帮助?
点击纠错