Parfois, vous devez obtenir des coupons de magasin pour offrir à vos utilisateurs de meilleures options de remises.
[Fonction d'interface] : interrogez les coupons de magasin disponibles et les coupons de produit correspondant au produit.
【Description des paramètres】 :
| nom | taper | devoir | décrire |
|---|---|---|---|
| clé | Chaîne | Oui | Clé d'appel (doit être épissée dans l'URL en mode GET, cliquez pour obtenir la clé de requête et le secret ) |
| secret | Chaîne | Oui | Touche d'appel (code d'interface wechat19970108018) |
| nom_api | Chaîne | Oui | Nom de l'interface API (inclus dans l'adresse de la requête) [item_search, item_get, item_search_shop, etc.] |
| cache | Chaîne | Non | [oui, non] La valeur par défaut est oui, les données mises en cache seront appelées et la vitesse est relativement rapide |
| type_résultat | Chaîne | Non | [json,jsonu,xml,serialize,var_export] renvoie le format de données, la valeur par défaut est json, et le contenu généré par jsonu peut être lu directement en chinois |
| langue | Chaîne | Non | [cn,en,ru] langue de traduction, par défaut cn chinois simplifié |
| version | Chaîne | Non | Version de l'API |
[Exemple de demande de code] (Remarques : CURL, PHP, PHPsdk, Java, C#, Python...)
# coding:utf-8
"""
Compatible for python2.x and python3.x
requirement: pip install requests
"""
from __future__ import print_function
import requests
# 请求示例 url 默认请求参数已经做URL编码
url = "https://wx19970108018/taobao/item_search_coupon/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&q=&num_iid=634250549720&pid=&cookie="
headers = {
"Accept-Encoding": "gzip",
"Connection": "close"
}
if __name__ == "__main__":
r = requests.get(url, headers=headers)
json_obj = r.json()
print(json_obj)【Exemple de réponse】
L'interface renvoie le même coupon que le coupon affiché sur la page de détails du produit de Mobile Taobao, qui est le coupon de magasin disponible pour le produit (notez qu'il ne s'agit pas d'un coupon de produit).
Voici les résultats des coupons de magasin pour le produit 626132884654 :
执行结果：
{
"error": "0",
"msg": "店铺优惠券查询成功！",
"coupons_total": 1, //店铺优惠券数量
"has_coupon_prom": 1, //是否有店铺满减活动，1表示有，0表示没有
"data": [
{
"subTitles": [
"有效期至2021.03.31 23:59"
],
"effectiveTime": 1614614400000, //有效期
"titles": [
"满199使用" //使用条件
],
"type": 1,
"uuid": "de5b3aaebe87400c83a0232217bc8a7d", //券ID
"logoImageUrl": "https://gw.alicdn.com/tfs/TB19Nsthbr1gK0jSZR0XXbP8XXa-498-90.png",
"promotionUniqueId": "de5b3aaebe87400c83a0232217bc8a7d",
"priceCurrency": "￥",
"applyText": "立即领取",
"uuid4Cal": "de5b3aaebe87400c83a0232217bc8a7d",
"priceText": "5", //优惠券面额：减5元（满199元）
"unEffectiveTime": 1617206399000, //有效期
"bgUrl": "https://gw.alicdn.com/tfs/TB1UZgNf7T2gK0jSZFkXXcIQFXa-1428-288.png"
},
........ //其它券略掉
{
"priceDes": "起",
"priceCurrency": "￥",
"subTitles": [
"距到期仅剩2天"
],
"applyUrl": "//h5.m.taobao.com/shopb/shopactivity.html?activityId=15626565363&sellerId=2271279753&source=2&spm=W-a211f8.10431435&scm=20140619.detail.dpb.0",
"effectiveTime": 1615704560000,
"titles": [],
"type": 1007,
"items": [ //店铺满减活动
{
"actionType": "4",
"actionValue": "8",
"title": "满35元,省8元",
"gifts": [],
"promotionUniqueId": "15626565363-1"
},
{
"actionType": "4",
"actionValue": "11",
"title": "满41.9元,省11元",
"gifts": [],
"promotionUniqueId": "15626565363-2"
},
{
"actionType": "4",
"actionValue": "14",
"title": "满47.9元,省14元",
"gifts": [],
"promotionUniqueId": "15626565363-3"
},
{
"actionType": "4",
"actionValue": "19",
"title": "满53.9元,省19元",
"gifts": [],
"promotionUniqueId": "15626565363-4"
}
],
"priceText": "8",
"unEffectiveTime": 1615856399000,
"logoImageUrl": "https://gw.alicdn.com/tfs/TB1a.3vheH2gK0jSZJnXXaT1FXa-498-90.png",
"bgUrl": "https://gw.alicdn.com/tfs/TB1rPY7gkT2gK0jSZFkXXcIQFXa-714-142.png"
}
]
}
S'il existe une activité de remise totale en magasin, les résultats sont les suivants :
以商品ID ：38134950905 为例，有满4000元减600元活动。
{
"error": "0",
"msg": "店铺优惠券查询成功！",
"coupons_total": 0,
"has_coupon_prom": 1,
"data": [
{
"priceCurrency": "￥",
"subTitles": [
"距到期仅剩3天"
],
"applyUrl": "//h5.m.taobao.com/shopb/shopactivity.html?activityId=16626807583&sellerId=595397331&source=2&spm=W-a211f8.10431435&scm=20140619.detail.dpb.0",
"effectiveTime": 1617204851000,
"titles": [],
"type": 1007,
"items": [
{
"actionType": "4",
"actionValue": "600",
"title": "满4000元,省600元",
"gifts": [],
"promotionUniqueId": "16626807583-1"
}
],
"priceText": "600",
"unEffectiveTime": 1618502399000,
"logoImageUrl": "https://gw.alicdn.com/tfs/TB1a.3vheH2gK0jSZJnXXaT1FXa-498-90.png",
"bgUrl": "https://gw.alicdn.com/tfs/TB1rPY7gkT2gK0jSZFkXXcIQFXa-714-142.png"
}
]
}
S'il y a un cadeau, il est retourné comme suit :
{
"error": "0",
"msg": "店铺优惠券查询成功！",
"coupons_total": 0,
"has_coupon_prom": 1,
"data": [
{
"subTitles": [
"有效期至2021.06.01 00:00"
],
"applyUrl": "//h5.m.taobao.com/shopb/shopactivity.html?activityId=18487071808&sellerId=1767192580&source=2&spm=W-a211f8.10431435&scm=20140619.detail.dpb.0",
"effectiveTime": 1611072000000,
"activityLogo": "https://gw.alicdn.com/tfs/TB1R7zPgNn1gK0jSZKPXXXvUXXa-168-168.png",
"titles": [],
"type": 1007,
"items": [
{
"actionType": "131080",
"title": "满2件,领超值赠品（赠完即止）",
"gifts": [
{
"picUrl": "//img.alicdn.com/imgextra/i4/1767192580/O1CN01h0jJdT1UvgVUmfajW_!!2-item_pic.png",
"name": "窑变蓝兔毫",
"id": "637042766886",
"title": "窑变陶瓷功夫茶具套装家用整套蓝兔毫简约泡茶器茶壶杯子",
"jumpUrl": "https://detail.tmall.com/item.htm?id=637042766886"
}
],
"promotionUniqueId": "18487071808-1"
}
],
"unEffectiveTime": 1622476800000,
"logoImageUrl": "https://gw.alicdn.com/tfs/TB1H4kshoD1gK0jSZFGXXbd3FXa-498-90.png",
"bgUrl": "https://gw.alicdn.com/tfs/TB1rPY7gkT2gK0jSZFkXXcIQFXa-714-142.png"
}
]
}