京东API接口整理
京东API接入流程文档 -商家版
JOS接入流程文档（商家专用）一、应用申请流程1. 注册成为开发者请访问：沙箱环境地址：正式环境地址：(1) 访问开发者中心，点击”申请成为开发者“，开始申请流程(2)用京东账户登录，没有京东账户则注册一个京东账户（3）登录成功后，完善注册信息（4）提交，申请成功！(5) 然后进入我的开发中心2. 创建应用（1）在开发者中心，点击“创建应用”(2)填写应用名称，选择应用类型通用应用：此应用ISV和商家都可以使用（针对的ISV的应用需要商家进行授权，商家不需要提供用户名和密码给第三方开发者）商家应用：此应用只有商家可以使用（3）保存成功，可申请上线1.通用应用：2.商家应用说明：(请选择您所需要的应用)3. 管理应用（1）在开发者中心，点击“管理应用”(2)进入应用列表，点击“编辑”(3)进入应用详情，这里可以查询应用的相关密钥，及修改相关信息。
请保留appkey 和appsecret 到oauth授权认证用到appkey与appsecrect释义：appkey：JOS京东开放平台颁发的唯一标识一个应用的ID 号，该appkey可在开发者中心创建应用后获取，appSecret:（应用密钥，不可对外公开，商家需注意保密，调用API的时候需要使用，可以通过该密钥获得的商家所有数据）。
(4)修改应用信息二、Oauth授权认证访问地址：沙箱环境地址：正式环境地址：注意事项：请不要将地址直接贴于地址栏访问，否者提示您：“异常访问”请不要沙箱环境和正式环境穿插调用。
前言:如果您的应用和京东的JOS对接后，需要获取一些与用户紧密相关的信息（如订单、商品、促销等），为保证数据的安全性和隐私性，需要取得用户的同意，引导用户授权。
JOS 采用国际通用的OAuth2.0标准协议，支持网站、桌面客户端、ERP系统。
如果要了解更多关于OAuth2.0的技术说明，请参考官方网站/2/ 目前，JOS的OAuth2.0支持以下方式获取Access Token ：注意：所有授权流程都不需要商家提供用户名、密码给第三方开发者，商家请保护好自己的账号安全1. Server-side flow(B/S)此授权指对应用标签中的：“商家应用（京东商家应用）”里的“WEB应用（B/S）”通过用户授权获取授权码Code获取授权码参数参数名称参数选项描述response_type 必须此流程下，该值固定为codeclient_id 必须即创建应用时的Appkey (从开发者中心申请的应用中获取)redirect_uri 必须应用的回调地址，必须和应用的callback主域名匹配。
京东商城API网关实践
京东商城API网关实践
京东商城API 网关2013 年正式上线独立运营，目前是京东商城App 与后端服务通信的流量通道，日均访问次数达百亿以上，本文主要从如下两方面介绍京东API 网关系统：
京东API 网关的技术选型与变化之路。
伴随京东移动端业务的持续增长，网关每一次的技术变迁应运而生。
从傻瓜式的满足业务需求，变为可视化的运营。
从加机器暴力对抗流量增长，到精细打磨，高性能、高可用。
在发展过程中，需要平衡业务、技术、运营的冲突，以期达到一种较优状态；
API 网关周边生态的建设，包括配置的动态管理，HttpDNS 的精细流量调度以及流量实时分析带来的运维决策。
京东平台规则
京东开放平台总则第一章概述规则适用范围：本规则适用于京东开放平台用户，卖家可以根据业务需求选择经营模式以通过京东开放平台向买家销售商品或提供服务。
本规则不适用于京东自营商品及信息。
1.1京东秉承“客户为先，诚信至上”的宗旨、“让购物变得简单，快乐！”为我们的最终目标，为广大用户提供最优质的商品及服务。
为保障京东用户合法权益，维护京东正常经营秩序，根据《京东用户注册协议》、《“京东”开放平台服务协议》等服务/合作协议，制定本规则。
1.2“京东”开放平台总则，是对京东用户增加基本义务或规范用户行使基本权利的条款。
1.3规则行为的认定与处理，基于京东从普通人角度结合双方提供的凭证认定的事实，依据相关规则严格执行。
京东用户在适用规则上一律平等。
1.4用户应遵守国家法律、行政法规、部门规章等规范性文件。
对任何涉嫌违反国家法律、行政法规、部门规章等规范性文件的行为，本规则已有规定的，适用本规则；本规则尚无规定的，京东有权依据相应规则酌情处理，但京东对用户的处理不免除用户因违法、违约等行为应承担的法律责任。
用户在京东的任何行为，应同时遵守与京东所订立的各项协议。
京东有权随时变更本规则并在卖家论坛或卖家管理系统等渠道予以公告。
若用户不同意相关变更，应立即停止使用京东开放平台提供的相关服务，并及时通知京东。
京东有权对用户行为及应适用的规则/协议约定进行单方认定，并据此处理。
第二章定义2.1 京东，指域名为的“京东”网站；2.2 开放平台:指运行于“京东”网站的“京东”开放平台，是“京东”网站上为用户提供信息发布、交流，第三方经营者开设店铺并经营，以及其他技术服务的电子商务交易服务平台；2.3 用户：指所有在“京东”网站上注册，成为“京东”注册会员的法人、自然人及其他组织，本规则中统称为“用户”，除非另有说明，否则“用户”均指此含义；2.4 买家：指在京东上浏览或购买商品/接受服务的用户；2.5 卖家：指符合京东要求，成功入驻京东，使用京东开放平台出售商品或提供服务的用户，包含提供服务的服务商；2.6 账号：指用户注册时设置的账户名，账号具有唯一性；2.7 订单：指买家向卖家同一时间买下单款或多款商品/服务的合约，订单中针对任一款商品/服务的内容构成独立的交易；2.8 店铺：指卖家在完成注册及入驻流程后，为进行合法经营，依据协议约定和京东开放平台规则，由卖家申请京东审核通过的具有独立且唯一性ID（英文Identity的缩写，意为“身份标识号码”）、特定名称（可依据相关平台规则进行调整）的网络化虚拟商铺；2.9 咚咚: 指京东提供给用户的即时沟通工具，通过该工具买家可以联系卖家，进行商品或服务咨询;2.10 咚咚应答率：指一定时间内卖家及卖家客服团队响应用户咨询数量/用户通过咚咚在线咨询数量*100%；2.11 交易达成：指在线付款的订单买家成功付款；货到付款的订单买家成功提交订单；2.12 自提：买家订单选择到京东指定自提点提取所购商品。
电商管理后台API接口文档
电商管理后台API接⼝⽂档1. 电商管理后台 API 接⼝⽂档1.1. API V1 接⼝说明接⼝基准地址：http://127.0.0.1:8888/api/private/v1/服务端已开启 CORS 跨域⽀持API V1 认证统⼀使⽤ Token 认证需要授权的 API ，必须在请求头中使⽤ Authorization 字段提供 token 令牌使⽤ HTTP Status Code 标识状态数据返回格式统⼀使⽤ JSON1.1.1. ⽀持的请求⽅法GET（SELECT）：从服务器取出资源（⼀项或多项）。
POST（CREATE）：在服务器新建⼀个资源。
PUT（UPDATE）：在服务器更新资源（客户端提供改变后的完整资源）。
PATCH（UPDATE）：在服务器更新资源（客户端提供改变的属性）。
DELETE（DELETE）：从服务器删除资源。
HEAD：获取资源的元数据。
OPTIONS：获取信息，关于资源的哪些属性是客户端可以改变的。
1.1.2. 通⽤返回状态说明状态码含义说明200OK请求成功201CREATED创建成功204DELETED删除成功400BAD REQUEST请求的地址不存在或者包含不⽀持的参数401UNAUTHORIZED未授权403FORBIDDEN被禁⽌访问404NOT FOUND请求的资源不存在422Unprocesable entity[POST/PUT/PATCH] 当创建⼀个对象时，发⽣⼀个验证错误500INTERNAL SERVER ERROR内部错误1.2. 登录1.2.1. 登录验证接⼝请求路径：login请求⽅法：post请求参数参数名参数说明备注username⽤户名不能为空password密码不能为空响应参数参数名参数说明备注id⽤户 IDrid⽤户⾓⾊ IDusername⽤户名mobile⼿机号email邮箱token令牌基于 jwt 的令牌响应数据{"data": {"id": 500,"rid": 0,"username": "admin","mobile": "123","email": "123@","token": "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1aWQiOjUwMCwicmlkIjowLCJpYXQiOjE1MTI1NDQyOTksImV4cCI6MTUxMjYzMDY5OX0.eGrsrvwHm-tPsO9r_pxHIQ5i5L1kX9RX444uwnRGaIM"},"meta": {"msg": "登录成功","status": 200}}1.3. ⽤户管理1.3.1. ⽤户数据列表请求路径：users请求⽅法：get请求参数参数名参数说明备注query查询参数可以为空pagenum当前页码不能为空pagesize每页显⽰条数不能为空响应参数参数名参数说明备注totalpage总记录数pagenum当前页码users⽤户数据集合响应数据{"data": {"totalpage": 5,"pagenum": 4,"users": [{"id": 25,"username": "tige117","mobile": "186********","type": 1,"email": "tige112@","create_time": "2017-11-09T20:36:26.000Z","mg_state": true, // 当前⽤户的状态"role_name": "炒鸡管理员"}]},"meta": {"msg": "获取成功","status": 200}}1.3.2. 添加⽤户请求路径：users请求⽅法：post请求参数参数名参数说明备注username⽤户名称不能为空password⽤户密码不能为空email邮箱可以为空mobile⼿机号可以为空响应参数参数名参数说明备注id⽤户 IDrid⽤户⾓⾊ IDusername⽤户名mobile⼿机号email邮箱响应数据{"data": {"id": 28,"username": "tige1200","mobile": "test","type": 1,"openid": "","email": "test@","create_time": "2017-11-10T03:47:13.533Z","modify_time": null,"is_delete": false,"is_active": false},"meta": {"msg": "⽤户创建成功","status": 201}}1.3.3. 修改⽤户状态请求路径：users/:uId/state/:type请求⽅法：put请求参数参数名参数说明备注uId⽤户 ID不能为空携带在url中type⽤户状态不能为空携带在url中，值为 true 或者 false 响应数据{"data": {"id": 566,"rid": 30,"username": "admin","mobile": "123456","email": "bb@","mg_state": 0},"meta": {"msg": "设置状态成功","status": 200}}1.3.4. 根据 ID 查询⽤户信息请求路径：users/:id请求⽅法：get请求参数参数名参数说明备注id⽤户 ID不能为空携带在url中响应参数参数名参数说明备注id⽤户 IDrole_id⾓⾊ IDmobile⼿机号email邮箱响应数据{"data": {"id": 503,"username": "admin3","role_id": 0,"mobile": "00000","email": "new@"},"meta": {"msg": "查询成功","status": 200}}1.3.5. 编辑⽤户提交请求路径：users/:id请求⽅法：put请求参数参数名参数说明备注id⽤户 id不能为空参数是url参数:idemail邮箱可以为空mobile⼿机号可以为空响应参数参数名参数说明备注id⽤户 IDrole_id⾓⾊ IDmobile⼿机号email邮箱响应数据/* 200表⽰成功，500表⽰失败 */{"data": {"id": 503,"username": "admin3","role_id": 0,"mobile": "111","email": "123@"},"meta": {"msg": "更新成功","status": 200}}1.3.6. 删除单个⽤户请求路径：users/:id请求⽅法：delete请求参数参数名参数说明备注id⽤户 id不能为空参数是url参数:id响应参数响应数据{"data": null,"meta": {"msg": "删除成功","status": 200}}1.3.7. 分配⽤户⾓⾊请求路径：users/:id/role请求⽅法：put请求参数参数名参数说明备注id⽤户 ID不能为空参数是url参数:idrid⾓⾊ id不能为空参数body参数响应参数参数名参数说明备注id⽤户 IDrole_id⾓⾊ IDmobile⼿机号email邮箱响应数据{"data": {"id": 508,"rid": "30","username": "asdf1","mobile": "123123","email": "adfsa@"},"meta": {"msg": "设置⾓⾊成功","status": 200}}1.4. 权限管理1.4.1. 所有权限列表请求路径：rights/:type请求⽅法：get参数名参数说明备注type类型值 list 或 tree , list 列表显⽰权限, tree 树状显⽰权限,参数是url参数:type 响应参数参数名参数说明备注id权限 IDauthName权限说明level权限层级pid权限⽗ IDpath对应访问路径响应数据 type=list{"data": [{"id": 101,"authName": "商品管理","level": "0","pid": 0,"path": null},{"id": 102,"authName": "订单管理","level": "0","pid": 0,"path": null}],"meta": {"msg": "获取权限列表成功","status": 200}}type=tree{data: [{id: 101,authName: '商品管理',path: null,pid: 0,children: [{id: 104,authName: '商品列表',path: null,pid: 101,children: [{id: 105,authName: '添加商品',path: null,pid: '104,101'}]}]}],meta: {msg: '获取权限列表成功',status: 200}}1.4.2. 左侧菜单权限请求路径：menus请求⽅法：get响应数据{"data":{"id": 101,"authName": "商品管理","path": null,"children": [{"id": 104,"authName": "商品列表","path": null,"children": []}]}"meta": {"msg": "获取菜单列表成功","status": 200}}1.5. ⾓⾊管理1.5.1. ⾓⾊列表请求路径：roles请求⽅法：get响应数据说明第⼀层为⾓⾊信息第⼆层开始为权限说明，权限⼀共有 3 层权限最后⼀层权限，不包含 children 属性响应数据{"data": [{"id": 30,"roleName": "主管","roleDesc": "技术负责⼈","children": [{"id": 101,"authName": "商品管理","path": null,"children": ["id": 104,"authName": "商品列表","path": null,"children": [{"id": 105,"authName": "添加商品","path": null}]}]}]}],"meta": {"msg": "获取成功","status": 200}}1.5.2. 添加⾓⾊请求路径：roles请求⽅法：post请求参数参数名参数说明备注roleName⾓⾊名称不能为空roleDesc⾓⾊描述可以为空响应参数参数名参数说明备注roleId⾓⾊ IDroleName⾓⾊名称roleDesc⾓⾊描述响应数据{"data": {"roleId": 40,"roleName": "admin2","roleDesc": "admin2Desc"},"meta": {"msg": "创建成功","status": 201}}1.5.3. 根据 ID 查询⾓⾊请求路径：roles/:id请求⽅法：get请求参数参数名参数说明备注:id⾓⾊ ID不能为空携带在url中响应参数参数名参数说明备注roleId⾓⾊ IDroleName⾓⾊名称roleDesc⾓⾊描述响应数据{"data": {"roleId": 31,"roleName": "测试⾓⾊","roleDesc": "测试负责⼈"},"meta": {"msg": "获取成功","status": 200}}1.5.4. 编辑提交⾓⾊请求路径：roles/:id请求⽅法：put请求参数参数名参数说明备注:id⾓⾊ ID不能为空携带在url中roleName⾓⾊名称不能为空roleDesc⾓⾊描述可以为空响应数据{"data": {"roleId": 31,"roleName": "测试⾓⾊","roleDesc": "测试⾓⾊描述"},"meta": {"msg": "获取成功","status": 200}}1.5.5. 删除⾓⾊请求路径：roles/:id请求⽅法：delete请求参数响应数据{"data": null, "meta": {"msg": "删除成功", "status": 200 }}1.5.6. ⾓⾊授权请求路径：roles/:roleId/rights 请求⽅法：post请求参数：通过 请求体 发送给后端响应数据{"data": null, "meta": {"msg": "更新成功", "status": 200 }}1.5.7. 删除⾓⾊指定权限请求路径：roles/:roleId/rights/:rightId 请求⽅法：delete 请求参数响应数据说明返回的data, 是当前⾓⾊下最新的权限数据响应数据{"data": [ {"id": 101,"authName": "商品管理", "path": null, "children": [ {"id": 104,"authName": "商品列表", "path": null, "children": [ {"id": 105,"authName": "添加商品", "path": null }, {"id": 116,"authName": "修改", "path": null } ] } ] } ],"meta": {"msg": "取消权限成功", "status": 200 }}1.6. 商品分类管理1.6.1. 商品分类数据列表请求路径：categories 请求⽅法：get 请求参数响应参数响应数据{"data": [ {"cat_id": 1,"cat_name": "⼤家电", "cat_pid": 0, "cat_level": 0,"cat_deleted": false, "children": [ {"cat_id": 3,"cat_name": "电视",参数名参数说明备注:id⾓⾊ ID不能为空携带在url 中参数名参数说明备注:roleId ⾓⾊ ID不能为空携带在url 中rids权限 ID 列表（字符串）以 , 分割的权限 ID 列表（获取所有被选中、叶⼦节点的key 和半选中节点的key, 包括 1，2，3级节点）参数名参数说明备注:roleId ⾓⾊ ID 不能为空携带在url 中:rightId权限 ID不能为空携带在url 中参数名参数说明备注type [1,2,3]值：1，2，3 分别表⽰显⽰⼀层⼆层三层分类列表【可选参数】如果不传递，则默认获取所有级别的分类pagenum 当前页码值【可选参数】如果不传递，则默认获取所有分类pagesize每页显⽰多少条数据【可选参数】如果不传递，则默认获取所有分类参数名参数说明备注cat_id 分类 ID cat_name 分类名称cat_pid 分类⽗ ID cat_level分类当前层级"cat_pid": 1,"cat_level": 1,"cat_deleted": false,"children": [{"cat_id": 6,"cat_name": "曲⾯电视","cat_pid": 3,"cat_level": 2,"cat_deleted": false},{"cat_id": 7,"cat_name": "海信","cat_pid": 3,"cat_level": 2,"cat_deleted": false}]}]}],"meta": {"msg": "获取成功","status": 200}}1.6.2. 添加分类请求路径：categories请求⽅法：post请求参数参数名参数说明备注cat_pid分类⽗ ID不能为空，如果要添加1级分类，则⽗分类Id应该设置为 0 cat_name分类名称不能为空cat_level分类层级不能为空，0表⽰⼀级分类；1表⽰⼆级分类；2表⽰三级分类响应数据{"data": {"cat_id": 62,"cat_name": "相框","cat_pid": "1","cat_level": "1"},"meta": {"msg": "创建成功","status": 201}}1.6.3. 根据 id 查询分类请求路径：categories/:id请求⽅法：get请求参数参数名参数说明备注:id分类 ID不能为空携带在url中响应数据{"data": {"cat_id": 3,"cat_name": "厨卫电器","cat_pid": 0,"cat_level": 0},"meta": {"msg": "获取成功","status": 200}}1.6.4. 编辑提交分类请求路径：categories/:id请求⽅法：put请求参数参数名参数说明备注:id分类 ID不能为空携带在url中cat_name分类名称不能为空【此参数，放到请求体中】响应数据{"data": {"cat_id": 22,"cat_name": "⾃拍杆","cat_pid": 7,"cat_level": 2},"meta": {"msg": "更新成功","status": 200}}1.6.5. 删除分类请求路径：categories/:id请求⽅法：delete请求参数参数名参数说明备注:id分类 ID不能为空携带在url中响应数据{"data": null,"meta": {"msg": "删除成功","status": 200}}1.7. 分类参数管理1.7.1. 参数列表请求路径：categories/:id/attributes请求⽅法：get请求参数参数名参数说明备注:id分类 ID不能为空携带在url中sel[only,many]不能为空,通过 only 或 many 来获取分类静态参数还是动态参数响应参数参数名参数说明备注attr_id分类参数 IDattr_name分类参数名称cat_id分类参数所属分类attr_sel only:输⼊框(唯⼀) many:后台下拉列表/前台单选框attr_write manual:⼿⼯录⼊ list:从列表选择attr_vals如果 attr_write:list,那么有值，该值以逗号分隔响应数据{"data": [{"attr_id": 1,"attr_name": "cpu","cat_id": 22,"attr_sel": "only","attr_write": "manual","attr_vals": "ffff"}],"meta": {"msg": "获取成功","status": 200}}1.7.2. 添加动态参数或者静态属性请求路径：categories/:id/attributes请求⽅法：post请求参数参数名参数说明备注:id分类 ID不能为空携带在url中attr_name参数名称不能为空attr_sel[only,many]不能为空attr_vals如果是 many 就需要填写值的选项，以逗号分隔【可选参数】响应数据{"data": {"attr_id": 44,"attr_name": "测试参数","cat_id": "1","attr_sel": "many","attr_write": "list","attr_vals": "a,b,c"},"meta": {"msg": "创建成功","status": 201}}1.7.3. 删除参数请求路径： categories/:id/attributes/:attrid请求⽅法：delete请求参数参数名参数说明备注:id分类 ID不能为空携带在url中:attrid参数 ID不能为空携带在url中响应数据{"data": null,"meta": {"msg": "删除成功","status": 200}}1.7.4. 根据 ID 查询参数请求路径：categories/:id/attributes/:attrId请求⽅法：get请求参数参数名参数说明备注:id分类 ID不能为空携带在url中:attrId属性 ID不能为空携带在url中attr_sel[only,many]不能为空attr_vals如果是 many 就需要填写值的选项，以逗号分隔响应数据{"data": {"attr_name": "cpu","cat_id": 22,"attr_sel": "only","attr_write": "manual","attr_vals": "ffff"},"meta": {"msg": "获取成功","status": 200}}1.7.5. 编辑提交参数请求路径：categories/:id/attributes/:attrId请求⽅法：put请求参数参数名参数说明备注:id分类 ID不能为空携带在url中:attrId属性 ID不能为空携带在url中attr_name新属性的名字不能为空，携带在请求体中attr_sel属性的类型[many或only]不能为空，携带在请求体中attr_vals参数的属性值可选参数，携带在请求体中响应数据{"data": {"attr_id": 9,"attr_name": "测试更新","cat_id": "43","attr_sel": "only","attr_write": "manual","attr_vals": "abc"},"meta": {"msg": "更新成功","status": 200}}1.8. 商品管理1.8.1. 商品列表数据请求路径：goods请求⽅法：get请求参数参数名参数说明备注query查询参数可以为空pagenum当前页码不能为空pagesize每页显⽰条数不能为空响应参数参数名参数说明备注total总共商品条数pagenum当前商品页数goods_id商品 IDgoods_name商品名称goods_price价格goods_number数量goods_weight重量不能为空goods_state商品状态商品状态 0: 未通过 1: 审核中 2: 已审核add_time添加时间upd_time更新时间hot_mumber热销品数量is_promote是否是热销品响应数据{"data": {"total": 50,"pagenum": "1","goods": [{"goods_id": 144,"goods_name": "asfdsd","goods_price": 1,"goods_number": 1,"goods_weight": 1,"goods_state": null,"add_time": 1512954923,"upd_time": 1512954923,"hot_mumber": 0,"is_promote": false}]},"meta": {"msg": "获取成功","status": 200}}1.8.2. 添加商品请求路径：goods请求参数参数名参数说明备注goods_name商品名称不能为空goods_cat以为','分割的分类列表不能为空goods_price价格不能为空goods_number数量不能为空goods_weight重量不能为空goods_introduce介绍可以为空pics上传的图⽚临时路径（对象）可以为空attrs商品的参数（数组），包含动态参数和静态属性可以为空请求数据{"goods_name":"test_goods_name2","goods_cat": "1,2,3","goods_price":20,"goods_number":30,"goods_weight":40,"goods_introduce":"abc","pics":[{"pic":"/tmp_uploads/30f08d52c551ecb447277eae232304b8"}],"attrs":[{"attr_id":15,"attr_value":"ddd"},{"attr_id":15,"attr_value":"eee"}]}响应参数参数名参数说明备注total总共商品条数pagenum当前商品页数goods_id商品 IDgoods_cat以为','分割的分类列表goods_name商品名称goods_price价格goods_number数量goods_weight重量不能为空goods_state商品状态商品状态 0: 未通过 1: 审核中 2: 已审核add_time添加时间upd_time更新时间hot_mumber热销品数量is_promote是否是热销品pics上传的图⽚临时路径（对象）pics_id:图⽚ ID,goods_id:商品 ID,pics_big:⼤图,pics_mid:中图,pics_sma:⼩图attrs商品的参数（数组）goods_id:商品 ID,attr_value:当前商品的参数值,add_price:浮动价格,attr_vals:预定义的参数值,attr_sel:⼿动输⼊，还是单选,响应数据{"data": {"goods_id": 145,"goods_name": "test_goods_name2","goods_price": 20,"cat_id": 1,"goods_number": 30,"goods_weight": 40,"goods_introduce": "abc","goods_big_logo": "","goods_small_logo": "","goods_state": 1,"add_time": 1512962370,"upd_time": 1512962370,"hot_mumber": 0,"is_promote": false,"pics": [{"pics_id": 397,"goods_id": 145,"pics_big": "uploads/goodspics/big_30f08d52c551ecb447277eae232304b8","pics_mid": "uploads/goodspics/mid_30f08d52c551ecb447277eae232304b8","pics_sma": "uploads/goodspics/sma_30f08d52c551ecb447277eae232304b8"}],"attrs": [{"goods_id": 145,"attr_id": 15,"attr_value": "ddd","add_price": null,"attr_name": "fffffff","attr_sel": "many","attr_write": "list","attr_vals": ""},{"goods_id": 145,"attr_id": 15,"attr_value": "eee","add_price": null,"attr_name": "fffffff","attr_sel": "many","attr_write": "list","attr_vals": ""}]},"meta": {"msg": "创建商品成功","status": 201}}1.8.3. 根据 ID 查询商品请求路径：goods/:id请求⽅法：get请求参数参数名参数说明备注id商品 ID不能为空携带在url中响应参数参数名参数说明备注total总共商品条数pagenum当前商品页数goods_id商品 IDgoods_name商品名称goods_price价格goods_number数量goods_weight重量不能为空goods_state商品状态商品状态 0: 未通过 1: 审核中 2: 已审核add_time添加时间upd_time更新时间hot_mumber热销品数量is_promote是否是热销品pics上传的图⽚临时路径（对象）pics_id:图⽚ ID,goods_id:商品 ID,pics_big:⼤图,pics_mid:中图,pics_sma:⼩图attrs商品的参数（数组）goods_id:商品 ID,attr_value:当前商品的参数值,add_price:浮动价格,attr_vals:预定义的参数值,attr_sel:⼿动输⼊，还是单选,响应数据{"data": {"goods_id": 145,"goods_name": "test_goods_name2","goods_price": 20,"goods_number": 30,"goods_weight": 40,"goods_introduce": "abc","goods_big_logo": "","goods_small_logo": "","goods_state": 1,"add_time": 1512962370,"upd_time": 1512962370,"hot_mumber": 0,"is_promote": false,"pics": [{"pics_id": 397,"goods_id": 145,"pics_big": "uploads/goodspics/big_30f08d52c551ecb447277eae232304b8","pics_mid": "uploads/goodspics/mid_30f08d52c551ecb447277eae232304b8","pics_sma": "uploads/goodspics/sma_30f08d52c551ecb447277eae232304b8"}],"attrs": [{"goods_id": 145,"attr_id": 15,"attr_value": "ddd","add_price": null,"attr_name": "fffffff","attr_sel": "many","attr_write": "list","attr_vals": ""},{"goods_id": 145,"attr_id": 15,"attr_value": "eee","add_price": null,"attr_name": "fffffff","attr_sel": "many","attr_write": "list","attr_vals": ""}]},"meta": {"msg": "创建商品成功","status": 201}}1.8.4. 编辑提交商品请求路径：goods/:id请求⽅法：put请求参数参数名参数说明备注id商品 ID不能为空携带在url中goods_name商品名称不能为空goods_price价格不能为空goods_number数量不能为空goods_weight重量不能为空goods_introduce介绍可以为空pics上传的图⽚临时路径（对象）可以为空attrs商品的参数（数组）可以为空请求数据{"goods_name":"test_goods_name2","goods_price":20,"goods_number":30,"goods_weight":40,"goods_introduce":"abc","pics":[{"pic":"/tmp_uploads/30f08d52c551ecb447277eae232304b8"}],"attrs":[{"attr_id":15,"attr_value":"ddd"},{"attr_id":15,"attr_value":"eee"}]}响应参数参数名参数说明备注total总共商品条数pagenum当前商品页数goods_id商品 IDgoods_name商品名称goods_price价格goods_number数量goods_weight重量不能为空goods_state商品状态商品状态 0: 未通过 1: 审核中 2: 已审核add_time添加时间upd_time更新时间hot_mumber热销品数量is_promote是否是热销品pics上传的图⽚临时路径（对象）pics_id:图⽚ ID,goods_id:商品 ID,pics_big:⼤图,pics_mid:中图,pics_sma:⼩图attrs商品的参数（数组）goods_id:商品 ID,attr_value:当前商品的参数值,add_price:浮动价格,attr_vals:预定义的参数值,attr_sel:⼿动输⼊，还是单选,响应数据{"data": {"goods_id": 145,"goods_name": "test_goods_name2","goods_price": 20,"goods_number": 30,"goods_weight": 40,"goods_introduce": "abc","goods_big_logo": "","goods_small_logo": "","goods_state": 1,"add_time": 1512962370,"upd_time": 1512962370,"hot_mumber": 0,"is_promote": false,"pics": [{"pics_id": 397,"goods_id": 145,"pics_big": "uploads/goodspics/big_30f08d52c551ecb447277eae232304b8","pics_mid": "uploads/goodspics/mid_30f08d52c551ecb447277eae232304b8","pics_sma": "uploads/goodspics/sma_30f08d52c551ecb447277eae232304b8"}],"attrs": [{"goods_id": 145,"attr_id": 15,"attr_value": "ddd","add_price": null,"attr_name": "fffffff","attr_sel": "many","attr_write": "list","attr_vals": ""},{"goods_id": 145,"attr_id": 15,"attr_value": "eee","add_price": null,"attr_name": "fffffff","attr_sel": "many","attr_write": "list","attr_vals": ""}]},"meta": {"msg": "创建商品成功","status": 201}}1.8.5. 删除商品请求路径：goods/:id请求⽅法：delete请求参数参数名参数说明备注id商品 ID不能为空携带在url中响应数据{"data": null,"meta": {"msg": "删除成功","status": 200}}###同步商品图⽚请求路径：goods/:id/pics请求⽅法：put请求参数参数名参数说明备注id商品 ID不能为空携带在url中pics商品图⽚集合如果有 pics_id 字段会保留该图⽚，如果没有 pics_id 但是有 pic 字段就会新⽣成图⽚数据请求数据;[{ pic: 'tmp_uploads/db28f6316835836e97653b5c75e418be.png' },{pics_id: 397,goods_id: 145,pics_big: 'uploads/goodspics/big_30f08d52c551ecb447277eae232304b8',pics_mid: 'uploads/goodspics/mid_30f08d52c551ecb447277eae232304b8',pics_sma: 'uploads/goodspics/sma_30f08d52c551ecb447277eae232304b8'}]响应数据{"data": {"goods_id": 96,"goods_name": "iphoneXX","goods_price": 2,"goods_number": 22,"goods_weight": 22,"goods_introduce": null,"goods_big_logo": "./uploads/goods/20171113/483a3b8e99e534ec3e4312dbbaee7c9d.jpg","goods_small_logo": "./uploads/goods/20171113/small_483a3b8e99e534ec3e4312dbbaee7c9d.jpg","goods_state": 0,"is_del": "1","add_time": 1510045904,"upd_time": 1512635159,"delete_time": 1512635159,"hot_mumber": 0,"is_promote": false,"pics": [{"pics_id": 383,"goods_id": 96,"pics_big": "uploads/goodspics/big_6f5750132abd3f5b2b93dd722fcde653.jpg","pics_mid": "uploads/goodspics/mid_6f5750132abd3f5b2b93dd722fcde653.jpg","pics_sma": "uploads/goodspics/sma_6f5750132abd3f5b2b93dd722fcde653.jpg"}],"attrs": [{"goods_id": 96,"attr_id": 15,"attr_value": "eee","add_price": null,"attr_name": "fffffff","attr_sel": "many","attr_write": "list","attr_vals": ""},{"goods_id": 96,"attr_id": 15,"attr_value": "ddd","add_price": null,"attr_name": "fffffff","attr_sel": "many","attr_write": "list","attr_vals": ""}]},"meta": {"msg": "更新成功","status": 200}}###同步商品属性请求路径：goods/:id/attributes请求⽅法：put请求参数参数名参数说明备注id商品 ID不能为空携带在url中请求数据;[{attr_id: 15,attr_value: 'ddd'},{attr_id: 15,attr_value: 'eee'}]{"data": {"goods_id": 96,"goods_name": "iphoneXX","goods_price": 2,"goods_number": 22,"goods_weight": 22,"goods_introduce": null,"goods_big_logo": "./uploads/goods/20171113/483a3b8e99e534ec3e4312dbbaee7c9d.jpg","goods_small_logo": "./uploads/goods/20171113/small_483a3b8e99e534ec3e4312dbbaee7c9d.jpg","goods_state": 0,"is_del": "1","add_time": 1510045904,"upd_time": 1512635159,"delete_time": 1512635159,"hot_mumber": 0,"is_promote": false,"pics": [{"pics_id": 383,"goods_id": 96,"pics_big": "uploads/goodspics/big_6f5750132abd3f5b2b93dd722fcde653.jpg","pics_mid": "uploads/goodspics/mid_6f5750132abd3f5b2b93dd722fcde653.jpg","pics_sma": "uploads/goodspics/sma_6f5750132abd3f5b2b93dd722fcde653.jpg"}],"attrs": [{"goods_id": 96,"attr_id": 15,"attr_value": "eee","add_price": null,"attr_name": "fffffff","attr_sel": "many","attr_write": "list","attr_vals": ""},{"goods_id": 96,"attr_id": 15,"attr_value": "ddd","add_price": null,"attr_name": "fffffff","attr_sel": "many","attr_write": "list","attr_vals": ""}]},"meta": {"msg": "更新成功","status": 200}}###商品图⽚处理必须安装 GraphicsMagicklinuxapt-get install GraphicsMagickMac OS Xbrew install GraphicsMagickWindows1.9. 图⽚上传请求路径：upload请求⽅法：post请求参数参数名参数说明备注file上传⽂件响应数据{"data": {"tmp_path": "tmp_uploads/ccfc5179a914e94506bcbb7377e8985f.png","url": "http://127.0.0.1:8888tmp_uploads/ccfc5179a914e94506bcbb7377e8985f.png"},"meta": {"msg": "上传成功","status": 200}}1.10. 订单管理1.10.1. 订单数据列表请求路径：orders请求⽅法：get请求参数参数名参数说明备注query查询参数可以为空pagenum当前页码不能为空pagesize每页显⽰条数不能为空user_id⽤户 ID可以为空pay_status⽀付状态可以为空is_send是否发货可以为空order_fapiao_title['个⼈','公司']可以为空order_fapiao_company公司名称可以为空order_fapiao_content发票内容可以为空consignee_addr发货地址可以为空响应数据{"data": {"total": 1,"pagenum": "1",。
京东快递电子面单API对接文档
StringBuilder result = new StringBuilder();
try {
URL realUrl = new URL(url);
HttpURLConnection conn =(HttpURLConnection) realUrl.openConnection();
conn.setRequestProperty("connection", "Keep-Alive");
conn.setRequestProperty("user-agent",
"Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1;SV1)");
conn.setRequestProperty("Content-Type", "application/x-www-form-urlencoded");
{
return base64(MD5(content + keyValue, charset), charset);
}
return base64(MD5(content, charset), charset);
}
/**
* 向指定 URL发送POST方法的请求
* @param url发送请求的 URL
sb.append("0");
}
sb.append(Integer.toHexString(val));
}
return sb.toString().toLowerCase();
}
京东物流电子面单接口API-对接说明文档
sr.Close();
backStream.Close();
response.Close();
request.Abort();
}
catch (Exception ex)
{
result = ex.Message;
}
return result;
}
///<summary>
/// <param name="charset">编码方式</param>
/// <returns></returns>
private string base64(String str, String charset)
3.C#对接demo
using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using ;
using System.Text;
using System.Web;
namespace KdGoldAPI
3、技术对接及联调（登陆官网使用调试平台进行测试）
4、上线
三.电子面单对接说明
1.接口描述
接口支持的消息接收方式：HTTP POST
请求方法的编码格式(utf-8)："application/x-www-form-urlencoded;charset=utf-8"
API地址：/Ebusiness/EbusinessOrderHandle.aspx
request.Timeout = 30 * 1000;
iOS-current-京东APP联盟SDK_iOS版接口说明文档
京东APP联盟SDK_iOS版接口说明文档1.01.配置环境1.1 添加SDK（Target->Build Phases->Link Binary With Libraries）1.2 添加本SDK依赖的Framework：CoreTelephony.framework, AdSupport.framework,MessageUI.framework,SystemConfiguration.framework, CoreLocatioin.framework1.3 将SDK.framework添加到Copy Bundle Resources，如果不添加，本SDK中的一些资源类文件将无法被成功加载1.4由于SDK中使用到category ，请执行以下操作。
Build Settings -> Linking ->Other Linker Flags。
添加: $(OTHER_LDFLAGS) –ObjC或-all_load。
2.接口示例及说明2.1 JDAdManager初始化示例代码:JDAdAppInfo* app =[[JDAdAppInfo alloc] init];JDAdUser* user = [[JDAdUser alloc]initJDAdUserWithGender:JDAdGenderMaleyob:@"1983"keywords:nilsegments:nil];[JDAdManager shareManager].app = app;[JDAdManager shareManager].user = user;[JDAdManager shareManager].isHttp = YES;[JDAdManager shareManager].istest = NO;[JDAdManager shareManager].adViewDelegate = self;[JDAdManager shareManager].adDelegate = self;详情请参考demo代码说明：（1）app和user的获取请参考第3节。
京东快递物流上门揽件-在线下单API接口
京东快递上门揽件-在线下单API接口近几年来，我国电子商务交易规模越来越大，线上订单越来越多，退换货的情况也越来越常见。
退换货环节是线上购物过程中的重要一环，也是体现电商平台与商家服务水平的重要方面。
同时，退换货也是电商平台、商家与消费者之间最容易产生纠纷的环节。
为了保障这个环节的服务，电商平台推出了退换货上门取件业务。
退换货上门取件是为买家在退货时，提供的一种省心，便捷的物流服务，当买家购买的商品在申请换货或者发起维权投诉时需要退货，不需要自己邮寄商品，由物流公司安排快递员上门取件的一项服务。
目录1.接口功能说明2.完成前期准备工作3.API接口4.请求参数（示例）5.返回报文（示例）6.完整请求的报文（URL编码）7.解码后的报文8.分步讲解（C#版本）9.关于签名接口功能说明此接口用于通知快递公司快递员上门揽件。
2.完成前期准备工作去快递鸟官网免费注册一个账号免费获得一个apiKey(接口权限验证需要) 完成实名认证流程订购一个免费套餐3.API接口测试调用地址/正式调用地址官网获取请求方式：POST返回类型：JSON4.请求参数（示例）5.返回报文（示例）分步讲解（C#版本）请求数据包结构关于签名快递鸟和第三方电子商务公司系统进行对接，有一定的安全机制。
采用IP认证加签名的方式对接，具体方案如下：1.防止数据被篡改在POST请求中会传递5个必须(R)参数RequestData==数据内容(URL编码:UTF-8)EBusinessID==用户IDRequestType=请求指令类型DataSign== 数据内容签名：把(请求内容(未编码)+ApiKey)进行MD5加密，然后Base64编码，最后进行URL(utf-8)编码DataType==2(返回数据类型为json)注：DataSign生成后，对方接收到数据后，以同样的算法进行签名(推送接口RequestType为101/102不需要进行URL编码)，生成摘要，对比两者的摘要是否相同，如果不同，说明传递过程中发生数据篡改。
- 1、下载文档前请自行甄别文档内容的完整性，平台不提供额外的编辑、内容补充、找答案等附加服务。
- 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
- 3、如文档侵犯您的权益，请联系客服反馈,我们会尽快为您处理(人工客服工作时间：9:00-18:30)。
1、类目API
获取商家类目信息
获取类目属性
通过类目属性ID获取属性值列表
设置商家级别的类目销售属性值
添加商家商品销售属性
更新商家商品销售属性
获取类目属性列表
获取类目属性值
获取单个类目信息
查找子类目列表
查询商家已授权的品牌
数据结构
item_cat
categoryAttr类目属性对象
attrFeature类目属性特殊属性
categoryAttrGroup属性分组
attrGroupFeature属性分组特殊属性
categoryAttrValue类目属性值对象
attrValueFeature类目属性特殊属性
feature特殊属性
wareaddvender_sellsku添加商家商品销售属性
wareupdatevender_sellsku更新商家商品销售属性
brandList商家品牌List集合
2、店铺API
京东店铺API，包含提供商家、商家店铺基本信息及店内分类操作查询等功能。
添加卖家自定义店内分类
更新商家自定义店内分类
删除商家自定义店内分类
获取前台展示的商家自定义店内分类
查询商家基本信息
店铺信息查询
查询退货地址列表
查询发货地址列表
3、商品API
提供网站商品信息更新、查询API,该组下所有接口均不支持自营店铺业务
1. 新增商品
修改商品
商品上架
商品下架
删除商品信息
根据商品ID查询单个商品的详细信息
批量获取商品信息
检索商品信息
获取商品上架的商品信息
获取商品下架的商品信息
根据商品Id，销售属性值Id查询图片根据商品Id，销售属性值Id增加图片根据商品Id，销售属性值Id删除图片根据商品Id，销售属性值Id设置图片根据商品Id，检索商品图片
设置商品限购区域
查询商品限购区域
添加商品关联版式
修改商品关联版式
删除商品关联版式
查询关联版式id以及名称
查询关联版式详情
设置关联版式到商品
增加SKU信息
修改SKU信息
修改SKU库存信息
修改SKU价格信息
删除SKU 信息
根据外部ID获取商品SKU
根据商品ID列表获取商品SKU信息
获取单个SKU信息
回复商品评价
查询商品评价信息列表
删除商品
修改商品名称
商品上下架
恢复删除商品
设置商品定时上下架
新增和修改商品图片的接口，支持批量删除商品图片
Sku删除
获取sku库存信息
新增关联板式信息
删除关联板式
修改关联板式信息
商品上绑定关联版式
商品广告词
设置商品限购/可购区域
设置sku库存
sku打标
商品打标
获取单个商品
搜索回收站商品
搜索有效商品
获取单个SKU
SKU搜索服务
保存商品店内分类
保存商品运费模板
获取商品限购/可购
获取商品下架原因
获取商品或者颜色主图
通过颜色获取商品图片列表
获取商品上的所有图片列表
修改SKU京东价
更新商品市场价
更新商品成本价
查询商品店内分类列表
查询关联版式内容
获取商家关联版式
获取商品广告词
发布商品
修改商品
更新商品维度的销售属性值别名
全量保存SKU
增量保存SKU
数据结构
skuInfo SKU集合
ware商品信息
ware_info商品对象
propimg元素描述
ware_area_limit
ware_template关联版式集合
popCommentVo popComment
popCommentReplyVo popCommentReplyVo
parentReply parentReply
sku_stock sku库存信息
adWords商品广告词
feature特殊属性对象
image图片
page商品列表
wareAreaLimit限购/可购对象
opReason操作原因
wareTemplate关联版式对象
4、订单API
订单检索
获取单个订单
FBP订单检索
FBP获取单个订单
面单打印
获取面单打印数据
SOP获取面单打印数据
LBP获取面单打印数据
SOPL获取面单打印数据
订单SOP出库
订单LBP出库
订单SOPL出库
海外购订单出库
海外购订单发货
SOP修改运单号
SOPL修改运单号
LBP修改运单号
查询商家备注
商家订单备注修改
删单申请
取消删单申请
批量查询商家的码信息
根据订单号查询码信息
商家回传验证码
消费验证码
获取验证码信息
根据创建时间获取订单备注
根据修改时间段获取订单备注
查询单品模板
查询单品模板规则
充值余量查询接口
分拣信息同步接口
审核回调接口
商家充值、扣减单号数量接口
网点同步接口
数据结构
order_search
order_info订单
consignee_info收货人基本信息
item_info
coupon_detail元素描述
vat_invoice_info增值税发票可选字段，需要在输入参数optional_fields中写入才能返回orderDetailInfo订单详细信息
orderInfo订单数据
print_result
order_printdata面单打印数据
order_item商品列表
Consignee客户信息
venderRemarkQueryResult接口返回结果
api_jos_result
vender_remark商家备注内容，当查询结果不正确时，备注为Null
loccodeinfo_result根据订单号查询码信息结果
consume_result消费码的结果
cknumber_result查询验证码信息结果
check_number验证码详情
getremarkbymodifytime_result备注结果
v1订单备注详情
query_skuFareTemplate_result根据venderId获取单品模板集合
sku_FareTemplate单品模板信息
query_skuFare_template_ruleResult根据templateId获取单品模板的所有规则queryrechargehasnumamount_result返回信息
sortsync_result返回信息editcheckstatus_result返回信息rechargeabatement_result返回信息sitesync_result返回信息5、。