PHP通用商城对外服务开发指南

1、 天津市网城创想科技有限责任公司PHP 通用商城对外服务开发指南Version: 1.0Public date: 2012-02-16All copyright reservedShopNC.NET第一章 文档描述1 文档说明本操作手册用来指导商城系统客户已有应用实现与商城系统的顺利对接。请相关技术人员详细阅读本手册。2 版本2012-02-161.0侯宝剑3 阅读对象商城系统使用开发人员天津市网城创想科技有限公司对外接口相关人员4 接口联系人职责业务支持姓名孙小姐电mailsunyanQQ97325724职责技术支持姓名侯先生电mail

2、houbaojianQQ463781039第二章 业务功能描述1 作业流程简述1) 第三方应用将请求发送到ShopNC商城系统。2) ShopNC商城系统处理成功后，将处理结果返回给第三方应用。 2 安全控制1 采用商城系统的加密和数字签名认证体系2 通讯使用SSL协议（128位），对数据进行加密3 第三方应用与商城系统数据交互都使用加密，并使用数字签名进行数据验证，确保数据的完整性和不可抵赖性第三章 用户登录接口协议1 接入URL2 接入方式POST/GET方式 3 协议传输参数字段名填写类型说明sign必填签名结果cs选填字符编码标准，gbk或者utf-8，默认为utf-84 签名规则re

3、quest = “cmdno=1&username=shopnc&password=123456&appid=12”encode = base64_encode(request)sign = encode KEY参数说明：字段名填写类型说明cmdno必填业务代码, 商城系统登录接口填 1 username必填登录账号password必填登录密码appid必填ShopNC商城系统分配给第三访问应用系统的ID号KEY必填ShopNC商城系统分配给第三方应用系统的唯一KEY值签名分为三步：STEP.1将 业务代码、用户名、密码、应用ID号组成组合进行64位编码STEP.2将编码后的结果与系统得到的K

4、EY值逐位进行异或操作，得出答名结果signSTEP.3将sign与cs传入到商城系统5 返回结果如果成功，返回用户在商城系统的ID号如果失败，返回0第四章 用户注册接口协议1 接入URL2 接入方式POST/GET方式 3 协议传输参数字段名填写类型说明sign必填签名结果cs选填字符编码标准，gbk或者utf-8，默认为utf-84 签名规则request =“cmdno=1&username=shopnc&password=123456&email=demo&appid=12”encode = base64_encode(request)sign = encode KEY参数说明：字段名

5、填写类型说明cmdno必填业务代码, 商城系统注册接口填 2 username必填注册的登录账号password必填注册的密码email必填注册的Emailappid必填ShopNC商城系统分配给第三访问应用系统的ID号KEY必填ShopNC商城系统分配给第三方应用系统的唯一KEY值签名分为三步：STEP.1将 业务代码、用户名、密码、Email、应用ID号组成组合进行64位编码STEP.2将编码后的结果与系统得到的KEY值进行异或操作，得出答名结果signSTEP.3将sign与cs传入到商城系统5返回结果如果成功，返回用户在商城系统的ID如果失败，返回0第五章 产品类目新增接口协议1 接入

6、url2 通知方式POST 方式3 协议参数字段名填写类型说明cmdno必填业务代码, 商城系统新增类目接口填 3 title必填分类名称upid必填上级分类，顶级分类为0typeid选填绑定的类型IDappid必填ShopNC商城系统分配给第三访问应用系统的ID号sign必填MD5签名结果4 传输格式XML 示例：3男装01196e79218965eb72c92a549dd5a3301125 签名规则sign = md5(cmdno=3&appid=12&sign=KEY)参数说明：字段名填写类型说明cmdno必填业务代码, 商城系统新增类目接口填 3 appid必填ShopNC商城系统分配

7、给第三访问应用系统的ID号KEY必填ShopNC商城系统分配给第三方应用系统的唯一KEY值6 返回结果如果成功，返回新增类目ID如果失败，返回0第六章 产品类目更新接口协议1 接入url2 通知方式POST 方式3 协议参数字段名填写类型说明cmdno必填业务代码, 商城系统修改类目接口填 4 cid必填产品类目在商城系统中的IDtitle必填分类名称upid必填上级分类，顶级分类为0typeid选填绑定的类型IDappid必填ShopNC商城系统分配给第三访问应用系统的ID号sign必填MD5签名结果4 传输格式XML 示例：3男装01196e79218965eb72c92a549dd5a3

8、301125 签名规则sign = md5(cmdno=4&appid=12&sign=KEY)参数说明：字段名填写类型说明cmdno必填业务代码, 商城系统修改类目接口填 4 appid必填ShopNC商城系统分配给第三访问应用系统的ID号KEY必填ShopNC商城系统分配给第三方应用系统的唯一KEY值6 返回结果如果成功，返回1如果失败，返回0第七章 产品类目查询接口协议1 接入url2 通知方式POST 方式3 协议参数字段名填写类型说明cmdno必填业务代码, 查询类目接口填 5 cid必填产品类目在商城系统中的IDappid必填ShopNC商城系统分配给第三访问应用系统的ID号sig

9、n必填MD5签名结果4 传输格式XML 示例：30196e79218965eb72c92a549dd5a3301125 签名规则sign = md5(cmdno=6&appid=12&sign=KEY)参数说明：字段名填写类型说明cmdno必填业务代码, 商城系统修改类目接口填 6 appid必填ShopNC商城系统分配给第三访问应用系统的ID号KEY必填ShopNC商城系统分配给第三方应用系统的唯一KEY值6 返回结果男装01196e79218965eb72c92a549dd5a330112第八章 产品新增接口协议1 接入url2 通知方式POST 方式3 协议参数字段名填写类型说明cmdn

10、o必填业务代码, 新增产品接口填 7 name必填商品名称price必填商品价格yprice必填原价storage必填商品库存serial选填货号weight必填重量transfee必填0买家承担运费1卖家承担运费brand_id选填品牌IDtag选填标签content必填商品介绍seokeywords选填关键词（SEO）seodescription选填关键词描述（SEO）appid必填ShopNC商城系统分配给第三访问应用系统的ID号sign必填MD5签名结果4 传输格式XML 示例：3新款男士夹克100.00120.0050xl0015050502011新款|男士|夹克|韩版领型: 立领,

11、风格: 时尚休闲,颜色: 深灰 浅灰,尺码: M/170 L/175 XL/180 XXL/185网上购物,2012春季新款男士夹克 立领 休闲 薄 外套 夹克 男 夹克,男装欢迎前来ShopNC商城系统-男装类实力旺铺，2012春季新款男士夹克 立领 休闲 薄 外套 夹克 男,想了解更多淘金币 2012春季新款男士夹克 立领 休闲 薄 外套 夹克 男，多种夹克-男装商品任你选购196e79218965eb72c92a549dd5a3301125 签名规则sign = md5(cmdno=7&appid=12&sign=KEY)参数说明：字段名填写类型说明cmdno必填业务代码, 新增商品接口

12、填 7 appid必填ShopNC商城系统分配给第三访问应用系统的ID号KEY必填ShopNC商城系统分配给第三方应用系统的唯一KEY值6 返回结果如果成功，返回新增产品ID如果失败，返回0第九章 产品更新接口协议1 接入url2 通知方式POST 方式3 协议参数字段名填写类型说明cmdno必填业务代码, 产品更新接口填 8 name必填商品名称price必填商品价格yprice必填原价storage必填商品库存serial选填货号weight必填重量transfee必填0买家承担运费1卖家承担运费brand_id选填品牌IDtag选填标签content必填商品介绍seokeywords选填

13、关键词（SEO）seodescription选填关键词描述（SEO）appid必填ShopNC商城系统分配给第三访问应用系统的ID号sign必填MD5签名结果4 传输格式XML 示例：3新款男士夹克100.00120.0050xl0015050502011新款|男士|夹克|韩版领型: 立领,风格: 时尚休闲,颜色: 深灰 浅灰,尺码: M/170 L/175 XL/180 XXL/185网上购物,2012春季新款男士夹克 立领 休闲 薄 外套 夹克 男 夹克,男装欢迎前来ShopNC商城系统-男装类实力旺铺，2012春季新款男士夹克 立领 休闲 薄 外套 夹克 男,想了解更多淘金币 2012春

14、季新款男士夹克 立领 休闲 薄 外套 夹克 男，多种夹克-男装商品任你选购196e79218965eb72c92a549dd5a3301125 签名规则sign = md5(cmdno=8&appid=12&sign=KEY)参数说明：字段名填写类型说明cmdno必填业务代码, 商城系统修改类目接口填 8 appid必填ShopNC商城系统分配给第三访问应用系统的ID号KEY必填ShopNC商城系统分配给第三方应用系统的唯一KEY值6 返回结果如果成功，返回1如果失败，返回0第十章 产品查询接口协议1 接入url2 通知方式POST 方式3 协议参数字段名填写类型说明cmdno必填业务代码,

15、查询类目接口填 9 pid必填产品在商城系统中的IDappid必填ShopNC商城系统分配给第三访问应用系统的ID号sign必填MD5签名结果4 传输格式XML 示例：90196e79218965eb72c92a549dd5a3301125 签名规则sign = md5(cmdno=6&appid=12&sign=KEY)参数说明：字段名填写类型说明cmdno必填业务代码, 商城系统修改类目接口填 9 appid必填ShopNC商城系统分配给第三访问应用系统的ID号KEY必填ShopNC商城系统分配给第三方应用系统的唯一KEY值6 返回结果3新款男士夹克100.00120.0050xl0015

16、050502011新款|男士|夹克|韩版领型: 立领,风格: 时尚休闲,颜色: 深灰 浅灰,尺码: M/170 L/175 XL/180 XXL/185网上购物,2012春季新款男士夹克 立领 休闲 薄 外套 夹克 男 夹克,男装欢迎前来ShopNC商城系统-男装类实力旺铺，2012春季新款男士夹克 立领 休闲 薄 外套 夹克 男,想了解更多淘金币 2012春季新款男士夹克 立领 休闲 薄 外套 夹克 男，多种夹克-男装商品任你选购196e79218965eb72c92a549dd5a330112第十一章 站内消息接口协议1 接入url2 通知方式POST 方式3 协议参数字段名填写类型说明c

17、mdno必填业务代码, 查询类目接口填 10 uid必填会员IDappid必填ShopNC商城系统分配给第三访问应用系统的ID号msgcount必填取最新的多少条站内信sign必填MD5签名结果4 传输格式XML 示例：91020196e79218965eb72c92a549dd5a3301125 签名规则sign = md5(cmdno=10&appid=12&sign=KEY)参数说明：字段名填写类型说明cmdno必填业务代码, 端内消息目接口填 10 appid必填ShopNC商城系统分配给第三访问应用系统的ID号KEY必填ShopNC商城系统分配给第三方应用系统的唯一KEY值6 返回结

18、果10商品质量不错买了一件，挺好的2011-03-19kevin商品质量不错买了一件，挺好的2011-03-19kevin商品质量不错买了一件，挺好的2011-03-19kevin参数说明：字段名说明title信件标题 content信件内容 sendtime发送时间 senduser发件人第十二章 产品查询接口协议1 接入url provide/select2 通知方式POST 方式3 协议参数字段名填写类型说明cmdno必填业务代码, 查询类目接口填 11 pid必填供货商IDappid必填ShopNC商城系统分配给第三访问应用系统的ID号sign必填MD5签名结果4 传输格式XML 示例：90196e79218965eb72c92a549dd5a3301125 签名规则sign = md5(cmdno=11&a