API接口使用方法（封装好的电商平台）

为了进行此平台API的调用，首先我们需要做下面几件事情。

1、 获取一个KEY。 点击获取

2、 参考API文档里的接入方式和示例。

3、查看测试工具是否有需要的接口，响应实例的返回字段是否符合参数要求。

4、利用平台的文档中心和API测试工具，对接口进行测试、程序获取。

公共参数

名称	类型	必须	描述
key	String	是	调用key（必须以GET方式拼接在URL中）
secret	String	是	调用密钥
api_name	String	是	API接口名称（包括在请求地址中）[item_search,item_get,item_search_shop等]
cache	String	否	[yes,no]默认yes，将调用缓存的数据，速度比较快
result_type	String	否	[json,jsonu,xml,serialize,var_export]返回数据格式，默认为json，jsonu输出的内容中文可以直接阅读
lang	String	否	[cn,en,ru]翻译语言，默认cn简体中文
version	String	否	API版本

{
	"items": {
		"url": "https://search.jd.com/Search?keyword=男装&enc=utf-8&wq=男装&pvid=33dbb420d9fa4ca483a869f2e4c5625c",
		"keyword": "男装",
		"page": "",
		"real_total_results": 4400,
		"total_results": 4400,
		"pagecount": 74,
		"products_total": "",
		"list_count": "",
		"page_size": "60",
		"item": [
			{
				"num_iid": "10056862169263",
				"detail_url": "https://item.jd.com/10056862169263.html",
				"title": "海澜优选 官方品牌夹克男外套上衣男士秋冬季新款纯色商务中青年春秋连帽冲锋茄克衫学生休闲上衣男装服饰 2186黑色(加绒款) XL(126斤-140斤)",
				"pic_url": "//img13.360buyimg.com/n7/jfs/t1/130046/25/32488/89877/638fec01E148f1543/d198ce27d7ff28a5.jpg",
				"price": 219,
				"promotion_price": 219,
				"sales": null,
				"sample_id": "",
				"post_fee": "",
				"area": "",
				"seller": "海澜优选拼伦专卖店"
			},
			{
				"num_iid": "10058341876105",
				"detail_url": "https://item.jd.com/10058341876105.html",
				"title": "海澜优选 官方品牌外套男羊羔绒夹克加绒加厚上衣男士秋冬季新款中青年休闲舒适柔软加厚抗起球休闲男装A350-2122黑色 2XL（推荐125斤-140斤）",
				"pic_url": "//img10.360buyimg.com/n7/jfs/t1/186343/7/30990/132260/638bf6e0E6bad2f99/a5dc65b682d03b4b.jpg",
				"price": 159,
				"promotion_price": 159,
				"sales": null,
				"sample_id": "",
				"post_fee": "",
				"area": "",
				"seller": "海澜优选拼伦专卖店"
			},
			{
				"num_iid": "10058384218794",
				"detail_url": "https://item.jd.com/10058384218794.html",
				"title": "雾卡【纯棉3件装】长袖t恤男士新款纯色棉潮流春秋装秋衣T恤体恤内搭上衣服 【3件装】PK铁灰+EXP卡其+炫彩黑 XL码 135斤-150斤",
				"pic_url": "//img14.360buyimg.com/n7/jfs/t1/147255/16/30541/62349/630377c7Ead72d641/b65b95b923170b6c.jpg",
				"price": 79,
				"promotion_price": 79,
				"sales": null,
				"sample_id": "",
				"post_fee": "",
				"area": "",
				"seller": "新胜服饰专营店"
			},
			{
				"num_iid": "100032063613",
				"detail_url": "https://item.jd.com/100032063613.html",
				"title": "吉普（JEEP）夹克男外套2022秋冬季韩版男士上衣宽松连帽纯色百搭男装黑色 XL",
				"pic_url": "//img13.360buyimg.com/n7/jfs/t1/124339/21/32093/77400/6359fd42E4074ded1/03bcea56c327d550.jpg",
				"price": 188,
				"promotion_price": 188,
				"sales": null,
				"sample_id": "",
				"post_fee": "",
				"area": "",
				"seller": "jeep男装京东自营专区"
			},
			{
				"num_iid": "10060352674947",
				"detail_url": "https://item.jd.com/10060352674947.html",
				"title": "海澜优选 官方品牌棉衣男棉服外套男士上衣服冬季外衣新款中青年胖子连帽面包服学生春秋纯色保暖防寒男装5023黑色 2XL(140斤-165斤)",
				"pic_url": "//img12.360buyimg.com/n7/jfs/t1/162121/10/33530/52247/638d4caeEe5cc281c/459bf86b48e0ba3a.jpg",
				"price": 199,
				"promotion_price": 199,
				"sales": null,
				"sample_id": "",
				"post_fee": "",
				"area": "",
				"seller": "海澜优选昱嘉专卖店"
			},
			{
				"num_iid": "1537495822",
				"detail_url": "https://item.jd.com/1537495822.html",
				"title": "朴祺春秋款棉运动裤男休闲裤中老年款针织裤卫裤跑步裤男士运动长裤 深蓝色 XL码2尺2-2尺4腰围",
				"pic_url": "//img12.360buyimg.com/n7/jfs/t1/50957/37/11132/85536/5d82d571E0111f843/55057a8427971098.jpg",
				"price": 85,
				"promotion_price": 85,
				"sales": null,
				"sample_id": "",
				"post_fee": "",
				"area": "",
				"seller": "朴祺男装旗舰店"
			},
			{
				"num_iid": "56164856158",
				"detail_url": "https://item.jd.com/56164856158.html",
				"title": "【两件装\\\\\\/加绒可选】长袖T恤男秋冬季男装男士圆领卫衣潮流时尚百搭T恤男长袖打底衫上衣服男WY02白+05灰 XL",
				"pic_url": "//img13.360buyimg.com/n7/jfs/t1/196000/36/20439/128544/612b018cE213b872c/904c84165606b356.jpg",
				"price": 88,
				"promotion_price": 88,
				"sales": null,
				"sample_id": "",
				"post_fee": "",
				"area": "",
				"seller": "衣品男服饰专营店"
			},
			{
				"num_iid": "10037948124680",
				"detail_url": "https://item.jd.com/10037948124680.html",
				"title": "秋冬季男牛仔裤 微弹修身潮流时尚小直筒青少年休闲运动工装百搭松紧带长裤子 130黑色+139灰色【秋冬/微弹】8成人选 31码【（2尺4）体重125-140斤】",
				"pic_url": "//img10.360buyimg.com/n7/jfs/t1/169633/22/21483/116891/6176874fEeb552ca6/3446b6abe26a05ce.jpg",
				"price": 0,
				"promotion_price": 0,
				"sales": null,
				"sample_id": "",
				"post_fee": "",
				"area": "",
				"seller": "至上合服饰专营店"
			},
			{
				"num_iid": "10058315387836",
				"detail_url": "https://item.jd.com/10058315387836.html",
				"title": "海澜优选 官方品牌夹克男外套上衣男士秋冬季新款商务中青年春秋立领简约轻潮舒适百搭时尚休闲加绒加厚男装2210卡其 XL（推荐130斤-155斤）",
				"pic_url": "//img11.360buyimg.com/n7/jfs/t1/179597/37/30845/94169/638ff060E9b244d0d/bfa463180dd9957e.jpg",
				"price": 159,
				"promotion_price": 159,
				"sales": null,
				"sample_id": "",
				"post_fee": "",
				"area": "",
				"seller": "海澜优选昱嘉专卖店"
			},
			{
				"num_iid": "10036527470578",
				"detail_url": "https://item.jd.com/10036527470578.html",
				"title": "海澜优选【两件装】官方品牌长袖t恤男秋冬季新款加绒保暖男装体恤男士卫衣印花打底衫宽松上衣服男6909海蓝#不加绒+6908白色#不加绒 XL（建议130-150...",
				"pic_url": "//img13.360buyimg.com/n7/jfs/t1/92076/32/35086/756032/6386c35aEa1fc7b36/908f7965bcd860a4.png",
				"price": 138,
				"promotion_price": 138,
				"sales": null,
				"sample_id": "",
				"post_fee": "",
				"area": "",
				"seller": "海澜优选极澜专卖店"
			},
			{
				"num_iid": "10061554022439",
				"detail_url": "https://item.jd.com/10061554022439.html",
				"title": "南极人外套男秋冬季潮流宽松休闲男士夹克加绒加厚棒球服厚棉服秋冬装男装衣服 小方块黑色 XL 建议110-125斤",
				"pic_url": "//img14.360buyimg.com/n7/jfs/t1/39667/10/21098/93495/637f0151E35bba8fc/80a20fce12c6c22e.jpg",
				"price": 59,
				"promotion_price": 59,
				"sales": null,
				"sample_id": "",
				"post_fee": "",
				"area": "",
				"seller": "南极人羽绒服旗舰店"
			},
			{
				"num_iid": "10786385508",
				"detail_url": "https://item.jd.com/10786385508.html",
				"title": "朴祺冬季男士运动裤男长裤宽松大码直筒休闲裤加绒加厚纯棉针织卫裤 深蓝色 4XL码2尺9-3尺0腰围",
				"pic_url": "//img13.360buyimg.com/n7/jfs/t3295/322/3889604068/168616/c15995cc/57fb1b6cN6b0ad481.jpg",
				"price": 109,
				"promotion_price": 109,
				"sales": null,
				"sample_id": "",
				"post_fee": "",
				"area": "",
				"seller": "朴祺男装旗舰店"
			},
			{
				"num_iid": "10058962388828",
				"detail_url": "https://item.jd.com/10058962388828.html",
				"title": "NASAGOOD旗舰店官网联名潮牌外套男春秋季潮流休闲夹克男士工装运动棒球服青少年加绒上衣服秋装男冬 NA11白色（常规款） XL（建议125-145斤）",
				"pic_url": "//img13.360buyimg.com/n7/jfs/t1/18118/26/17732/122900/6330365bEb3fc8743/8f1b24f2bc027f12.jpg",
				"price": 138,
				"promotion_price": 138,
				"sales": null,
				"sample_id": "",
				"post_fee": "",
				"area": "",
				"seller": "NASAGOOD旗舰店"
			},
			{
				"num_iid": "100036029581",
				"detail_url": "https://item.jd.com/100036029581.html",
				"title": "罗蒙（ROMON）夹克男秋冬季潮流时尚纯色仿羊羔绒加绒立领抓绒衣柔软舒适摇粒绒外套男装深蓝加绒1927 XL",
				"pic_url": "//img11.360buyimg.com/n7/jfs/t1/183847/38/29144/74499/63508f69E71070bf2/6c9e813fab25391c.jpg",
				"price": 198,
				"promotion_price": 198,
				"sales": null,
				"sample_id": "",
				"post_fee": "",
				"area": "",
				"seller": "罗蒙（ROMON）京东自营旗舰店"
			},
			{
				"num_iid": "10038005377438",
				"detail_url": "https://item.jd.com/10038005377438.html",
				"title": "男士冲锋衣冬季 男女户外冲锋衣加绒加厚棉服外套反光条骑车防风衣定制劳保工作服 版黑色-加绒加厚 3XL 【建议130-150斤】",
				"pic_url": "//img13.360buyimg.com/n7/jfs/t1/148739/24/20107/115016/615c0e95E6d1040eb/1b900a87ee4ffe93.jpg",
				"price": 68,
				"promotion_price": 68,
				"sales": null,
				"sample_id": "",
				"post_fee": "",
				"area": "",
				"seller": "诗乐驰户外旗舰店"
			},
			{
				"num_iid": "10061185676941",
				"detail_url": "https://item.jd.com/10061185676941.html",
				"title": "罗蒙男装夹克男外套冲锋衣男士秋冬季新款纯色商务中青年茄克春秋连帽户外舒适透气学生耐磨加绒加厚男装A426-2186黑色（加绒） XL（推荐130斤-145斤...",
				"pic_url": "//img11.360buyimg.com/n7/jfs/t1/99077/9/32490/80973/638f155eE883a2068/01384687f5d7b62b.jpg",
				"price": 129,
				"promotion_price": 129,
				"sales": null,
				"sample_id": "",
				"post_fee": "",
				"area": "",
				"seller": "罗蒙纤缤专卖店"
			},
			{
				"num_iid": "10062852932279",
				"detail_url": "https://item.jd.com/10062852932279.html",
				"title": "夹克男羊羔绒秋冬季加绒加厚牛仔外套男2022工装男士带绒保暖夹克上衣男装黑色加绒 XL",
				"pic_url": "//img14.360buyimg.com/n7/jfs/t1/26403/35/20226/173820/63862e86Ebc514a2c/47c17d482a980031.jpg",
				"price": 138,
				"promotion_price": 138,
				"sales": null,
				"sample_id": "",
				"post_fee": "",
				"area": "",
				"seller": "凡品丹尼旗舰店"
			},
			{
				"num_iid": "10066293379234",
				"detail_url": "https://item.jd.com/10066293379234.html",
				"title": "羽绒服男短款连帽加厚冬季外套男士袄子新款工装保暖中青年舒适柔软休闲防寒服男装【连帽一体】1988黑色 L【建议体重120-135斤】",
				"pic_url": "//img14.360buyimg.com/n7/jfs/t1/145307/21/32007/88368/637e0606E18874d71/cd986ae610999146.jpg",
				"price": 288,
				"promotion_price": 288,
				"sales": null,
				"sample_id": "",
				"post_fee": "",
				"area": "",
				"seller": "风和运服饰旗舰店"
			},
			{
				"num_iid": "10056287914367",
				"detail_url": "https://item.jd.com/10056287914367.html",
				"title": "海澜优选 官方品牌夹克男外套上衣男士秋冬季新款商务中青年春秋立领茄克衫潮流舒适休闲亲肤简约上衣 深灰 2XL（推荐130斤-145斤）",
				"pic_url": "//img12.360buyimg.com/n7/jfs/t1/165503/36/30521/79679/638fefa9Eb0291841/05336c1013dcd6a9.png",
				"price": 159,
				"promotion_price": 159,
				"sales": null,
				"sample_id": "",
				"post_fee": "",
				"area": "",
				"seller": "海澜优选拼伦专卖店"
			},
			{
				"num_iid": "10059159390944",
				"detail_url": "https://item.jd.com/10059159390944.html",
				"title": "海澜优选 官方品牌夹克男外套男士秋冬季新款商务中青年春秋保暖抗皱潮流时尚户外休闲外衣加绒加厚男装服饰 2207黑色 XL（推荐125斤-140斤）",
				"pic_url": "//img14.360buyimg.com/n7/jfs/t1/186651/3/29634/77690/6370472eEd9f6c5e7/a67fcf71893abf57.jpg",
				"price": 142,
				"promotion_price": 142,
				"sales": null,
				"sample_id": "",
				"post_fee": "",
				"area": "",
				"seller": "海澜优选拼伦专卖店"
			},
			{
				"num_iid": "10060330883125",
				"detail_url": "https://item.jd.com/10060330883125.html",
				"title": "卡帝乐鳄鱼棉衣男2022新款外套男秋冬季时尚百搭棉服男加绒加厚青春休闲帅气男士上衣男装棉袄男J118深灰色 2XL（建议140-155斤）",
				"pic_url": "//img10.360buyimg.com/n7/jfs/t1/208567/37/25906/98226/631d8b55E2023b033/2bfd3b3b5ed8e68d.jpg",
				"price": 169,
				"promotion_price": 169,
				"sales": null,
				"sample_id": "",
				"post_fee": "",
				"area": "",
				"seller": "卡帝乐鳄鱼蕈油专卖店"
			},
			{
				"num_iid": "10060714168924",
				"detail_url": "https://item.jd.com/10060714168924.html",
				"title": "南极人水貂绒毛衣男秋冬季潮流男士毛衫线衣宽松休闲圆领加厚保暖打底衫青少年男生针织衫冬装衣服男装10909/8270米白 XL",
				"pic_url": "//img14.360buyimg.com/n7/jfs/t1/86512/2/34499/111190/637ef80bEa715edd1/4e5345ebc6141e64.jpg",
				"price": 69,
				"promotion_price": 69,
				"sales": null,
				"sample_id": "",
				"post_fee": "",
				"area": "",
				"seller": "南极人羽绒服旗舰店"
			},
			{
				"num_iid": "10056926444676",
				"detail_url": "https://item.jd.com/10056926444676.html",
				"title": "海澜优选 官方品牌夹克男外套男士秋冬季新款纯色商务中青年春秋休闲时尚连帽不臃肿简约男装XC-2020-JK6268-暗兰 2XL(推荐140斤-160斤)",
				"pic_url": "//img11.360buyimg.com/n7/jfs/t1/33376/9/16414/58208/63174bccE1aa646f3/d423e98a47aecf80.png",
				"price": 214,
				"promotion_price": 214,
				"sales": null,
				"sample_id": "",
				"post_fee": "",
				"area": "",
				"seller": "海澜优选拼伦专卖店"
			},
			{
				"num_iid": "10061029542469",
				"detail_url": "https://item.jd.com/10061029542469.html",
				"title": "法邦伦（FABANGLUN）2022秋冬新款男士皮衣夹克男皮衣翻领绵羊皮中青年男士皮衣外套 黑色 175",
				"pic_url": "//img14.360buyimg.com/n7/jfs/t1/131714/9/28999/78195/638f04bbE65b42aef/deb83624b44da228.jpg",
				"price": 1728,
				"promotion_price": 1728,
				"sales": null,
				"sample_id": "",
				"post_fee": "",
				"area": "",
				"seller": "法邦伦乐商专卖店"
			},
			{
				"num_iid": "10062089962824",
				"detail_url": "https://item.jd.com/10062089962824.html",
				"title": "卡帝乐鳄鱼 半高领毛衣男冬季潮流韩版宽松休闲男装毛衫秋冬装加绒加厚款保暖线衣冬天针织衫衣服 白色 XL",
				"pic_url": "//img14.360buyimg.com/n7/jfs/t1/100830/7/24161/72061/633be14eEc3c2ebe3/07eff644f1d934d1.jpg",
				"price": 89,
				"promotion_price": 89,
				"sales": null,
				"sample_id": "",
				"post_fee": "",
				"area": "",
				"seller": "卡帝乐鳄鱼男装旗舰店"
			},
			{
				"num_iid": "100032558705",
				"detail_url": "https://item.jd.com/100032558705.html",
				"title": "鸭鸭（YAYA）羽绒服男短款连帽厚款保暖青年秋冬季休闲外套男DSZ47B0050黑色175",
				"pic_url": "//img10.360buyimg.com/n7/jfs/t1/172353/7/32480/62618/638dba53Eac3d142a/c5e70ed85eafc740.jpg",
				"price": 499,
				"promotion_price": 499,
				"sales": null,
				"sample_id": "",
				"post_fee": "",
				"area": "",
				"seller": "鸭鸭（YAYA）京东自营专区"
			},
			{
				"num_iid": "10060639159745",
				"detail_url": "https://item.jd.com/10060639159745.html",
				"title": "贵人鸟 棉衣男两面穿冬季棉服加厚纯色治愈色外套男士棉袄子冬天青年立领保暖面包服情侣款 卡其 XL",
				"pic_url": "//img10.360buyimg.com/n7/jfs/t1/102519/18/21892/60444/635d013dE4c77470e/3a7a51a09b447770.jpg",
				"price": 158,
				"promotion_price": 158,
				"sales": null,
				"sample_id": "",
				"post_fee": "",
				"area": "",
				"seller": "贵人鸟男装旗舰店"
			},
			{
				"num_iid": "10061516285796",
				"detail_url": "https://item.jd.com/10061516285796.html",
				"title": "恒源祥100纯羊毛衫男士圆领秋季长袖套头纯色宽松薄款毛衣男打底衫 黑色半高 175/88A 建议穿140-160斤",
				"pic_url": "//img11.360buyimg.com/n7/jfs/t1/28409/32/19584/96558/63327327E856100f7/327922a475fbd572.jpg",
				"price": 138,
				"promotion_price": 138,
				"sales": null,
				"sample_id": "",
				"post_fee": "",
				"area": "",
				"seller": "恒源祥博羽（浦江）专卖店"
			},
			{
				"num_iid": "10036933041752",
				"detail_url": "https://item.jd.com/10036933041752.html",
				"title": "啄木鸟 轻薄羽绒服男款时尚韩版简约百搭长袖连帽白鸭绒抗寒保暖防风短款羽绒服外套男士青年冬季新款上衣服 XG22豆灰 XL",
				"pic_url": "//img12.360buyimg.com/n7/jfs/t1/200629/37/6803/91243/613c10bcEcbc949a2/afe0eed75bd553c0.jpg",
				"price": 198,
				"promotion_price": 198,
				"sales": null,
				"sample_id": "",
				"post_fee": "",
				"area": "",
				"seller": "啄木鸟柚子专卖店"
			}
		],
		"nav_catcamp": null,
		"nav_filter": null,
		"from": "pc"
	},
	"error_code": "0000",
	"reason": "ok",
	"secache": "c8f17c1c668040bcefce002e4877be04",
	"secache_time": 1670381341,
	"secache_date": "2022-12-07 10:49:01",
	"translate_status": "",
	"translate_time": 0,
	"language": {
		"default_lang": "cn",
		"current_lang": "cn"
	},
	"error": "",
	"cache": 0,
	"api_info": "today:107 max:10100 all[230=107+57+66];expires:2030-12-31",
	"execution_time": "7.115",
	"server_time": "Beijing/2022-12-07 10:49:01",
	"client_ip": "106.6.32.52",
	"call_args": {
		"q": "男装",
		"start_price": "0",
		"end_price": "0",
		"page": "1",
		"cat": "0"
	},
	"api_type": "jd",
	"translate_language": "zh-CN",
	"translate_engine": "baidu_api",
	"server_memory": "3.65MB",
	"request_id": "gw-3.638fff1617a32",
	"last_id": "1398359441"
}