获取推广链接

4 min read

基本信息

调试工具

  • service:cps-mesh.cpslink.links.post
  • 请求方式:POST

请求Header

Header参数是否必须示例备注
Content-Typeapplication/json

公共参数

参数名称是否必须示例备注
app_key2312521媒体应用AppKey 查看获取方式
timestamp1596592757秒级时间戳
servicecps-mesh.cpslink.links.post接口服务名称
sign5D17CCCD5B29F98171D6D0D43136B366签名 详解

接口参数

名称类型是否必须默认值备注其他信息
urlstring非必须待转链链接,和ads_id、product_id必传一个(若淘宝商品则要使用带有A-B的商品ID的地址,例:https://uland.taobao.com/item/edetail?id=PKJ8MOju3tYe4xYHxp7CqU6-pzvyzghR656O4oeh7)
ads_idstring非必须计划id,和url、product_id必传一个
product_idstring非必须商品id,多麦商品库特有参数,供内部使用
site_idstring非必须推广位id
originalstring非必须是否需要商家原始链接
extobject非必须扩展参数
├─ couponstring非必须优惠券 淘宝为优惠券id 京东为优惠券链接,如不需要优惠券,传none
├─ euidstring非必须euid 反馈标签,淘系类暂不支持
├─ jsnumber非必须是否需要js跳转,1:通过js跳转,0:302跳转 不传默认1
├─ gift_coupon_keystring非必须礼金批次号
├─ uidstring非必须用户id 用于一些免登场景
├─ unamestring非必须用户昵称 用于一些免登场景
├─ douyin_openidstring非必须已废弃
├─ douyin_buyinidstring非必须抖音直播间buyin_id,来自抖音接口-分销直播间列表,直播间计划推广使用,此时url传空
├─ douyin_activity_idstring非必须抖音活动,1:百亿补贴 2:秒杀活动,此时url传空
├─ douyin_live_product_idstring非必须抖音直播间商品列表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"
    }
}

返回参数

名称类型是否必须默认值备注其他信息
statusinteger非必须状态code
messagestring非必须错误信息
dataobject非必须
├─ typestring非必须类型
├─ productobject非必须商品信息
├─ product_original_idstring非必须商品原始id
├─ product_titlestring非必须商品名称
├─ product_main_picturestring非必须商品主图
├─ product_original_priceinteger非必须商品价格
├─ product_couponinteger非必须商品优惠
├─ adser_idinteger非必须广告主id
├─ adsobject []非必须计划信息

item 类型: object

├─ platformstring非必须平台
├─ urlstring非必须wap-长链接
├─ codestring非必须淘口令 部分链接会有
├─ original_linkstring非必须商家原始链接
├─ wx_pathstring非必须微信小程序page路径
├─ wx_appidstring非必须微信小程序appid
├─ wx_qrcodestring非必须微信二维码
├─ wx_ghidstring非必须微信账号原始id
├─ deep_linkstring非必须deep_link 唤醒链接
├─ short_urlstring非必须自带短链
├─ wap_urlstring非必须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"
    }
}