高效转链 - 典典的小卖部

请求参数

Query 参数

goodsId

string

可选

couponId

string

可选

商品的优惠券ID，一个商品在联盟可能有多个优惠券，可通过填写该参数的方式选择使用的优惠券，请确认优惠券ID正确，否则无法正常跳转

pid

string

可选

推广位ID，用户可自由填写当前大淘客账号下已授权淘宝账号的任一pid，若未填写，则默认使用创建应用时绑定的pid

channelId

string

可选

渠道id将会和传入的pid进行验证，验证通过将正常转链，请确认填入的渠道id是正确的 channelId对应联盟的relationId

rebateType

string

可选

付定返红包，0.不使用付定返红包，1.参与付定返红包

specialId

string

会员运营id

可选

externalId

string

可选

淘宝客外部用户标记，如自身系统账户ID；微信ID等

xid

string

可选

团长与下游渠道合作的特殊标识，用于统计渠道推广效果（新增入参）

Header 参数

Authorization

string

可选

默认值:

eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjEiLCJleHAiOjE2OTU0MzcyMjR9.kbmW-3ddds9YwdKzKMieQOUQmjQdMZYE27N724f16Xk

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request GET 'https://api.itbug.shop/tkapi/api/v1/dtk/apis/privilege-link' \
--header 'Authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjEiLCJleHAiOjE2OTU0MzcyMjR9.kbmW-3ddds9YwdKzKMieQOUQmjQdMZYE27N724f16Xk'

返回响应

🟢200OK

application/json

Body

state

integer <int32>

状态码

可选

message

string

消息提示

可选

data

object (PrivilegeLinkModel)

可选

couponClickUrl

string

可选

couponEndTime

string

可选

couponInfo

string

可选

couponStartTime

string

可选

itemId

string

可选

couponTotalCount

string

可选

couponRemainCount

string

可选

itemUrl

string

可选

tpwd

string

可选

longTpwd

string

可选

maxCommissionRate

string

可选

shortUrl

string

可选

minCommissionRate

string

可选

kuaiZhanUrl

string

可选

originalPrice

number <double>

可选

actualPrice

number <double>

可选

title

string

可选

type

enum<string>

可选

通知类型:Dialog:弹窗,Toast:吐司,Notice:浮层,None:不展示消息,FinalToast:成功或者失败都展示吐司,FinalDialog: 成功或者失败都展示消息弹窗

枚举值:

ToastDialogNoticeNoneFinalToastFinalDialog

redirectUrl

string

可选

重定向URL,不为null需要跳转到这个链接

示例值:

/error?message=token失效&reDirectTo=/orderList

success

boolean

可选

true: 达到预期操作,false: 操作失败,错误信息查看message字段

示例

{
  "state": 0,
  "message": "string",
  "data": {
    "couponClickUrl": "string",
    "couponEndTime": "string",
    "couponInfo": "string",
    "couponStartTime": "string",
    "itemId": "string",
    "couponTotalCount": "string",
    "couponRemainCount": "string",
    "itemUrl": "string",
    "tpwd": "string",
    "longTpwd": "string",
    "maxCommissionRate": "string",
    "shortUrl": "string",
    "minCommissionRate": "string",
    "kuaiZhanUrl": "string",
    "originalPrice": 0,
    "actualPrice": 0,
    "title": "string"
  },
  "type": "Toast",
  "redirectUrl": "/error?message=token失效&reDirectTo=/orderList",
  "success": true
}