API文档中心

热门接口:产品ID找同款全量维权查询万能转链字符串ID转换 (有API需求可联系本站)
店铺优惠券查询 [下线]

淘宝天猫店铺优惠券查询接口

调用权限:仅限专用卡调用
接口使用场景等说明:

本接口可以帮助淘客查询商品可用的店铺券。为您的客户提供更实惠的券选择。

接口请求地址

环境 http 地址 https 地址
正式环境 http://api.veapi.cn/tbk/shopcoupon 暂无

请求方式:GETPOST

请求参数

参数名称 参数类型 必填 示例值 描述
vekey String V123M56 公共参数,接口秘钥,请在会员中心获取
itemid Number 626132884654 要查询的淘宝或天猫的商品ID
sellerId Number 225321822932065953 店铺ID,在搜索或高佣转链详情接口有此参数值

请求示例

  • HTTP
  • PHP
  • JAVA
  • PYTHON
  1. GET/POST  http://api.veapi.cn/tbk/shopcoupon?vekey=xxx&itemid=626132884654
  2. 【例子】动态字符串ID入参
  3. http://api.veapi.cn/tbk/shopcoupon?vekey=xxx&itemid=x0jgvwXsktqa26vT6O4Fwu9-4b9dPpsymMeqdK8tN
使用curl函数,curl不是php原生库,需要安装才能使用

  1. $api="http://api.veapi.cn/tbk/shopcoupon?vekey=xxx&itemid=626132884654";
  2.  
  3. $ch = curl_init();
  4. curl_setopt($ch, CURLOPT_URL, $api);
  5. //curl_setopt($ch, CURLOPT_POST, true); //POST方式时启用
  6. //curl_setopt($ch, CURLOPT_POSTFIELDS, $postData ); //POST方式时传参
  7.  
  8. curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); //如果使用https请启用
  9. curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false); //如果使用https请启用
  10. curl_setopt($ch, CURLOPT_RETURNTRANSFER, true ); //返回数据流,不直接输出
  11. curl_setopt($ch, CURLOPT_ENCODING, 'gzip'); //使用gzip压缩传输让访问更快
  12. curl_setopt($ch, CURLOPT_TIMEOUT, 6); //允许执行的最长秒数。这里设定6S
  13. curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 5);
  14.  
  15. $result = curl_exec($ch);
  16. $info = curl_getinfo($ch);
  17. curl_close($ch);
  18.  
  19. echo $result; //返回值
使用okhttp3/httpclient/jsoup/hutool,以hutool为例:

  1. import cn.hutool.http.HttpResponse;
  2. import cn.hutool.http.HttpRequest;
  3.  
  4. public class testGetParam {
  5.  
  6. public static void main(String[] args) {
  7. // API网址
  8. String url = "http://api.veapi.cn/tbk/shopcoupon?vekey=xxx&itemid=626132884654";
  9. // JDK 8u111版本后,若目标页面为HTTPS协议,请启用proxy用户密码鉴权
  10. //System.setProperty("jdk.http.auth.tunneling.disabledSchemes", "");
  11.  
  12. // 发送请求
  13. String result = HttpRequest.get(url)
  14. .timeout(10000)//设置超时,毫秒
  15. .execute().body();
  16. System.out.println(result);
  17. }
  18. }
推荐使用 requests,支持访问http,https网页:

  1. import requests
  2.         
  3. # 要访问的API网页
  4. target_url = "http://api.veapi.cn/tbk/shopcoupon?vekey=xxx&itemid=626132884654"
  5.  
  6. # 发送请求
  7. response = requests.get(target_url)
  8.  
  9. # 获取页面内容
  10. if response.status_code == 200:
  11.     print response.text

返回值(JSON)

参数名称 参数类型 示例值 描述
coupons_total Number 3 优惠券和积分等活动数量
subTitles Object 有效期至2022.12.31 23:59 有效期描述
effectiveTime Number 1669824000000 有效期起始时间
unEffectiveTime Number 1672502399000 有效期结束时间
titles Number 满199使用 起用条件
priceText Number 5 优惠券面额
uuid String 14da4e5a54e74529ad9ab9234e4658d9 优惠券ID

返回示例

【提示】推广链接通常有时效性,示例中的链接为创建文档时生成,仅用于展示返回结果使用,有可能已失效。
{
  • error: "0",
  • msg: "店铺优惠券查询成功!",
  • coupons_total: 3,
  • has_coupon_prom: 0,
  • data: [
    1. {},
    2. {
      • des: "包邮",
      • effectiveTime: 1669003309000,
      • title: "满98包邮",
      • type: 1005,
      • unEffectiveTime: 1703952000000
      },
    3. {
      • priceCurrency: "¥",
      • subTitles: [
        1. "有效期至2022.12.31 23:59"
        ],
      • effectiveTime: 1669824000000,
      • titles: [
        1. "满199使用"
        ],
      • applyText: "立即领取",
      • type: 1,
      • uuid4Cal: "14da4e5a54e74529ad9ab9234e4658d9",
      • priceText: "5",
      • unEffectiveTime: 1672502399000,
      • uuid: "14da4e5a54e74529ad9ab9234e4658d9",
      • promotionUniqueId: "14da4e5a54e74529ad9ab9234e4658d9"
      },
    4. {
      • priceCurrency: "¥",
      • subTitles: [
        1. "有效期至2022.12.31 23:59"
        ],
      • effectiveTime: 1671120000000,
      • titles: [
        1. "满10使用"
        ],
      • applyText: "立即领取",
      • type: 20,
      • uuid4Cal: "55c62a91bf25489682fb5b6cc5eeee38",
      • priceText: "4",
      • unEffectiveTime: 1672502399000,
      • uuid: "55c62a91bf25489682fb5b6cc5eeee38",
      • promotionUniqueId: "55c62a91bf25489682fb5b6cc5eeee38"
      },
    5. {
      • des: "积分",
      • title: "购买预计可得8积分",
      • type: 1004
      }
    ]
}

错误码

如果error不为0时,请点此查看错误码表格

在线
客服

会员请加QQ群交流:

微信
咨询

加微信咨询
顶部