根据商品id生成联盟链接 - 乐天联盟-开放平台

请求参数

Body 参数application/json

openId

string

用户身份Id

必需

goodsIdList

array[string]

商品Id列表

必需

statParam

string | null

自定义渠道统计参数

可选

evokeQuickApp

boolean | null

是否自动唤起快应用

可选

默认false

queryExclusiveCoupon

boolean | null

有隐藏红包时返回领券页

可选

默认true

genShortUrl

boolean | null

是否压缩生成的链接

可选

默认false(理论上生成的链接无需压缩也能满足大部分推广情景，如非必要，请勿选择压缩，压缩的链接有有效期(目前是一个月))

示例

{
  "openId": "a85043f2-3946-4794-add6-e66678a09f99",
  "goodsIdList": [
    "2218725124557379"
  ]
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://union.lottefuture.com/gateway/vip.union.url.service.gen.by.goods.id.with.oauth' \
--header 'Content-Type: application/json' \
--data-raw '{
    "openId": "a85043f2-3946-4794-add6-e66678a09f99",
    "goodsIdList": [
        "2218725124557379"
    ]
}'

返回响应

🟢200成功

application/json

Body

array of:

source

string

链接生成的数据源

可选

如果根据商品id生成链接，该值商品id，如果根据链接生成链接，该值为唯品会链接

url

string

CPS短链接

可选

longUrl

string

CPS长连接

可选

ulUrl

string

CPS通用连接

可选

deeplinkUrl

string

CPS Deeplink链接

可选

traFrom

string

小程序CPS参数：通用小程序跟单参数

可选

noEvokeUrl

string

CPS短链接

可选

不唤起快应用

noEvokeLongUrl

string

CPS长链接

可选

不唤起快应用

vipWxUrl

string

唯品会小程序链接

可选

仅在根据商品id获取时返回

vipWxCode

string

唯品会小程序码

可选

仅在根据商品id获取时返回，需获取小程序码高级权限

vipQuickAppUrl

string

唯品会快应用链接

可选

示例

[
  {
    "source": "2218725124557379",
    "url": "https://t.vip.com/ik5Wr3Rv5W8",
    "longUrl": "https://t.vip.com/redirect.php?url=eyJzY2hlbWVjb2RlIjoibWlnX2NvZGUiLCJzaGFyZUNvZGUiOiI0bWg4MHowMDAwZ20zNWJhIiwidmVuZG9yVWNvZGUiOiJjMzJ1eThoYiIsIm1vbml0b3JTcG90Q29kZSI6IkMwMVY0bWg4MHpyaGpsMW8iLCJhd2FrZSI6InRydWUiLCJ1Y29kZSI6Im9ybGVseHB6IiwibWFyayI6IjJBcywyNXoscHpxMCIsImRlc3R1cmwiOiJodHRwczpcL1wvbS52aXAuY29tXC9wcm9kdWN0LTEwMDY2NTQ0My0yMjE4NzI1MTI0NTU3Mzc5Lmh0bWwiLCJ2ZW5kb3JDb2RlIjoiMW8zdnloIn0=",
    "ulUrl": "https://click.union.vip.com/deeplink/showGoodsDetail?pid=2218725124557379&goodsType=1&tra_from=tra:C01V4mh80zrhjl1o:vipj7o09:mig_code::ac03164mh80z0000gm35ba061o3vyhm0&f=dx&cps_code=ik5Wr3Rv5W8&chanTag=",
    "deeplinkUrl": "vipshop://showGoodsDetail?pid=2218725124557379&goodsType=1&tra_from=tra:C01V4mh80zrhjl1o:vipj7o09:mig_code::ac03164mh80z0000gm35ba061o3vyhm0&f=dx",
    "traFrom": "adp%3AC01V4mh80zrhjl1o%3A%3Amig_code%3A%3Aac03164mh80z0000gm35ba061o3vyhdt",
    "noEvokeUrl": "https://t.vip.com/ik5Wr3Rv5W8",
    "noEvokeLongUrl": "https://t.vip.com/redirect.php?url=eyJzY2hlbWVjb2RlIjoibWlnX2NvZGUiLCJzaGFyZUNvZGUiOiI0bWg4MHowMDAwZ20zNWJhIiwidmVuZG9yVWNvZGUiOiJjMzJ1eThoYiIsIm1vbml0b3JTcG90Q29kZSI6IkMwMVY0bWg4MHpyaGpsMW8iLCJhd2FrZSI6InRydWUiLCJ1Y29kZSI6Im9ybGVseHB6IiwibWFyayI6IjJBcywyNXoscHpxMCIsImRlc3R1cmwiOiJodHRwczpcL1wvbS52aXAuY29tXC9wcm9kdWN0LTEwMDY2NTQ0My0yMjE4NzI1MTI0NTU3Mzc5Lmh0bWwiLCJ2ZW5kb3JDb2RlIjoiMW8zdnloIn0=",
    "vipWxUrl": "pages/productDetail/productDetail?brandId=100665443&goodsId=2218725124557379&tra_from=adp%3AC01V4mh80zrhjl1o%3A%3Amig_code%3A%3Aac03164mh80z0000gm35ba061o3vyhdt&chl_type=wxk",
    "vipWxCode": "",
    "vipQuickAppUrl": "hap://app/com.VIP.VIPQuickAPP/pages/product/detail?productId=2218725124557379&brandId=100665443&tra_from=adp%3AC01V4mh80zrhjl1o%3A%3Amig_code%3A%3Aac03164mh80z0000gm35ba061o3vyhdt"
  }
]