商家接入流程文档20120

1、商家接入流程文档商家接入注册成为开发者 （完善相关信息提交申请成为开发者）请访问：创建应用在线测试（填入相应的信息并申请上线）。 请保留appkey 和 appsecret 到oauth授权认证用到appkey与appsecrect释义：appkey：JOS京东开放平台颁发的唯一标识一个应用的ID号，该appkey可在 HYPERLINK /isv/index.htm开发者中心创建应用后获取，appSecret:（应用密钥，不可对外公开，商家需注意保密，调用API的时候需要使用，可以通过该密钥获得的商家所有数据）。Oauth授权认证 访问地址：Server-side flow(B/S)通过用户

2、授权获取授权码Code获取授权码参数 参数名称参数选项描述 response_type 必须 此流程下，该值固定为code client_id 必须 即创建应用时的Appkey (从开发者中心申请的应用中获取) redirect_uri 必须 应用的回调地址，必须和应用的callback主域名匹配。 state 可选 状态参数，由应用自定义，颁发授权后会原封不动返回 scope 短授权为必须 权限参数，API组名串，多个组名时，用“，”分隔，目前支持参数：read HYPERLINK /oauth/authorize/oauth/authorize （注意此地址需要拼参不能直接访问）（详细请参

3、考oauth文档）示例： HYPERLINK /oauth/authorize?response_type=code&client_id=12439149&redirect_uri=&state=myststeid&scope=read/oauth/authorize?response_type=code&client_id=12439149&redirect_uri=&state=myststeid&scope=read用户登陆输入用户名和密码点击登录按钮跳转到授权页面授权点击授权按钮跳转到回调页面若用户选择“授权“，则页面跳转至应用的回调地址，同时返回授权码code以及state参数（co

4、de不能重复使用）用上一步获取的Code和应用密钥（AppSecret）通过Http Post方式换取Token获取访问令牌参数 参数名称参数选项描述 grant_type 必须 授权类型，此流程下，该值固定为authorization_code code 必须 授权请求中的授权码 redirect_uri 必须 应用的回调地址，必须和应用的callback主域名匹配。 client_id 必须 即Appkey(从开发者中心申请的应用中获取) client_secret 必须 即Appsecret(从开发者中心申请的应用中获取) scope 短授权为必须 权限参数，API组名串，多个组名时，用

5、“，”分隔，目前支持参数：read HYPERLINK /oauth/token/oauth/token （注意此地址需要拼参不能直接访问）（详细请参考oauth文档）示例： HYPERLINK /oauth/token?grant_type=authorization_code&client_id=12439149&redirect_uri=http:/&code=tf5xM6&state=myststeid&client_secret=6d5524eb1c6c4f9caf8c7b430f1fdef9/oauth/token?grant_type=authorization_code&cli

6、ent_id=12439149&redirect_uri=&code=tf5xM6&state=myststeid&client_secret=6d5524eb1c6c4f9caf3c7b430f1fdef9TOP返回的参数如下： 参数名称参数选项描述access_token用户授权令牌，等价于Sessionkeyaccess_tokencode返回0，为成功codetoken_type授权令牌类型，暂做保留参数备用token_typeexpires_in授权令牌有效期，以秒为单位expires_inrefresh_token刷新令牌，当授权令牌过期时，可以刷新access_token，如果有

7、获取权限则返回refresh_tokentime系统时间timeaccess_token用户授权令牌，等价于Sessionkeyaccess_token结果如下：access_token: 47565790-662f-4b32-8cb7-8b4f984be462,code: 0,expires_in: 31104000,refresh_token: 71443717-d3ea-40df-9dc1-f7a77b448f91,time: 1337674952269,token_type: bearerPassword flow(C/S) 参数名称参数选项描述grant_type是此流程下，该值固定

8、为passwordclient_id是即创建应用时的Appkey（从开发者中心申请的应用中获取)client_secret是即Appsecret(从开发者中心申请的应用中获取)username是用户名字password是用户密码 （需要MD5加密）scope否（短授权为必须）权限参数，API组名串，多个组名时，用“，”分隔，目前支持参数：readgrant_type是此流程下，该值固定为password 示例：（详细请参考oauth文档所需参数） /oauth/token （注意此地址需要拼参不能直接访问）注意：password 需要进行MD5加密/oauth/token?grant_type

9、=password&client_id=291391DD610A10DE352D3B890BDAB221&username=lbp_1order&password=360buy&scope=readTOP返回的参数如下： 参数名称描述access_token用户授权令牌，等价于Sessionkeycode返回0，为成功token_type授权令牌类型，暂做保留参数备用expires_in授权令牌有效期，以秒为单位refresh_token刷新令牌，当授权令牌过期时，可以刷新access_token，如果有获取权限则返回time系统时间access_token用户授权令牌，等价于Sessionk

10、ey调用API接口准备调用接口所需要的数据 访问地址： access_token：从OAuth授权认证中获取 app_key：从开发者中心申请的应用的“京东证书”中获取 sign：请参考 HYPERLINK l _签名说明:签名说明 调用示例： 接口名称360buy.order.search功能说明根据条件检索订单信息系统级别输入参数名称类型是否必须描述methodString是API接口名称access_tokenString是采用OAuth授权方式为必填参数app_keyString是应用的app_keysignString是 HYPERLINK l _签名说明:签名timestampSt

11、ring是时间戳，格式为yyyy-MM-ddHH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟formatString否暂时只支持jsonvString是API协议版本，可选值:2.0.应用级输入参数名称类型是否必须示例值描述start_dateString否 2010-12-20 17:15:00开始时间 和 结束时间 不得相差超过1个月end_dateString否2010-12-20 17:15:00开始时间 和 结束时间 不得相差超过1个月order_stateString是WAIT_SELLER_STOCK_OUT每个订单状

12、态以逗号分隔,(该接口只提供三个状态， WAIT_SELLER_STOCK_OUT 等待出库， WAIT_SELLER_DELIVERY 等待发货(只适用于SOP商家)， TRADE_CANCELED 取消)pageString是1查询的页数page_sizeString是12每页的条数（最大page_size 100条）optional_fieldsString否商家希望返回的订单的信息字段,每个字段以逗号分隔2. SDK调用示例（java）public JdClient client = new DefaultJdClient(SERVER_URL,c7b82199-f26d-459e-a

13、4b3-d6f6cec4b869,”36AB8642CCEF66293AD391EE7E4E9515”,”0da953632d0a4741beb0bbd096214605”);OrderSearchRequest request = new OrderSearchRequest();request.setStartDate(2012-01-10 12:12:23);request.setEndDate(2012-02-20 12:13:13);request.setOrderState(WAIT_SELLER_STOCK_OUT);request.setPage(1);request.setP

14、ageSize(100);request.setOptionalFields(vender_id,order_id,pay_type);OrderSearchResponse response = client.execute(request);3. url请求方式示例/routerjson?app_key=FDCE5CEC7B064A966CC3F4B36587F84F&access_token=f1df472e-f61a-4071-a203-eb77c427919f&sign=75357565E83CF434971BEDA453761265&format=json×tamp=20

15、12-05-16+17%3a03%3a55&v=2.0&method=360buy.order.search&360buy_param_json=end_date:2012-05-16 17: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,orde

16、r_end_time,consignee_info,item_info_list,order_state:WAIT_SELLER_STOCK_OUT,page:1,page_size:20,start_date:2012-05-14 17:03:56签名说明1、系统级输入参数名称类型是否必须描述示例值默认值methodString是API接口名称methodStringaccess_tokenString是采用OAuth授权方式为必填参数access_tokenStringapp_keyString是应用的app_keyapp_keyStringtimestampString是时间戳，格式为y

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

18、ype,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-14 17:03:56 3、加密规则：所有请求参数按照字母先后顺序排序 例如：将access_token,app_key,method,timestamp,v 排序为 access_token,app_key

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

20、843A398CCE3397EC50C495458F64B64method=360buy.order.search timestamp=2011-07-20 11:10:04 v=2.0 360buy_param_json=end_date:2012-05-16 17: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_

21、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-14 17:03:56 (2)、按照参数名称排序360buy_param_json=end_date:2012-05-16 17:03:56,optional_fields:vender_id,order_id,pay_type,order_total_price,freight_price,

22、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-14 17:03:56access_token=ad6c71c3-7fb3-4f7b-8258-9a6413a5bbbf app_key=784