微店API解析:商品快递费用获取返回值详解

401 篇文章 0 订阅

微店(Weidian)作为一个流行的电商平台,提供了丰富的API接口供开发者使用,其中包括获取商品快递费用的功能。以下是对微店API中商品快递费用获取功能的返回值详解:

1. 请求方法

首先,你需要通过微店API的文档了解如何发起请求,包括请求的URL、请求方法(GET或POST)、请求参数等。

2. 返回值字段详解

  • errcode:错误码,0表示请求成功,非0表示请求失败或发生错误。
  • errmsg:错误信息,成功时为"success",失败时提供具体的错误原因。
  • data:包含具体的快递费用信息。
    • logistics_id:物流模板ID,用于标识该套运费模板。
    • template_name:物流模板名称,商家自定义的模板名称。
    • add_fee:商家承担运费,表示商家愿意为订单支付的运费金额。
    • free_fee:包邮条件金额,当订单金额达到或超过这个值时,买家可以享受包邮服务。
    • first_fee:首重费用,表示快递的首重费用,单位通常为元。
    • add_fee_per_kg:续重费用,表示快递每增加一公斤的续重费用,单位通常为元/kg。
    • first_weight:首重重量,表示快递的首重重量,单位通常为kg。
    • add_weight:续重重量,表示快递的续重重量,单位通常为kg。
    • designated_area:指定地区运费模板,表示对于某些特定地区,可能有不同的运费规则。
    • default_fee:默认运费,当不满足指定地区运费模板时,使用的默认运费。
    • ...(可能还有其他与快递费用相关的字段,具体以微店API文档为准)
  • micro.item_get

    公共参数

    名称类型必须描述
    keyString调用key(必须以GET方式拼接在URL中)
    secretString调用密钥
    api_nameStringAPI接口名称(包括在请求地址中)[item_search,item_get,item_search_shop等]
    cacheString[yes,no]默认yes,将调用缓存的数据,速度比较快
    result_typeString[json,jsonu,xml,serialize,var_export]返回数据格式,默认为json,jsonu输出的内容中文可以直接阅读
    langString[cn,en,ru]翻译语言,默认cn简体中文
    versionStringAPI版本

 请求参数

请求参数:num_iid=2749499386

参数说明:num_iid:微店商品ID

 返回数据示例

"item": {
		"num_iid": "2749499386",
		"title": "Swarovski施华洛世奇LIFELONG BOW 流苏蝴蝶结浪漫妩媚女款项链饰品礼物5447082",
		"desc_short": "Swarovski施华洛世奇LIFELONG BOW 流苏蝴蝶结浪漫妩媚女款项链饰品礼物5447082",
		"price": 45,
		"total_price": 0,
		"suggestive_price": 0,
		"orginal_price": "45",
		"nick": "达薇妮珠宝",
		"num": "",
		"min_num": 0,
		"detail_url": "https://weidian.com/item.html?itemID=2749499386",
		"pic_url": "https://si.geilicdn.com/pcitem1288244399-3b300000016a3fd26d6f0a217216_800_800.jpg",
		"brand": "",
		"brandId": "",
		"rootCatId": "",
		"cid": "",
		"favcount": "",
		"fanscount": "",
		"crumbs": [],
		"created_time": "",
		"modified_time": "",
		"delist_time": "",
		"desc": "<img src=\"https://si.geilicdn.com/pcitem1288244399-23910000016a40086f230a217216_790_420.jpg\"/><img src=\"https://si.geilicdn.com/pcitem1288244399-25490000016a40086f650a217252_790_402.jpg\"/><img src=\"https://si.geilicdn.com/pcitem1288244399-064c0000016a400870600a21924b_790_503.jpg\"/><img src=\"https://si.geilicdn.com/pcitem1288244399-61250000016a400870900a219248_790_308.jpg\"/><img src=\"https://si.geilicdn.com/pcitem1288244399-0e370000016a400871960a21924a_790_600.jpg\"/><img src=\"https://si.geilicdn.com/pcitem1288244399-25730000016a400874400a217252_790_600.jpg\"/><img src=\"https://si.geilicdn.com/pcitem1288244399-61470000016a400874790a219248_790_600.jpg\"/><img src=\"https://si.geilicdn.com/pcitem1288244399-26c00000016a400875df0a217205_790_600.jpg\"/><img src=\"https://si.geilicdn.com/pcitem1288244399-34850000016a400876a90a20b7b9_790_834.jpg\"/><img src=\"https://si.geilicdn.com/pcitem1288244399-23c00000016a4008754e0a217216_790_379.jpg\"/><img src=\"https://si.geilicdn.com/pcitem1288244399-06800000016a400876500a21924b_790_524.jpg\"/><img src=\"https://si.geilicdn.com/pcitem1288244399-25840000016a400875e90a217252_790_427.jpg\"/>",
		"desc_img": [
			"https://si.geilicdn.com/pcitem1288244399-23910000016a40086f230a217216_790_420.jpg",
			"https://si.geilicdn.com/pcitem1288244399-25490000016a40086f650a217252_790_402.jpg",
			"https://si.geilicdn.com/pcitem1288244399-064c0000016a400870600a21924b_790_503.jpg",
			"https://si.geilicdn.com/pcitem1288244399-61250000016a400870900a219248_790_308.jpg",
			"https://si.geilicdn.com/pcitem1288244399-0e370000016a400871960a21924a_790_600.jpg",
			"https://si.geilicdn.com/pcitem1288244399-25730000016a400874400a217252_790_600.jpg",
			"https://si.geilicdn.com/pcitem1288244399-61470000016a400874790a219248_790_600.jpg",
			"https://si.geilicdn.com/pcitem1288244399-26c00000016a400875df0a217205_790_600.jpg",
			"https://si.geilicdn.com/pcitem1288244399-34850000016a400876a90a20b7b9_790_834.jpg",
			"https://si.geilicdn.com/pcitem1288244399-23c00000016a4008754e0a217216_790_379.jpg",
			"https://si.geilicdn.com/pcitem1288244399-06800000016a400876500a21924b_790_524.jpg",
			"https://si.geilicdn.com/pcitem1288244399-25840000016a400875e90a217252_790_427.jpg"
		],
		"item_imgs": [
			{
				"url": "https://si.geilicdn.com/pcitem1288244399-3b300000016a3fd26d6f0a217216_800_800.jpg"
			}
		],
		"item_weight": "",
		"item_size": "",
		"location": "",
		"post_fee": "",
		"express_fee": "",
		"ems_fee": "",
		"shipping_to": "",
		"has_discount": "",
		"video": [],
		"is_virtual": "",
		"sample_id": "",
		"is_promotion": "false",
		"props_name": "0:561195188:项链:流苏蝴蝶结项链;",
		"prop_imgs": {
			"prop_img": []
		},
		"property_alias": "",
		"props": [],
		"total_sold": "0",
		"skus": {
			"sku": [
				{
					"price": "45.00",
					"orginal_price": "45.00",
					"properties": "0:561195188;",
					"properties_name": "0:561195188:项链:流苏蝴蝶结项链;:",
					"quantity": 957,
					"sku_id": 10668572309
				}
			]
		},
		"seller_id": "",
		"sales": 106,
		"shop_id": 1288244399,
		"props_list": [
			{
				"0:561195188": "项链:流苏蝴蝶结项链"
			}
		],
		"seller_info": {
			"title": "达薇妮珠宝",
			"shop_name": "达薇妮珠宝",
			"zhuy": "https://weidian.com/?userid=1288244399",
			"level": 3,
			"shop_type": 3,
			"user_num_id": 1288244399,
			"nick": "达薇妮珠宝"
		},
		"tmall": "false",
		"error": "",
		"warning": "",
		"url_log": [],
		"stuff_status": "",
		"data_from": "micro",
		"method": "",
		"promo_type": null,
		"props_img": null,
		"rate_grade": "",
		"priceRange": [],
		"shop_item": [],
		"relate_items": []
	},
	"secache": "bca4a25047d7b435e098ecb97efd77dd",
	"secache_time": 1611128224,
	"secache_date": "2021-01-20 15:37:04",
	"translate_status": "",
	"translate_time": 0,
	"language": {
		"default_lang": "cn",
		"current_lang": "cn"
	},
	"error": "",
	"reason": "",
	"error_code": "0000",
	"cache": 0,
	"api_info": "today:0 max:10000",
	"execution_time": 3.061,
	"server_time": "Beijing/2021-01-20 15:37:04",
	"client_ip": "115.151.186.91",
	"call_args": {
		"num_iid": "2749499386",
		"area_id": "440111"
	},
	"api_type": "micro",
	"translate_language": "zh-CN",
	"translate_engine": "baidu",
	"server_memory": "2.75MB",
	"request_id": "1.6007dd9d4909b"

错误码解释

状态代码(error_code)状态信息详细描述是否收费
0000success接口调用成功并返回相关数据
2000Search success but no result接口访问成功,但是搜索没有结果
4000Server internal error服务器内部错误
4001Network error网络错误
4002Target server error目标服务器错误
4003Param error用户输入参数错误忽略
4004Account not found用户帐号不存在忽略
4005Invalid authentication credentials授权失败忽略
4006API stopped您的当前API已停用忽略
4007Account stopped您的账户已停用忽略
4008API rate limit exceeded并发已达上限忽略
4009API maintenanceAPI维护中忽略
4010API not found with these valuesAPI不存在忽略
4012Please add api first请先添加api忽略
4013Number of calls exceeded调用次数超限忽略
4014Missing url param参数缺失忽略
4015Wrong pageToken参数pageToken有误忽略
4016Insufficient balance余额不足忽略
4017timeout error请求超时
5000unknown error未知错误
  • 30
    点赞
  • 12
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值