乐淘淘吧 发表于 2016-3-14 21:03:59

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

1.提交接口

2.提交的数据类型

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

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

老张 发表于 2016-3-15 03:06:11

请求方式：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 值 示例：

{"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）

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 13:18:44

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

请求地址： /goods/add


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

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

乐淘淘吧 发表于 2016-4-11 05:39:31

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

请求地址： /goods/add


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

wangyongligood 发表于 2016-7-7 23:45:26

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

请求地址： /goods/add


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

老张 发表于 2016-7-8 08:14:34

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

有，API已完善
页: [1]
查看完整版本: API商品提交 接口 /goods/add 说明