前言我应该是为数不多的在文章中直接展示界面文档的人。这篇文章我想了很久,要不要分析一下商品界面开发的注意点。客户端开发和服务端开发既是天敌又是兄弟。希望本文能帮助大家减少纠纷,给对方“爱”。界面设计简述在电子商务系统的设计中,比较复杂的界面是商品详情界面,响应参数特别繁杂。在开发获取商品详情的接口时,应遵循以下原则。返回的JSON嵌套数量要少,方便查询指定SKU。其他接口相关规格查询SKU。关于查询SKU,我让我的小伙伴做的。首先取出规格和属性"selectcolor":[{"name":"silver","id":75}],"selectversion":[{"name":"publicversion","id":77},{"name":"【原延保版】","id":78}],"memory":[{"name":"64G","id":82},{"name":"256G","id":83}],没错,你没看错,其实就是把规范作为键,把属性作为值。取出value[id]并拼接找到对应的SKU。响应参数[规格名称][属性代码]=拼接SKU字符串的必要规格相当于一个组,属性其实是拼接SKU的重要组成部分。以上数据为示例。75_77_82=silver,公版,64G接口文档请求地址/v1/product/{productId}请求类型GET请求参数参数类型默认值说明productIdint0产品编码响应示例{"code":200,"message":"获取成功","data":{"id":131,"name":"苹果iPhoneX(A1865)64GB太空灰联通电信4G手机","price":"8388.00","market_price":"8388.00","sketch":"iPhone大法不错,10折,打折10折,速购","intro":"这是产品描述","keywords":['apple','iphone'],"attribute":{"Chooseacolor":[{"name":"Silver","id":75},{"name":"SpaceGray","id":76}],"SelectVersion":[{"name":"公版","id":77},{"name":"【原延保版】","id":78},{"name":"双网通版","id":79},{"name":"无线充电套餐","id":80},{"name":"Airpods套餐","id":81}],"Memory":[{"姓名":"64G","id":82},{"name":"256G","id":83}],"购买方式":[{"name":"官方标准配置","id":84},{"name":"移动优惠购","id":85},{"name":"电信优惠购","id":86},{"name":"联通优惠购","id":87}]},"album":[{"id":2,"name":"这是第一张图片","url":"http://xxx.com/59ec33eaN6ddb0c54.jpg"},{"id":3,"name":"这是第二张图片","url":"http://xxx.com/59ec3400Nce4cc116.jpg"}],"radio":{"id":1,"name":"Thisisavideo","url":"http://xxx.com/1.mp4"},"sku":{"75_77_82_84":{"id":1018,"name":"选择颜色:银色;选择版本:公版;内存:64G;购买方式:官方标准;","price":"8388.00","stock":83888388},"75_77_82_85":{"id":1019,"name":"选择颜色:银色;选择版本:公开版;内存:64G;购买方式:手机优惠购买;","price":"8388.00","stock":83888388},"75_77_82_86":{"id":1020,"name":"选择颜色:银色;选择版本:公版;内存:64G;购买方式:电信优惠购买;,"price":"8388.00","stock":83888388},"75_77_82_87":{"id":1021,"name":"选择颜色:silver;选择版本:公版;内存:64G;购买方式:联通优惠购买;","price":"8388.00","stock":83888388},"75_77_83_84":{"id":1022,"name":"选择颜色:银色;选择版本:公开版;内存:256G;购买方式:官方标准;","price":"8388.00","stock":83888388},"75_77_83_85":{"id":1023,"name":"选择颜色:银色;选择版本:公开版;内存:256G;购买方式:手机打折购买;","price":"8388.00","stock":83888388}}}}响应参数描述核心参数参数类型默认值描述idint0商品代码namestring-商品标题pricedouble00.00商品价格keywordsstring-commoditykeywordmarket_pricedouble00.00marketpricevirtualint0virtualsalessketchstring-commoditybriefintrostring-commoditydetailcommoditymapparametertypedefaultvaluedescriptionalbum[]array[]Productcarouselimageidint0resourcecodenamestring-图片名称urlstring-资源路径商品视频参数返回如果没有video[]参数类型默认值说明radio[]array[]productvideoidint0资源代码名string-视频名urlstring-资源路径产品规格/属性参数参数类型默认值描述attributearray[][]商品属性[(attr_name)][]array[][]属性名namestring-属性商品名称idint0属性商品代码商品SKU参数参数类型默认值描述sku[]array[][]商品sku[(option_id)][]array[]商品SKU查询方式为attribute(attr_name)拼接idint0skucodenamestring-skunamepricedouble00.00商品价格stockint0商品库存致谢字数不多,说清楚就好,感谢阅读本文,希望本文能对您有所帮助,有问题可以在评论区讨论,谢谢
