获取推广链接
基本信息
- 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"
}
}