京东API接入流程文档-商家版

1、JOS接入流程文档(商家专用)应用申请流程1.注册成为开发者请访问：沙箱环境地址：正式环境地址：注册京东好注册京东好使用京东账户登录使用京东账户登录成为京东开发者成为京东开发者(1)访问开发者中心，点击”申请成为开发者开始申请流程开发者(2)用京东账户登录，没有京东账户则注册一个京东账户还不是京东蔺城用户？还不是京东蔺城用户？现在免费注册成为京东商城用户，便能立刻享受便宜又放心的购物乐趣。现在免费注册成为京东商城用户，便能立刻享受便宜又放心的购物乐趣。注册制用户企业用户注册校园用户注册(3)登录成功后，完善注册信息(5)然后进入我的开发中心位居管理供期创建调用京在商城API的应用供邂营理调用京

2、东商城片网的应用(4)提交，申请成功!恭喜!操作成功!开友右开发者中心菜学苜由基本设苗小开发动态管理应甫M帮助中心开笈好阚介培开发起无开出工口就京东开放平台流35上京东人才招聘信意2 .创建应用( (1) )在开发者中心，点击创建应用”开发者中心丸创建nr应用讥您创注淤二切、商城API的应用管理应用供您管理调用京琪商城API的应用(2)填写应用名称，选择应用类型开发者中心菜单匕应用管理-基本设畜首页开齿者中，L，首页应用首理基本设置通用应用：此应用ISV和商家都可以使用（针对的ISV的应用需要商家进行授权，商家不需要提供用户名和密码给第三方开发者）商家应用：此应用只有商家可以使用（3）保存成功

3、，可申请上线1.通用应用:即供用户访问的应用地址中洋见 v 京东说明网址前须有“伸口：*监控页面URLhttp:/ v 京东说明网址前须有力加犷详细信息由清I线士应用名解我的通用应用不超过2时字符*回调页面URL尺寸：B0 烟 0,大小：不超过 50 匕格式：qifjpg 朝 png*填写您的回调地址http:/www.balduoom应用圉标选择文件点击申谙上城2.商家应用说明：（请选择您所需要的应用）1) )在开发者中心，点击管理应用开发者中心首页开发者中心首页(2)进入应用列表，点击编辑3.管理应用创建应用供您创建调用京东商城API的应用JML管理0 应用供您营理调用京东商城API的应用

4、(3)进入应用详情，这里可以查询应用的相关密钥，及修改相关信息。MBKey：652101ASF71D4615D74BO36C0097650FAppSecrek香石重者证书费里：汕。映庆证书掷肌基狷开放请保留appkey和appsecret到oauth授权认证用到appkey与appsecrect释义：appkey：JOS京东开放平台颁发的唯一标识一个应用的ID号，该appkey可在开发者中心创建应用后获取，appSecret:(应用密钥，不可对外公开，商家需注意保密，调用API的时候需要使用，可以通过该密钥获得的商家所有数据)。4上然运行开发者中心苜 3*应用营陛=编辑应用1.平台也捏胜了短布

5、他博管窗捶口，在碘上邯定儆I瓢户后，你可以在网站上整合卷布信里的臃，让用户在你的网站上壶布的信皇勘争展时的同步到网站上 C3用户的美迂者前窗后时看到内苔，可咽垣肉苔的疑接朝海辨摄点击进入网站3.用户不但可以短布交室向智，也可以东侬(4)修改应用信息Oauth 授权认证访问地址:* *应用书称我们一个应用应用书称我们一个应用不超过不超过2冲字符冲字符选择文件选择文件尺寸：尺寸：80 x80)大小：不超过大小：不超过50K,格式二格式二gifjpg或口或口ng* *胸建类型胸建类型Q QWE电电z用用( (日阴日阴客服端应用客服端应用(c/s)* *回潮页面回潮页面URLhttp：/wwbaidu

6、com即供用户访问的应用地址。详见京东说明即供用户访问的应用地址。详见京东说明下下网址前须有力即犷网址前须有力即犷详期信息详期信息应用圉标应用圉标申谙卜畿申谙卜畿沙箱环境地址：正式环境地址：注意事项：请不要将地址直接贴于地址栏访问，否者提示您:请不要沙箱环境和正式环境穿插调用。前言：如果您的应用和京东的JOS对接后，需要获取一些与用户紧密相关的信息（如订单、商品、促销等），为保证数据的安全性和隐私性，需要取得用户的同意，引导用户授权。JOS采用国际通用的OAuth2.0标准协议，支持网站、桌面客户端、ERP系统。如果要了解更多关于OAuth2.0的技术说明，请参考官方网站http:/ A京东账

7、号信息；店浦内商品信息三交易相关订单和客户信息；投根成功后，您也可以随时在授根管理里查看和取消授权期消点击授权按钮跳转到回调页面若用户选择“授权“，则页面跳转至应用的回调地址，同时返回授权码code以及提供授权的京宇信息提供京东增值即皆授权授权state参数（code不能重复使用，下次使用需要重新获取）wvv-.-.baiiduxomkode=tJEVC&state=m;.ststeid用上一步获取的Code和应用密钥（AppSecret）通过HttpPost方式换取Token能直接访问）（详细请参考oauth文档）示例:http:/ Id 以及联系方式发送到邮箱获取 C/S 授权方式

8、：三.调用API接口1.准备调用接口所需要的数据访问地址：沙箱环境地址：正式环境地址：SERVER_URL地址：请写相对应的地址示例：http:/ OAuth 授权认证中获取app_key：从开发者中心申请的应用的“京东证书”中获取sign：请参考签名说明调用示例:接口名称360buy.ordersearch功能说明根据条件检索订单信息系统级别输入参数名称是否必须描述methodString是API接口名称access_tokenString是采用 OAuth 授权方式为必填参数app_keyString是应用的app_keysignString是签名timestampString是时间戳，格

9、式为yyyy-MM-ddHH:mm:ss,例如：2011-06-1613:23:30。京东API服务端允许客户端请求时间误差为6分钟formatString否暂时只支持jsonvString是API协议版本，可选值：2.0.应用级输入参数名称是否必须示例值描述start_dateString否2010-12-2017:15:00开始时间和不得相差超过结束时间1个月end_dateString否2010-12-2017:15:00开始时间和不得相差超过结束时间1个月order_stateString是WAIT_SELLER_STOCK_OUT；每个订单状态以逗号分隔,（该接口只提供三个状态，WA

10、IT_SELLER_STOCK_OUT 等待出库，WAIT_SELLER_DELIVERY 等待发货（只适用于 SOP商家）,TRADE_CANCELED 取消）pageString是1查询的页数page_sizeString是12每页的条娄k（最大page_size100条)optional_fieldsString否商家希望返回的订单的信息字段，每个字段以逗号分隔2. SDK调用示例（java）publicJdClientclient=newDefaultJdClient(SERVER_URL,c7b82199-f26d-459e-a4b3d6f6cec4b869,36AB8642CCEF

11、66293AD391EE7E4E9510da953632d0a4741beb0bbd096214605”)；OrderSearchRequestrequest=newOrderSearchRequest();request.setStartDate(2012-01-1012:12:23);request.setEndDate(2012-02-2012:13:13);request.setOrderState(WAIT_SELLER_STOCK_OUT);request.setPage(1);request.setPageSize(100);request.setOptionalFields(v

12、ender_id,order_id,pay_type);OrderSearchResponseresponse=client.execute(request);3. url请求方式示例http:gw.api.sandbox.360buycom/routerjson?app_key=FDCE5CEC7B064A966CC3F4B36587F84F&access_token=f1df472e-f61a-4071-a203-eb77c427919f&sign=75357565E83CF434971BEDA453761265&format=json&timestamp=

13、2012-05-16+17%3a03%3a55&v=2.0&method=360buyorder.search&360buy_param_json=end_date:2012-05-1617:03:56,optional_fields:vender_id,order_id,pay_type,order_total_price,freight_price,seller_discount,order_payment,delivery_type,order_state,order_state_remark,invoice_info,order_remark,order_sta

14、rt_time,order_end_time,consignee_info,item_info_list,order_state:WAIT_SELLER_STOCK_OUT,page:1,page_size:20,start_date:2012-05-1417:03:56四.签名说明1、系统级输入参数名称类型是否必须描述示例值默认值methodString是API接口名称methodStringaccess_tokenString是采用 OAuth 授权方式为必填参数access_tokenStringapp_keyString是应用的app_keyapp_keyStringtimestamp

15、String是时间戳，格式为 yyyy-MM-ddHH:mm:ss,例如：2011-06-1613:23:30。京东 API 服务端允许客户端请求时间误差为 6 分钟无vString是API 协议版本，可选值：2.0。无2、应用级输入参数名称类型描述示例360buy_param_jsonString标准 json 类型， 而且是按照字母先后顺序排序的end_date:2012-05-1617:03:56”,optional_fields:vender_id,order_id,pay_type,order_total_price,freight_price,seller_discount,ord

16、er_payment,delivery_type,order_state,order_state_remark,invoice_info,order_remark,order_start_time,order_end_time,consignee_info,item_info_list,order_state:WAIT_SELLER_STOCK_OUT,page:1,page_size:20,start_date:2012-05-1417:03:56)金加密规则：a)所有请求参数按照字母先后顺序排序例如：将access_token,app_key,method,timestamp,v排序为ac

17、cess_token,app_key,method,timestamp,v)b)把所有参数名和参数值串在一起例如：access_tokenxxxapp_keyxxxmethodxxxxxxtimestampxxxxxxvxc)把appSecret夹在字符串的两端例如：appSecret+XXXX+appSecretd)使用MD5进行加密，再转化成大写4、示例：调用api方法：360buy.order.search,appSecret:6d5524eb1c6c4f9caf8c7b430d1fdef9(1)输入参数：access_token=ad6c71c3-7fb3-4f7b-8258-9a64

18、13a5bbbfapp_key=7843A398CCE3397EC50C495458F64B64method=360buy.order.searchtimestamp=2011-07-2011:10:04v=2.0360buy_param_json=end_date:2012-05-1617:03:56”,optional_fields:vender_id,order_id,pay_type,order_total_price,freight_price,seller_discount,order_payment,delivery_type,order_state,order_state_re

19、mark,invoice_info,order_remark,order_start_time,order_end_time,consignee_info,item_info_list”,order_state:WAIT_SELLER_STOCK_OUT,page:1,page_size:20,start_date:2012-05-1417:03:56)(2)按照参数名称排序360buy_param_json=(end_date:2012-05-1617:03:56,optional_fields:vender_id,order_id,pay_type,order_total_price,fr

20、eight_price,seller_discount,order_payment,delivery_type,order_state,order_state_remark,invoice_info,order_remark,order_start_time,order_end_time,consignee_info,item_info_list,order_state:WAIT_SELLER_STOCK_OUT,page:1,page_size:20,start_date:2012-05-1417:03:56access_token=ad6c71c3-7fb3-4f7b-8258-9a641

21、3a5bbbfapp_key=7843A398CCE3397EC50C495458F64B64method=360buy.order.searchtimestamp=2011-07-2011:10:04v=2.0(3)连接参数名与参数值，并在首尾加上appSecret6d5524eb1c6c4f9caf8c7b430d1fdef9360buy_param_json(end_date:2012-05-1617:03:56,optional_fields:vender_id,order_id,pay_type,order_total_price,freight_price,seller_discount,order_payment,delivery_type,order_state,order_state_remark,invoice_info,order_remark,order_start_time,order_end_