API简介
国美管家开放平台为商家提供与购买管家各业务类型订单对接服务,在打通双方系统之间的信息流的同时,实现双方整体服务能力一体化,提升服务效率以及系统的用户体验,实现双赢。
01
接入前期准备:
前期准备包括系统对接意向确认、时间计划和对接人员的安排,初步项目沟通、评估、准备自身软硬件设施等。可联系对口国美管家业务;也可联系国美管家技术中心。

联系人:管家客服
手机:400 811 3333
邮箱:caoyang-ds@gome.com.cn
总部地址:北京市朝阳区霄云路鹏润大厦B座5层

02
传输方式及 URL:

国美管家开放平台对外部系统提供的应用接口,为商家提供与国美管家订单系统的对接服务;
交互技术说明:
接口传输协议:HTTP
接口请求方式:POST
数据编码格式:UTF-8
数据传输格式:JSON/XML

为了便于外部系统方便接口的对接与测试工作,防止上线后对正式系统造成影响国美管家开放平台的接口环境分为接口测试环境和正式环境。

正式环境URL:open.gomegj.com
测试环境URL:open.dev.gomegj.com

03
信息系统服务:

1.订单系统:通过与客户系统对接,可实现服务订单自动接收、订单服务进度时时反馈。

2.工程师管理:实现基于订单工程师指派、修改等管理。

3.用户支付:提供标准的支付调用接口,支持微信、支付宝、银联多种支付方式。

4.服务质量:提供实时订单完成时效性监控、提醒,提升服务效率。

5.服务主数据:提供管家标准服务主数据,供第三方商家对应。

04
身份认证:

国美管家开放平台使用header与param双参数认证。
header认证逻辑:
服务端获取到timestamp 和encrypt-key 值后,通过timestamp值转化为yyyy-MM-dd HH:mm:ss SSS,然后使用Des加密,如果:请求的encrypt-key 和服务端生成的密文一样且请求的时间在服务的接到请求的时间不超过5分钟通过header认证;(注:请确保服务器的时间和intenet时间的一致,避免因服务器时间差导致不能访问);
param认证逻辑
在接口的请求参数param中都有一个参数sign,此信息是通过param的加密的密文;
sign 的生成:
1.请求接口的参数json字符串:
如:{"cpId":82,"orderId":"H1749327314892606","srvType":"4"}
对参数json使用DesUtils加密
认证逻辑:服务器接到请求的json参数后,对参数进行des加密,然后比对加密的密文是否相同,如果相同则认证通过;
通过参数srvType 对比系统配置的业务类型,如果配置的业务类型不包含请求参数的业务类型,则认证不通过;

01 接口介绍
02 业务约束
03 请求报文示例
04 返回报文示例
05 接口参数信息
参数名称 参数值 参数描述
06 请求报文字段
字段 变量名 类型 长度 是否必填 备注
07 返回报文字段
字段 变量名 类型 长度 是否必填 备注