接口地址:http://api.tkurl.top/api/alimama/optimusmaterial
支持格式:json
请求方式:get
请求示例:http://api.tkurl.top/api/alimama/optimusmaterial?Appkey=&MaterialId=28026
请求参数说明:
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
Appkey | String | 必填 | 123456 | appkey |
MaterialId | int | 必填 | 1234 | 官方的物料Id(详细物料id见:https://market.m.taobao.com/app/qn/toutiao-new/index-pc.html#/detail/10628875?_k=gpov9a) |
PageSize | int | 可选 | 20 | 页大小,默认20,1~100 |
PageNo | int | 可选 | 1 | 第几页,默认:1 |
DeviceValue | String | 可选 | xxx | 智能匹配-设备号加密后的值(MD5加密需32位小写),类型为OAID时传原始OAID值 |
DeviceEncrypt | String | 可选 | MD5 | 智能匹配-设备号加密类型:MD5,类型为OAID时不传 |
DeviceType | String | 可选 | IMEI | 智能匹配-设备号类型:IMEI,或者IDFA,或者UTDID(UTDID不支持MD5加密),或者OAID |
ContentId | int | 可选 | 323 | 内容专用-内容详情ID |
ContentSource | String | 可选 | xxx | 内容专用-内容渠道信息 |
ItemId | int | 可选 | 33243 | 商品ID,用于相似商品推荐 |
{ "tbk_dg_optimus_material_response":{ "result_list":{ "map_data":[ { "coupon_amount":40, "small_images":{ "string":[ "" ] }, "shop_title":"魔黛娅内衣旗舰店", "category_id":162201, "coupon_start_fee":"69", "item_id":556633720749, "coupon_total_count":30000, "user_type":1, "zk_final_price":"79.9", "coupon_remain_count":1936, "commission_rate":"5.50", "coupon_start_time":"2017-10-29", "title":"毛呢阔腿裤港味复古女裤子秋冬九分裤萝卜裤显瘦高腰韩版2017新款", "item_description":"", "seller_id":745957850, "volume":3837, "coupon_end_time":"2017-11-02", "coupon_click_url":"\/\/uland.taobao.com\/coupon\/edetail?e=pR6YtnFKK%2B8GQASttHIRqcEWOmlidB03Pf45HLyCqA8dRAklSM5tEQ36hBQToU3M3MmLjFwLsqgZxcV7BPtHQDd2Naqom0e0&mt=1&app_pvid=0ab0fac715095507006577956e&ptl=app_pvid:0ab0fac715095507006577956e;tpp_pvid:41362290-fa0b-4252-b172-6afc9c00e2c8", "pict_url":"\/\/img.alicdn.com\/bao\/uploaded\/i4\/745957850\/TB1WzSRmV9gSKJjSspbXXbeNXXa_!!0-item_pic.jpg", "click_url":"\/\/item.taobao.com\/item.htm?id=556633720749&scm=1007.16190.92234.0&pvid=41362290-fa0b-4252-b172-6afc9c00e2c8&app_pvid=0ab0fac715095507006577956e", "stock":, "sell_num":, "total_stock":, "oetime":"", "ostime":"", "jdd_num":, "jdd_price":"", "orig_price":"", "level_one_category_name":"", "level_one_category_id":, "category_name":"", "white_image":"https:\/\/img.alicdn.com\/bao\/uploaded\/i4\/745957850\/TB1WzSRmV9gSKJjSspbXXbeNXXa_!!0-item_pic.jpg", "short_title":"sss", "word_list":{ "word_map_data":[ { "url":"https:\/\/uland.taobao.com\/semm\/tbxxxx", "word":"孕妇装" } ] }, "tmall_play_activity_info":"前n件x折", "uv_sum_pre_sale":21, "x_id":"uESS0mv8JvfJRMKlIgCD5At9VuHVBXoqBRihfQlo4ybLiKygRlqiN4eoxoZDfe38uSogWy6GB971jD2N8tLuuc", "new_user_price":"1.99", "coupon_info":"满299减30元", "coupon_share_url":"\/\/uland.taobao.com\/coupon\/edetail?e=pR6YtnFKK%2B8GQASttHIRqcEWOmlidB03Pf45HLyCqA8dRAklSM5tEQ36hBQToU3M3MmLjFwLsqgZxcV7BPtHQDd2Naqom0e0&mt=1&app_pvid=0ab0fac715095507006577956e&ptl=app_pvid:0ab0fac715095507006577956e;tpp_pvid:41362290-fa0b-4252-b172-6afc9c00e2c8", "nick":"秉迪数码专营店", "reserve_price":"2.99", "ju_online_end_time":"1559750399000", "ju_online_start_time":"1559232000000", "maochao_play_end_time":"1559750399000", "maochao_play_start_time":"1559232000000", "maochao_play_conditions":"2,3", "maochao_play_discounts":"500,450", "maochao_play_discount_type":"2", "maochao_play_free_post_fee":"1", "multi_coupon_zk_rate":"0.41234", "price_after_multi_coupon":"9.9", "multi_coupon_item_count":"3", "lock_rate":"110", "lock_rate_end_time":1567440000000, "lock_rate_start_time":1567440000000, "promotion_type":"1", "promotion_info":"满2件打5折;满300减20", "promotion_discount":"300", "promotion_condition":"5", "presale_discount_fee_text":"付定金立减5元", "presale_tail_end_time":1567440000000, "presale_tail_start_time":1567440000000, "presale_end_time":1567440000000, "presale_start_time":1567440000000, "presale_deposit":"100", "ysyl_tlj_use_start_time":"2019-11-10 21:59:59", "ysyl_commission_rate":"2030(表示20.3%)", "ysyl_tlj_send_time":"2019-11-10 21:59:59", "ysyl_tlj_face":"0.6", "ysyl_click_url":"https:\/\/uland.taobao.com\/coupon\/edetail?e=nqUNB1NOF3Bt3vqbdXnGloankzPYmeEFkgNrw6YHQf9pZTj41Orn8MwBAs06HAOzqQomYNedOiHDYPmqkFXqLR0HgBdG%2FDDL%2F1M%2FBw7Sf%2FesGXLf%2BqX4cbeC%2F2cR0p0NlWH0%2BknxpnCJJP%2FQkZSsyo1HvKjXo4uz&pid=mm_26381042_12970066_52864659&af=1", "ysyl_tlj_use_end_time":"2019-11-10 21:59:59", "ju_play_end_time":1567440000000, "ju_play_start_time":1567440000000, "play_info":"玩法", "tmall_play_activity_end_time":1567440000000, "tmall_play_activity_start_time":1567440000000, "ju_pre_show_end_time":"1581868800000", "ju_pre_show_start_time":"1582300799000", "favorites_info":{ "total_count":100, "favorites_list":{ "favorites_detail":[ { "favorites_id":12334, "favorites_title":"测试选品库" } ] } }, "sale_price":"168", "kuadian_promotion_info":"[\"每100减20\",\"每200减50\"]", "sub_title":"吉品鲍鱼 关西参", "jhs_price_usp_list":"满200减10", "tqg_online_end_time":"1581868800000", "tqg_online_start_time":"1581868800000", "tqg_sold_count":20, "tqg_total_count":50, "superior_brand":"1", "is_brand_flash_sale":"1", "hot_flag":"1", "topn_info":{ "topn_quantity":3000, "topn_total_count":3000, "topn_end_time":"1937297392332", "topn_start_time":"1937297392332", "topn_rate":"30" }, "bybt_info":{ "bybt_brand_logo":"\/\/img.alicdn.com\/bao\/uploaded\/i4\/745957850\/TB1WzSRmV9gSKJjSspbXXbeNXXa_!!0-item_pic.jpg", "bybt_pic_url":"\/\/img.alicdn.com\/bao\/uploaded\/i4\/745957850\/TB1WzSRmV9gSKJjSspbXXbeNXXa_!!0-item_pic.jpg", "bybt_item_tags":{ "string":[ "[\"https:\/\/gw.alicdn.com\/tfs\/TB1CvN50KH2gK0jSZJnXXaT1FXa-167-42.png?getAvatar=avatar\"", "\"https:\/\/gw.alicdn.com\/tfs\/TB10rZqkCR26e4jSZFEXXbwuXXa-132-42.png?getAvatar=avatar\"]" ] }, "bybt_coupon_amount":"10.00", "bybt_show_price":"100.00", "bybt_lowest_price":"200.00", "bybt_end_time":"1559750399000", "bybt_start_time":"1559750399000" }, "tt_sold_count":"200+", "maifan_promotion":{ "maifan_promotion_end_time":"1559750399000", "maifan_promotion_start_time":"1559750399000", "maifan_promotion_discount":"200", "maifan_promotion_condition":"100" }, "cpa_reward_type":"0 1" } ] }, "is_default":"false", "total_count":100 } }
{ "error_response":{ "msg":"Remote service error", "code":50, "sub_msg":"非法参数", "sub_code":"isv.invalid-parameter" } }
错误码 | 错误描述 | 解决方案 |
---|---|---|
isv.invalid-parameter | 参数填写不正确 | 参数填写不正确 |
602 | 调用次数超出 | |
603 | 未找到用户或该用户未注册 | 请输入正确的appkey |
604 | 未知参数错误 | 建议加入重试机制 |
404 | 参数传入错误_未知参数 | 检查参数类型是否正确 |