API商品提交 接口 /goods/add 说明

乐淘淘吧

1.提交接口

2.提交的数据类型

3.提交的商品参数以及格式

请老张写个例子，怎么提交一个商品或者多个商品到服务器。谢谢

老张

请求方式：POST

请求地址： /goods/add

系统输入参数：

appkey	授权API的appkey
appsecret	授权API的appsecret

应用级别输入参数：

参数名称	参数值格式
goodsdata	{size:'10',data:[{},{},{}]}

{size:'10',data:[{},{},{}]} 解释

size 表示 data 中商品的数量

data 中数据 参数名称 示例 以及说明

参数名称	参数含义	要求	示例
title	商品标题	长度<=200  不能为空	毛呢外套女韩范中长款羊毛妮子女装
cid	商品归属分类ID	数字 ,不能和 bid 同时为0	1
bid	商品归属品牌ID	数字 ,不能和 cid 同时为0	1
tid	商品ID	数字,长度小于20 大于 7	525834109094
intro	商品简介 （小编推荐）	可空	毛呢外套女韩范中长款羊毛妮子女装
tag	商品促销标签	长度小于 20 ，可空	今日特价
nick	买家昵称	可空	飞飞侠
img_url	商品图片	须是以 http:// 或https:// 开头的完整地址
price	商品原价	必填  小数 或 整数 不能 <=0	12.3
yprice	优惠价格	必填  小数 或 整数 不能 <=0	10.2
mprice	手机专项价格	必填  小数 或 整数 不能 <=0	9.5
pc_click_url	pc版推广链接	可空
wl_click_url	wap版推广链接	可空
volume	销量	可空	1200
start_time	开始时间	数字 ，从1970-1-1 日到 当前的时间戳	1457980407
end_time	结束时间	数字 ，从1970-1-1 日到 当前的时间戳	1457980407
type	商品类型	单个字符， B 天猫  C 淘宝 J 京东 M 美丽说，默认 C  。	B
baoyou	是否包邮	数字 0 表示不包邮 ，1 包邮 ，默认 0	1
source	来源	数字，要求小于255 ，可空，默认 0	1
isshow	是否显示	数字 0 隐藏 1 显示 默认 1	1
likes	收藏数量	数字  默认 0	12356
gtype	商品归属	1 阿里 ，2 京东 ，3 美丽说  ，默认 1	1
status	商品状态	1 正常，0不正常（下架） 默认 1	1
isbm	是否报名商品	1 报名商品 0 非报名商品 ，默认 0	0
seo_title	SEO 标题	默认使用 title
seo_keys	SEO 关键词	默认分割 title 得到 以 ， 分割的字符串	女装,裤子,爆款
seo_desc	SEO 描述	默认 使用title
content	商品详情描述	可空
nickid	卖家ID	数字  长度小于20 可空	123456789
shopname	店铺名称	长度小于100   可空	飞飞侠
shopid	店铺ID	数字  长度小于20 可空	123456789
ordid	商品排序	数字 ，越小越靠前，默认9999	2
goodcc	佣金比例	小数 （浮点数）	10.2
goodcr	佣金金额	小数（浮点数）	68.2
coupon_click_url	优惠券链接	字符串     可空	http://dwz.com/
coupon_price	优惠券金额	小数（浮点数）  可空	68.00

goodsdata 值 示例：

1. {"size":2,"data":[{"cid":1,"tid":"521748590119","bid":0,"ordid":9999,"title":"南极人显瘦九分小脚长裤高腰女裤春秋外穿弹力春季常规打底裤薄款","intro":"南极人显瘦九分小脚长裤高腰女裤春秋外穿弹力春季常规打底裤薄款","tag":"亏本冲量","nick":"北森服饰专营店","img_url":"http://img03.taobaocdn.com/bao/uploaded/i3/TB1hO_mHpXXXXXbXVXXXXXXXXXX_!!0-item_pic.jpg","price":138.00,"yprice":19.90,"mbprice":19.90,"pc_click_url":"http://s.click.taobao.com/W6PoUax","wl_click_url":"http://s.click.taobao.com/W6PoUax","volume":288323,"start_time":1457971200,"end_time":1458489600,"type":"B","baoyou":0,"source":0,"goodcc":3.66,"goodcr":18.4,"nickid":"2261164786","shopid":"114555358","shopname":"北森服饰专营店"},{"cid":1,"tid":"525931418565","bid":0,"ordid":9999,"title":"S家原创设计女装 2016春季新款春装欧美连帽宽松风衣中长款外套女","intro":"S家原创设计女装 2016春季新款春装欧美连帽宽松风衣中长款外套女","tag":"","nick":"思思0117","img_url":"http://img04.taobaocdn.com/bao/uploaded/i4/TB1btu0LVXXXXXbXFXXXXXXXXXX_!!0-item_pic.jpg","price":298.00,"yprice":298.00,"mbprice":298.00,"pc_click_url":"http://s.click.taobao.com/AyWoUax","wl_click_url":"http://s.click.taobao.com/AyWoUax","volume":2653,"start_time":1457971200,"end_time":1458489600,"type":"C","baoyou":0,"source":0,"goodcc":14.9,"goodcr":5.0,"nickid":"65325714","shopid":"36441480","shopname":"S家原创设计女装"}]}

复制代码

goodsdata 格式化：




发送给接口的  完整数据 （含API）

1. appkey=1217738465&appsecret=HgD1hXa2olcJmisqQjjL5XTlY1AbzVk7&goodsdata=JTdiJTIyc2l6ZSUyMiUzYTIlMmMlMjJkYXRhJTIyJTNhJTViJTdiJTIyY2lkJTIyJTNhMSUyYyUyMnRpZCUyMiUzYSUyMjUyMTc0ODU5MDExOSUyMiUyYyUyMmJpZCUyMiUzYTAlMmMlMjJvcmRpZCUyMiUzYTk5OTklMmMlMjJ0aXRsZSUyMiUzYSUyMiVlNSU4ZCU5NyVlNiU5ZSU4MSVlNCViYSViYSVlNiU5OCViZSVlNyU5OCVhNiVlNCViOSU5ZCVlNSU4OCU4NiVlNSViMCU4ZiVlOCU4NCU5YSVlOSU5NSViZiVlOCVhMyVhNCVlOSVhYiU5OCVlOCU4NSViMCVlNSVhNSViMyVlOCVhMyVhNCVlNiU5OCVhNSVlNyVhNyU4YiVlNSVhNCU5NiVlNyVhOSViZiVlNSViYyViOSVlNSU4YSU5YiVlNiU5OCVhNSVlNSVhZCVhMyVlNSViOCViOCVlOCVhNyU4NCVlNiU4OSU5MyVlNSViYSU5NSVlOCVhMyVhNCVlOCU5NiU4NCVlNiVhYyViZSUyMiUyYyUyMmludHJvJTIyJTNhJTIyJWU1JThkJTk3JWU2JTllJTgxJWU0JWJhJWJhJWU2JTk4JWJlJWU3JTk4JWE2JWU0JWI5JTlkJWU1JTg4JTg2JWU1JWIwJThmJWU4JTg0JTlhJWU5JTk1JWJmJWU4JWEzJWE0JWU5JWFiJTk4JWU4JTg1JWIwJWU1JWE1JWIzJWU4JWEzJWE0JWU2JTk4JWE1JWU3JWE3JThiJWU1JWE0JTk2JWU3JWE5JWJmJWU1JWJjJWI5JWU1JThhJTliJWU2JTk4JWE1JWU1JWFkJWEzJWU1JWI4JWI4JWU4JWE3JTg0JWU2JTg5JTkzJWU1JWJhJTk1JWU4JWEzJWE0JWU4JTk2JTg0JWU2JWFjJWJlJTIyJTJjJTIydGFnJTIyJTNhJTIyJWU0JWJhJThmJWU2JTljJWFjJWU1JTg2JWIyJWU5JTg3JThmJTIyJTJjJTIybmljayUyMiUzYSUyMiVlNSU4YyU5NyVlNiVhMyVhZSVlNiU5YyU4ZCVlOSVhNSViMCVlNCViOCU5MyVlOCU5MCVhNSVlNSViYSU5NyUyMiUyYyUyMmltZ191cmwlMjIlM2ElMjJodHRwJTNhJTJmJTJmaW1nMDMudGFvYmFvY2RuLmNvbSUyZmJhbyUyZnVwbG9hZGVkJTJmaTMlMmZUQjFoT19tSHBYWFhYWGJYVlhYWFhYWFhYWFhfISEwLWl0ZW1fcGljLmpwZyUyMiUyYyUyMnByaWNlJTIyJTNhMTM4LjAwJTJjJTIyeXByaWNlJTIyJTNhMTkuOTAlMmMlMjJtYnByaWNlJTIyJTNhMTkuOTAlMmMlMjJwY19jbGlja191cmwlMjIlM2ElMjJodHRwJTNhJTJmJTJmcy5jbGljay50YW9iYW8uY29tJTJmVzZQb1VheCUyMiUyYyUyMndsX2NsaWNrX3VybCUyMiUzYSUyMmh0dHAlM2ElMmYlMmZzLmNsaWNrLnRhb2Jhby5jb20lMmZXNlBvVWF4JTIyJTJjJTIydm9sdW1lJTIyJTNhMjg4MzIzJTJjJTIyc3RhcnRfdGltZSUyMiUzYTE0NTc5NzEyMDAlMmMlMjJlbmRfdGltZSUyMiUzYTE0NTg0ODk2MDAlMmMlMjJ0eXBlJTIyJTNhJTIyQiUyMiUyYyUyMmJhb3lvdSUyMiUzYTAlMmMlMjJzb3VyY2UlMjIlM2EwJTJjJTIyZ29vZGNjJTIyJTNhMy42NiUyYyUyMmdvb2RjciUyMiUzYTE4LjQlMmMlMjJuaWNraWQlMjIlM2ElMjIyMjYxMTY0Nzg2JTIyJTJjJTIyc2hvcGlkJTIyJTNhJTIyMTE0NTU1MzU4JTIyJTJjJTIyc2hvcG5hbWUlMjIlM2ElMjIlZTUlOGMlOTclZTYlYTMlYWUlZTYlOWMlOGQlZTklYTUlYjAlZTQlYjglOTMlZTglOTAlYTUlZTUlYmElOTclMjIlN2QlMmMlN2IlMjJjaWQlMjIlM2ExJTJjJTIydGlkJTIyJTNhJTIyNTI1OTMxNDE4NTY1JTIyJTJjJTIyYmlkJTIyJTNhMCUyYyUyMm9yZGlkJTIyJTNhOTk5OSUyYyUyMnRpdGxlJTIyJTNhJTIyUyVlNSVhZSViNiVlNSU4ZSU5ZiVlNSU4OCU5YiVlOCVhZSViZSVlOCVhZSVhMSVlNSVhNSViMyVlOCVhMyU4NSsyMDE2JWU2JTk4JWE1JWU1JWFkJWEzJWU2JTk2JWIwJWU2JWFjJWJlJWU2JTk4JWE1JWU4JWEzJTg1JWU2JWFjJWE3JWU3JWJlJThlJWU4JWJmJTllJWU1JWI4JWJkJWU1JWFlJWJkJWU2JTlkJWJlJWU5JWEzJThlJWU4JWExJWEzJWU0JWI4JWFkJWU5JTk1JWJmJWU2JWFjJWJlJWU1JWE0JTk2JWU1JWE1JTk3JWU1JWE1JWIzJTIyJTJjJTIyaW50cm8lMjIlM2ElMjJTJWU1JWFlJWI2JWU1JThlJTlmJWU1JTg4JTliJWU4JWFlJWJlJWU4JWFlJWExJWU1JWE1JWIzJWU4JWEzJTg1KzIwMTYlZTYlOTglYTUlZTUlYWQlYTMlZTYlOTYlYjAlZTYlYWMlYmUlZTYlOTglYTUlZTglYTMlODUlZTYlYWMlYTclZTclYmUlOGUlZTglYmYlOWUlZTUlYjglYmQlZTUlYWUlYmQlZTYlOWQlYmUlZTklYTMlOGUlZTglYTElYTMlZTQlYjglYWQlZTklOTUlYmYlZTYlYWMlYmUlZTUlYTQlOTYlZTUlYTUlOTclZTUlYTUlYjMlMjIlMmMlMjJ0YWclMjIlM2ElMjIlMjIlMmMlMjJuaWNrJTIyJTNhJTIyJWU2JTgwJTlkJWU2JTgwJTlkMDExNyUyMiUyYyUyMmltZ191cmwlMjIlM2ElMjJodHRwJTNhJTJmJTJmaW1nMDQudGFvYmFvY2RuLmNvbSUyZmJhbyUyZnVwbG9hZGVkJTJmaTQlMmZUQjFidHUwTFZYWFhYWGJYRlhYWFhYWFhYWFhfISEwLWl0ZW1fcGljLmpwZyUyMiUyYyUyMnByaWNlJTIyJTNhMjk4LjAwJTJjJTIyeXByaWNlJTIyJTNhMjk4LjAwJTJjJTIybWJwcmljZSUyMiUzYTI5OC4wMCUyYyUyMnBjX2NsaWNrX3VybCUyMiUzYSUyMmh0dHAlM2ElMmYlMmZzLmNsaWNrLnRhb2Jhby5jb20lMmZBeVdvVWF4JTIyJTJjJTIyd2xfY2xpY2tfdXJsJTIyJTNhJTIyaHR0cCUzYSUyZiUyZnMuY2xpY2sudGFvYmFvLmNvbSUyZkF5V29VYXglMjIlMmMlMjJ2b2x1bWUlMjIlM2EyNjUzJTJjJTIyc3RhcnRfdGltZSUyMiUzYTE0NTc5NzEyMDAlMmMlMjJlbmRfdGltZSUyMiUzYTE0NTg0ODk2MDAlMmMlMjJ0eXBlJTIyJTNhJTIyQyUyMiUyYyUyMmJhb3lvdSUyMiUzYTAlMmMlMjJzb3VyY2UlMjIlM2EwJTJjJTIyZ29vZGNjJTIyJTNhMTQuOSUyYyUyMmdvb2RjciUyMiUzYTUuMCUyYyUyMm5pY2tpZCUyMiUzYSUyMjY1MzI1NzE0JTIyJTJjJTIyc2hvcGlkJTIyJTNhJTIyMzY0NDE0ODAlMjIlMmMlMjJzaG9wbmFtZSUyMiUzYSUyMlMlZTUlYWUlYjYlZTUlOGUlOWYlZTUlODglOWIlZTglYWUlYmUlZTglYWUlYTElZTUlYTUlYjMlZTglYTMlODUlMjIlN2QlNWQlN2Q=

复制代码

注：goodsdata= 后的值 已经进行了url编码 后又进行了base64编码

注意事项：

建议对 goodsdata 的值进行 URL编码  然后再进行base64编码 主要为了防止被拦截



返回值说明

{"code":200,"msg":"\u6570\u636e\u89e3\u6790\u6210\u529f","succ":2}

code 200 请求成功，succ 添加成功数量 msg 提示信息

code 0 表示 没有商品被发送，或者 size 值和data中的商品数量不对应 或者 解析失败

code 4000 表示请求 方式错误

code 410  表示 请求的API接口或者没有授权  不存在

code 400  表示 API 的appkey 或者 appsecret  格式错误 或者 不存在  或未启用 或 不匹配。

乐淘淘吧

老张 发表于 2016-3-15 03:06
请求方式：POST

请求地址： /goods/add

好强大，问个小白的问题 API，既然是POST提交 怎么抓不到包

补充内容 (2016-3-15 17:35):
已经解决了

乐淘淘吧

老张 发表于 2016-3-15 03:06
请求方式：POST

请求地址： /goods/add

商品分类ID，虽然可以手动加上。  但是，加个商品分类获取API 更好

wangyongligood

老张 发表于 2016-3-15 03:06
请求方式：POST

请求地址： /goods/add

没有优惠券方面的相关参数吗？

老张

wangyongligood 发表于 2016-7-7 23:45
没有优惠券方面的相关参数吗？

有，API已完善