获取推广链接
基本信息
- service:cps-mesh.cpslink.links.post
- 请求方式:POST
请求Header
Header参数 | 是否必须 | 示例 | 备注 |
---|---|---|---|
Content-Type | 是 | application/json |
公共参数
参数名称 | 是否必须 | 示例 | 备注 |
---|---|---|---|
app_key | 是 | 2312521 | 媒体应用AppKey 查看获取方式 |
timestamp | 是 | 1596592757 | 秒级时间戳 |
service | 是 | cps-mesh.cpslink.links.post | 接口服务名称 |
sign | 是 | 5D17CCCD5B29F98171D6D0D43136B366 | 签名 详解 |
接口参数
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
url | string | 非必须 | 待转链链接,和ads_id、product_id必传一个(若淘宝商品则要使用带有A-B的商品ID的地址,例:https://uland.taobao.com/item/edetail?id=PKJ8MOju3tYe4xYHxp7CqU6-pzvyzghR656O4oeh7) | ||
ads_id | string | 非必须 | 计划id,和url、product_id必传一个 | ||
product_id | string | 非必须 | 商品id,多麦商品库特有参数,供内部使用 | ||
site_id | string | 非必须 | 推广位id | ||
original | string | 非必须 | 是否需要商家原始链接 | ||
ext | object | 非必须 | 扩展参数 | ||
├─ coupon | string | 非必须 | 优惠券 淘宝为优惠券id 京东为优惠券链接,如不需要优惠券,传none | ||
├─ euid | string | 非必须 | euid 反馈标签,淘系类暂不支持 | ||
├─ js | number | 非必须 | 是否需要js跳转,1:通过js跳转,0:302跳转 不传默认1 | ||
├─ gift_coupon_key | string | 非必须 | 礼金批次号 | ||
├─ uid | string | 非必须 | 用户id 用于一些免登场景 | ||
├─ uname | string | 非必须 | 用户昵称 用于一些免登场景 | ||
├─ douyin_openid | string | 非必须 | 已废弃 | ||
├─ douyin_buyinid | string | 非必须 | 抖音直播间buyin_id,来自抖音接口-分销直播间列表,直播间计划推广使用,此时url传空 | ||
├─ douyin_activity_id | string | 非必须 | 抖音活动,1:百亿补贴 2:秒杀活动,此时url传空 | ||
├─ douyin_live_product_id | string | 非必须 | 抖音直播间商品列表itemid,回流唤起对应商详页 |
请求示例
{
"url": "string",
"ads_id": "string",
"product_id": "string",
"site_id": "string",
"original": "string",
"ext": {
"coupon": "string",
"euid": "string",
"js": 0,
"gift_coupon_key": "string",
"uid": "string",
"uname": "string",
"douyin_openid": "string",
"douyin_buyinid": "string",
"douyin_activity_id": "string",
"douyin_live_product_id": "string"
}
}
返回参数
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
status | integer | 非必须 | 状态code | ||
message | string | 非必须 | 错误信息 | ||
data | object | 非必须 | |||
├─ type | string | 非必须 | 类型 | ||
├─ product | object | 非必须 | 商品信息 | ||
├─ product_original_id | string | 非必须 | 商品原始id | ||
├─ product_title | string | 非必须 | 商品名称 | ||
├─ product_main_picture | string | 非必须 | 商品主图 | ||
├─ product_original_price | integer | 非必须 | 商品价格 | ||
├─ product_coupon | integer | 非必须 | 商品优惠 | ||
├─ adser_id | integer | 非必须 | 广告主id | ||
├─ ads | object [] | 非必须 | 计划信息 | item 类型: object | |
├─ platform | string | 非必须 | 平台 | ||
├─ url | string | 非必须 | wap-长链接 | ||
├─ code | string | 非必须 | 淘口令 部分链接会有 | ||
├─ original_link | string | 非必须 | 商家原始链接 | ||
├─ wx_path | string | 非必须 | 微信小程序page路径 | ||
├─ wx_appid | string | 非必须 | 微信小程序appid | ||
├─ wx_qrcode | string | 非必须 | 微信二维码 | ||
├─ wx_ghid | string | 非必须 | 微信账号原始id | ||
├─ deep_link | string | 非必须 | deep_link 唤醒链接 | ||
├─ short_url | string | 非必须 | 自带短链 | ||
├─ wap_url | string | 非必须 | pc-长链接 |
返回示例
{
"status": 0,
"message": "string",
"data": {
"type": "string",
"product": {
"product_original_id": "string",
"product_title": "string",
"product_main_picture": "string",
"product_original_price": 0,
"product_coupon": 0,
"adser_id": 0
},
"ads": [
{}
],
"platform": "string",
"url": "string",
"code": "string",
"original_link": "string",
"wx_path": "string",
"wx_appid": "string",
"wx_qrcode": "string",
"wx_ghid": "string",
"deep_link": "string",
"short_url": "string",
"wap_url": "string"
}
}