删除导入的外部订购数据
收藏接口说明
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
展开子属性
extraStruct
展开子属性
响应示例
正常响应示例异常响应示例
{ "data": { "error_code": 0, "description": "" }, "extra": { "error_code": 0, "description": "", "sub_error_code": 0, "sub_description": "", "logid": "202008121419360101980821035705926A", "now": 1597213176393 } }
错误码
| 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 | 参数不合法 | 检查请求参数 |
