开发者文档
注册商品

接口说明

本接口用于提供给第三方平台或是卖家自有系统集成产品注册功能。

使用场景

卖家可以通过该接口实现新产品注册功能,保存至产品列表。

请求说明

URL

http://api.winit.com.cn/ADInterface/api

接口测试

http://erp.sandbox.winit.com.cn/ADInterface/api

验证方式

Token,md5

格式

json

http请求方式

http

请求数限制

默认每分钟300,有需要可以申请加大

 

参数说明 

名称

类型

必填

说明

示例 

productCode

String(100)

Y

客户注册产品时命名的产品编码,不可修改


specification

String(255)

N

产品规格


chineseName

String(255)

Y

中文名称


englishName

String(255)

Y

英文名称


categoryOne

String(22)

Y

产品类别1


categoryTwo

String(22)

N

产品类别2


categoryThree

String(22)

N

二级类别有数值时,三级类别为可填,否则无效

产品类别3


registeredWeight

Numeric(10,2)

Y

注册重量(kg)


fixedVolumeWeight

String(1)

Y

重量体积是否固定

Y|N必选其一(目前不可更改,默认为Y)


registeredLength

Numeric(10,2)

Y

注册长度(cm)


registeredWidth

Numeric(10,2)

Y

注册宽度(cm)


registeredHeight

Numeric(10,2)

Y

注册高度(cm)


branded

String(1)

Y

是否有品牌

Y|N必选其一


brandedName

String(127)

当branded为Y时,brandedname为必填

品牌名称(当branded为Y时必填且可修改)


model

String(127)

当branded为Y时为必填

当brandedname为Y时为必填


displayPageUrl

String(255)

Y

Ebay网页展示URL


remark

String(255)

N

备注


exportcountry

String(22)

Y

出口国家


inporCountry

String(22)

Y

进口国家


inportDeclaredvalue

Numeric(10,2)

Y

进口申报价


exportDeclaredvalue

Numeric(10,2)

Y

出口申报价


battery

String(1)

Y

是否有电池,Y|N必选其一,默认为N



请求示例

 {
    "action":"registerProduct",
    "app_key":"rebecca",
    "data":{
        "productList":[
            {
                "productCode":"EAKKK004",
                "chineseName":"PowerBuyerDEF456",
                "englishName":"34BayItemI34245",
                "categoryOne":"1001",
                "categoryTwo":"1SDDW",
                "categoryThree":"2",
                "registeredWeight":2,
                "fixedVolumeWeight":"Y",
                "registeredLength":4,
                "registeredWidth":4,
                "registeredHeight":4,
                "branded":"Y",
                "brandedName":"HHG",
                "model":"HG",
                "displayPageUrl":"www.demo_icon.com",
                "remark":"e",
                "exportCountry":"CN",
                "inporCountry":"AU",
                "inportDeclaredvalue":33,
                "exportDeclaredvalue":34,
                "battery":"Y"
            }
,
            {
                "productCode":"EAKKK005",
                "chineseName":"PowerBuyerDEF456",
                "englishName":"34BayItemI34245",
                "categoryOne":"1001",
                "categoryTwo":"1SDDW",
                "categoryThree":"2",
                "registeredWeight":2,
                "fixedVolumeWeight":"Y",
                "registeredLength":4,
                "registeredWidth":4,
                "registeredHeight":4,
                "branded":"Y",
                "brandedName":"HHG",
                "model":"HG",
                "displayPageUrl":"www.demo_icon.com",
                "remark":"e",
                "exportCountry":"CN",
                "inporCountry":"AU",
                "inportDeclaredvalue":33,
                "exportDeclaredvalue":34,
                "battery":"Y"
            }

        ]

    }
,
    "format":"json",
    "language":"zh_CN",
    "platform":"SELLERERP",
    "sign":"C63773DBFF9EC5901EDFE447769815C5",
    "sign_method":"md5",
    "timestamp":"2015-06-16 00:19:26",
    "version":"1.0"
}

返回结果示例 

{
    "code":0,
    "data":[
        {
            "productCode":"EAKKK004"
        }
,
        {
            "productCode":"EAKKK005"
        }

    ]
,
    "msg":"成功"
}

返回参数说明

正确的返回结果:产品注册成功。

错误的返回结果:产品注册失败。