抖音精选联盟订单查询API接口
需要授权
306人使用

查询独立抖客分销订单,需要独立抖客百应授权

接口地址: http://api.tbk.dingdanxia.com/douyin/order_dk_details 在线测试

接口支持https,非大陆服务器(含港澳台)调用接口会出现网络缓慢现象,请联系客服获取国外专线接口

请求参数、 调用方式 GET

参数接口

参数类型

必填

示例

说明

apikey

string

接口秘钥,请登录后台获取

size

Int64

20

每页订单数目,取值区间: [1, 200]

cursor

String

0

下一页索引(第一页传“0”)

start_time

String

2006-01-02 15:04:05

时间开始,最早支持90天前

end_time

String

2006-01-02 15:04:05

时间结束

order_ids

String

4737996432465788974,4737996432465780075

订单号。多个订单号用英文 , 分隔,最多支持10个订单号

pid

String

dy_1234_4567_7890

抖客PID

distribution_type

String

Live

分销类型。Live-直播间分销订单,ProductDetail-商品分销订单,ActivityMaterial-活动页订单

time_type

String

update

查询时间类型。pay: 支付时间(默认); update:联盟侧更新时间,非订单状态更新时间

query_order_type

Int64

0

不填或者填0:查询分销订单,1:查询比价订单

返回参数说明

标记

类型

例子

说明

distributor_right_type

String

权益类型,下单用券类型,空或者Unknown为无权益,ColonelExclusiveCoupon(抖客团长券),可能同时存在多个权益,以逗号隔开

has_supermarket_tag

Bool

true

是否抖音超市(次日达)商品

has_subsidy_tag

Bool

true

是否超值购商品

confirm_time

String

收货时间

material_id

String

活动页物料ID

author_buyin_id

String

被分销达人百应ID(仅直播间分销订单拥有)

order_id

String

订单号

product_id

String

商品id

product_img

String

商品图片URL

author_account

String

作者账号昵称(抖音/火山作者)(仅直播间分销订单有)

shop_name

String

商家名称

total_pay_amount

Int64

订单支付金额,单位分

flow_point

String

订单状态。PAY_SUCC:支付完成; REFUND:退款; SETTLE:结算;CONFIRM:确认收货

update_time

String

更新时间 [联盟侧订单更新时间]

pay_success_time

String

付款时间

settle_time

String

结算时间,结算前为空字符串

pay_goods_amount

Int64

预估参与结算金额

settled_goods_amount

Int64

实际参与结算金额

shop_id

Int64

店铺ID

pid

String

PID

external_info

String

外部参数

media_type_name

String

分销回流类型。live: 直播间分销; ProductDetail:商品分销; Activity: 百补和秒杀推广;Shop:店铺导流

item_num

Int64

2

商品数目

refund_time

String

退款订单退款时间

ads_estimated_commission

Int64

100

预估推广费收入,单位分

ads_real_commission

Int64

实际推广费收入,单位分

author_short_id

String

达人抖音号(仅直播间分销订单有)

ads_promotion_rate

Int64

推广费率

media_type

String

带货体裁。shop_list:橱窗;video:视频;live:直播;others:其他

ads_activity_id

Int64

活动页推广活动Id,1000-超值购 1001-秒杀;若distribution_type为Mix,则为Mix活动ID

ads_estimated_tech_service_fee

Int64

推广技术服务费

ads_fans_type

String

直播间分销订单:新老粉

product_activity_id

String

商品参与的活动id,0: 未参加活动 1: 超值购(活动页单品推广)

cursor

String

下一页的索引

返回示例

{
    "code":200,
    "msg":"请求成功【success】",
    "data":{
        "cursor":"6926081630647096320",
        "orders":[
            {
                "ads_activity_id":0,
                "ads_estimated_commission":234,
                "ads_estimated_tech_service_fee":26,
                "ads_fans_type":null,
                "ads_promotion_rate":2600,
                "ads_real_commission":0,
                "author_account":"",
                "author_buyin_id":null,
                "author_short_id":"0",
                "confirm_time":null,
                "distributor_right_type":"",
                "flow_point":"REFUND",
                "item_num":1,
                "material_id":null,
                "media_type":null,
                "order_id":"6926081630647096320",
                "pay_goods_amount":999,
                "pay_success_time":"2024-01-10 15:46:10",
                "pid_info":{
                    "external_info":"123456",
                    "media_type_name":"ProductDetail",
                    "pid":"dy_107317533425711644943_54075_3710810057"
                },
                "product_activity_id":"0",
                "product_id":"3590471656293989864",
                "product_img":"https://p3-aio.ecombdimg.com/obj/ecom-shop-material/cUdqSCLw_m_f69aabd91a7dbaa5a555cdb9e6039259_sx_596703_www800-800",
                "product_name":"【实发50包买30包+送20包】Q弹手磨嫩豆干五香味办公休闲即食小零食",
                "product_tags":{
                    "has_subsidy_tag":false,
                    "has_supermarket_tag":false
                },
                "refund_time":"2024-01-10 15:47:02",
                "settle_time":null,
                "settled_goods_amount":0,
                "shop_id":57923187,
                "shop_name":"金莱食品企业店",
                "total_pay_amount":999,
                "update_time":"2024-01-10 15:47:14"
            }
        ]
    }
}

			  
返回错误码说明

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

登录后台查看接口秘钥是否一致

4003

参数不正确

请检查参数是否符合文档要求

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

查看签名构建规则确保正确无误。

4009

点卡已用完

请登录控制台-服务购买-充值点卡

4010

请购买接口次数包才能调用此接口

需充值次数包

4011

次数包已用完,请重新购买

需充值次数包

4012

请求客户端ip未加入白名单

将ip加入白名单

4013

联盟账号授权已过期

请登录控制台【授权管理】下重新授权您的相关账号

4014

PID异常

请登录控制台【授权管理】-【淘宝授权】,检查您的推广位PID是否填写,或是否填写正确。

4015

系统异常

服务端处理异常,请等待......或联系网站在线客服反馈。

4017

请求拒绝

调用请求被拒绝,您的账号状态存在异常,请联系平台管理员解除限制。