网店管家api对接当当接入手册说明
史上最详细淘宝联盟API使用教程
史上最详细淘宝联盟API使用教程API是什么？API是一种接口，提供给淘客通过输入某些信息，来输出对应的淘宝联盟提供的某些信息和某种服务的一个通道。
API如何使用？淘宝联盟的API都通过淘宝开放平台做开放输出。
使用API需要分4步。
•一、网站/APP备案要使用API必须要网站或者APP 备案。
进入联盟后台，点击推广管理—>网站管理—>新增网站推广; 根据页面引导，填写备案信息，等待审核。
•二、申请APPKEY申请APPKEY: 网站审核通过后，点击查看权限—>申请权限，申请需要的APPKEY。
按点击“申请权限”会跳到“阿里开放平台”，按流程操作即可。
查看APPKEY: 申请成功后，在网站/APP管理相应位置查看。
三、下载SDK要使用API，必须先下载阿里开放平台的SDK。
SDK提供调用API 的功能包，封装了API请求方法，用于集成到服务端程序中，获取相关数据使用。
从联盟APP 备案网站下的APPKEY信息右侧点击“查看”就可到阿里开放平台下载SDK。
如下图，根据实际情况选择对应的版本。
四、使用API接下来就可以根据需要使用的API说明文档来使用API啦。
请求参数为入参，响应参数为出参。
adzoneID，备案网站（site id）和APPKEY三者必须配套，才可正常调用。
如果APPKEY和adzoneID不匹配或传递参数错误，会不算淘客交易或者取无法正常调用。
F&Q1.API的调用量是多少？单一API没有调用量限制，但是阿里开放平台对APP证书的调用量进行了限制，默认为10W/天，可以进入自己的TOP平台进行查询。
当当日调用量超过90%时，可申请自助提升调用量（提升量仅当日有效）。
2、传参错误：使用中API中， adzoneID，备案网站（site id）和APPKEY三者必须配套，才可正常调用。
如果APPKEY和adzoneID不匹配或传递参数错误，会不算淘客交易或者取无法正常调用。
api数据对接技术方案
api数据对接技术方案【实用版】目录1.API 数据对接技术的背景和重要性2.API 数据对接的基本原理3.API 数据对接的技术方案4.API 数据对接的实施步骤5.API 数据对接的注意事项6.API 数据对接技术的发展趋势正文API 数据对接技术方案随着信息技术的快速发展，API 数据对接技术在各个领域中发挥着越来越重要的作用。
为了更好地实现数据共享和信息传递，各个系统、平台和应用之间的数据对接变得尤为重要。
本文将介绍 API 数据对接技术的背景和重要性，基本原理，技术方案，实施步骤，注意事项以及发展趋势。
一、API 数据对接技术的背景和重要性API（应用程序编程接口）是一种让不同软件之间进行互动和通信的接口。
通过 API 接口，可以实现数据的传输和交换，从而实现各个系统之间的无缝对接。
API 数据对接技术在许多领域中具有广泛的应用，例如企业管理、物联网、智能硬件等。
二、API 数据对接的基本原理API 数据对接的基本原理是通过一定的数据格式和协议，将数据从一方传输到另一方。
常见的数据格式有 JSON、XML 等，协议有 HTTP、HTTPS 等。
数据对接的过程中，需要保证数据的安全性、完整性和准确性。
三、API 数据对接的技术方案1.RESTful API：REST（表述性状态转移）是一种基于 HTTP 协议的数据对接技术，它采用 CRUD（创建、读取、更新、删除）等操作来实现数据的交互。
RESTful API 具有简单、易于理解和使用的特点。
2.WebSocket API：WebSocket 是一种全双工通信协议，可以实现实时数据传输。
它适用于对实时性要求较高的场景，如在线聊天、实时股价等。
3.gRPC API：gRPC 是一种高性能、开源、通用的远程过程调用（RPC）框架。
它通过 Protocol Buffers（一种高效的二进制序列化协议）来定义数据结构和服务接口，从而实现数据的高效传输。
验证码接收平台API对接的详细说明
极码验证码接收平台API对接的详细说明 系统API的说明所有注册用户都可以使用接口，无需找管理员开通,所有帐号都可以是开发者！接口地址：/api.aspx?action=接口统一编码：UTF-8接口调用方式：HTTP，支持GET和POST两种方式。
接口调用时间间隔：50毫秒。
如果低于50毫秒会提示"message|please try again later"GET调用方法：/api.aspx?action=方法名&参数1=值&参数2=值（具体方法名及参数请参考接口方法）注意：服务器返回no_data时表示系统暂时没有可用号码了，请使用死循环每隔一分钟请求一次手机号，平台是不定时加号的。
max_count_disable出现这个提示是因为您获取的号码以达到上限，每个获取到的号码都必须正确处理(要么调用ReleaseMobile释放号码退出任务，要么获取验证码，要么号码不能用加黑，要么号码收不到短信加黑。
getRecvingInfo方法可以查看您当前获取的手机号码如果接口返回action_parameter_error 表示传入方法名错误或方法不存在。
用户登录（/index.aspx）[方法名] loginIn传入参数：1. uid:用户名2. pwd:密码GET方式调用实例：/api.aspx?action=loginIn&uid=用户名&pwd=密码方法调用返回值示例：1.成功返回：用户名|token(下面所有方法都要用的令牌)2. 失败返回值说明：返回值说明login_error 用户名密码错误message|please try again访问速度过快，建议休眠50毫秒后再试lateraccount_is_locked 账号被锁定用户名密码错误login_error获取用户个人信息[方法名] getUserInfos传入参数：1. uid=用户名2. token=登录时返回的令牌GET方式调用实例：/api.aspx?action=getUserInfos&uid=用户名&token=登录时返回的令牌方法调用返回值示例：1.成功返回：用户名;积分;余额;可同时获取号码数2. 失败返回值说明返回值说明parameter_error 传入参数错误not_login 没有登录,在没有登录下去访问需要登录的资源，忘记传入uid,token message|please try again later 访问速度过快，建议休眠50毫秒后再试account_is_locked 账号被锁定unknow_error 未知错误,再次请求就会正确返回获取手机号码[方法名] getMobilenum说明：项目ID请登录官网，查看项目管理获得传入参数：1. pid=项目ID2. uid=登录用户名3. token=登录时返回的令牌4. lock=是否锁定号码(可以不填写该参数，"1"为锁定。
api对接合同模板(2篇)
第1篇合同编号：________________签订日期：________________甲方（服务提供方）：________________地址：________________联系电话：________________乙方（服务接受方）：________________地址：________________联系电话：________________鉴于：1. 甲方拥有（API名称）API接口（以下简称“API”），并提供API相关的技术支持和服务。
2. 乙方有意使用甲方的API进行其业务系统的开发、集成和运营。
3. 甲乙双方本着平等互利、协商一致的原则，就API对接事宜达成如下协议：第一条 API接口说明1.1 甲方承诺向乙方提供的API接口为（API名称），包括但不限于以下功能：（列举API接口的功能）1.2 API接口的技术参数、使用限制、访问频率等具体要求，详见附件一《API接口技术规范》。
第二条接口使用权限2.1 乙方获得甲方授权，在约定的期限内，有权使用甲方提供的API接口进行业务系统的开发、集成和运营。
2.2 乙方不得将API接口用于任何违法、违规、侵犯他人合法权益的活动。
2.3 乙方不得将API接口转让、出租、出借或以其他方式提供给第三方使用。
第三条技术支持与维护3.1 甲方负责向乙方提供API接口的技术支持，包括但不限于以下内容：（列举甲方提供的技术支持内容）3.2 甲方应确保API接口的稳定性和安全性，对因API接口故障导致乙方业务系统无法正常使用的情况，甲方应立即进行排查和修复。
3.3 乙方在使用API接口过程中遇到的技术问题，应及时向甲方反馈，甲方应在收到反馈后（具体时间）内给予答复。
第四条数据安全和隐私保护4.1 乙方在使用API接口过程中，应遵守相关法律法规，保护用户数据安全和隐私。
4.2 乙方不得利用API接口收集、存储、使用、泄露用户个人信息。
4.3 甲方对API接口涉及的用户数据进行加密存储，并采取必要的安全措施，防止数据泄露。
api接口对接标准
api接口对接标准
API接口对接标准主要包括以下几点：
1. 请求方式：通常使用HTTP请求，如GET、POST等。
2. 请求头：包含请求头信息，如Content-Type、Authorization等。
3. 请求参数：根据接口需求，携带相应的请求参数。
4. 响应格式：返回的响应数据应符合规范，如JSON、XML等。
5. 状态码：响应状态码用以表示请求是否成功，如200表示成功，4 04表示找不到资源等。
6. 错误处理：接口应具备完善的错误处理机制，如返回错误信息、异常处理等。
7. 安全性：保证数据传输的安全性，如使用HTTPS加密传输、设置访问权限等。
8. 性能优化：接口应具备良好的性能，如减少请求次数、缓存数据等。
9. 兼容性：考虑不同平台、浏览器和设备的兼容性。
10. 文档：提供清晰的接口文档，包括接口地址、请求方式、请求参数、响应格式等。
遵循以上标准进行API接口对接，可以确保接口的稳定、高效和易用。
网店管家2[1].3用户手册
![网店管家2[1].3用户手册](https://img.taocdn.com/s3/m/ef7db51e4b35eefdc8d333e2.png)
网店管家2.3用户手册网店管家市场部编制目录第一章：软件简介 4 第二章：初次使用设置 51.导航界面说明 52.系统 53.目录10 第三章：客户管理171.客户——客户分类172.客户——会员等级183.客户管理184.客户——批量导入19 第四章：销售191.销售——新建订单192.销售——订单审核203.销售——发货出库224.销售——现款销售225.销售——订单查询236.销售——快递代收247.销售——邮资月结24 第五章：库存251.库存——入库管理252.库存——出库管理253.库存——库存查询264.库存——今日断货275.库存——盘点管理27 第六章：统计29 第七章：自定义301.纸张大小的选择302.添加文字303.插入图片314.插入线条、形状325.对象的属性326.插入字段337.快递单的设计字段338.发货单（配货单）设计字段359.现款销售单设计字段3810.自定义——货运单货品项42 第八章：服务421.服务——检测最新版本422.服务——邮件模板423.服务——手机短信434.服务——浏览器插件44第一章：软件简介1.简介《网店管家2.3》是一款面向B2C、C2C商家，专注于电子商务进销存管理的软件。
软件涵括了销售订单处理、采购、仓储和客户管理等网商企业后端全业务体系的支撑功能，基本满足小的电子商务业务的基本处理和在业务运营过程中面临的多方面管理需求。
与传统的零售批发相比，在线销售的业务模式不仅仅是工具意义上的差异，在营销理念、管理思想上也发生了很多变化。
以解决线下销售管理为设计目标的传统进销存系统，在新的业务模式下，格格不入也就理所当然。
《网店管家》便是以解决在线销售的业务模式而开发的管理软件，它一定会帮助您快速处理业务并且给您提供准确有效地管理方式。
为了提高效率《管家2.3》将ESAPI下载订单接口糅合在软件里面，另外为了加强客户的维护还开发了可以发送短信的短信平台。
电商管理后台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",。
网店管家3.0内部培训使用
1.安装：数据库、应用服务器、客户端、 管家助理1.3、ESAPI1.5和蜘蛛1.7 2.设置：设置系统、目录设置 3.维护：应用服务器和管家
系统配置建议
服务器
• 硬件：CPU主频2000M以上/ 内存1G以上/硬盘160G以上 • 操作系统：Win XP、Win2000 Server、 Win2003 server • SQL版本：SQL Server 2000 personal SP3、SQL Server2000 企业版 SP4
手工单个新建 EXCLE导入
单个修改 批量修改 利用EXCLE更新货品信息
编辑货品信息 • 基础信息：零售价，编号，条码，品名，其他。 • 多规格：只针对有多个规格颜色的商品。 • 存放仓库：货品存放的仓库，不选择会导致订单处理
时提示“货品无效”。
• 供货商：货品采购于哪个供货商，并且供货商的进货
首先建立好需要下载订单的店铺信息 订 单 处 理 之 抓 单
这里的店铺名称和类型是在管家 置菜单下“店铺目录”中设置的
• 1.升级（必须是应用服务器和管家所有客户端都升级）
2.归档(数据过于庞大的时候读取数据的速度会慢很多，归档就是将数据归档到另 一张表加快数据读取的速度。归档计划可以帮助我们自动归档）
• 自动备份数据/aspx/topic.aspx?tid=2487 • 建议安装SQL的时候就做好这个自动备份的工作，防止数 据突然崩溃。 如何还原数据 /aspx/topic.aspx?tid=3187
店 铺 信 息 编 辑
模板可以和店铺绑 定，若发现这里绑 定了还是需要手动 选择模板可以进入 “维护-系统设置单据打印里面设置” 地址信息是打印在 快递单上的注意填 写。
填写登陆店铺的用 户名和密码，可用 于在管家里面进入 店铺检视订单
- 1、下载文档前请自行甄别文档内容的完整性，平台不提供额外的编辑、内容补充、找答案等附加服务。
- 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
- 3、如文档侵犯您的权益，请联系客服反馈,我们会尽快为您处理(人工客服工作时间：9:00-18:30)。
网店管家对接--当当api
接口设置
商家使用手册
2013年12月
目 录
1背景概述 ....................................................................................................................................... 1
2流程说明 ....................................................................................................................................... 1
2.1查询应用 ............................................................................................................................ 1
2.2提交申请 ............................................................................................................................ 1
2.3等待确认 ............................................................................................................................ 3
2.4应用授权 ............................................................................................................................ 3
商家使用网店管家ERP对接当当接入使用手册
1
1背景概述
目标对象：当当网的商家用户。
使用场景：网店管家在当当服务市场上所发布的应用，没有明确的价格，需
要由商家和网店管家进行线下沟通并完成交易，此时商家可以通过申请“价格面
议”的方式完成交易。当网店管家审核确认交易后，商家就可以授权当当接口的
应用了，可以调用当当网的开放接口来获取店铺运营数据。
2流程说明
2.1查询应用
首先在浏览器地址栏中输入fuwu.dangdang.com，访问当当卖家服务市场。
通过站内搜索 网店管家，如图
2.2提交申请
点击进入应用详情页，仔细阅读应用名称、应用简介和免责声明信息，确认
内容无误后，点击页面中的“现在购买”按钮，进行应用购买申请。
商家使用网店管家ERP对接当当接入使用手册
2
在购买明细页，输入联系电话和商家留言信息，并点击“提交”按钮，则申
请提交成功。（联系电话请您务必填写准确）
在提交成功页面，显示了网店管家的客服电话、客服QQ和客服邮箱等信息，
您也可以选择主动与网店管家进行联系，尽快完成交易。
商家使用网店管家ERP对接当当接入使用手册
3
2.3等待确认
申请提交成功后，联系网店管家客服审核确认
2.4应用授权
网店管家审核后，商家用户自己登录当当商家后台（shopadm.dangdang.com
或shopadm4.dangdang.com）。在左侧导航菜单中选择“服务管理-已购买的服
务”，然后在右侧服务列表中找到网店管家ERP的应用名称。
商家使用网店管家ERP对接当当接入使用手册
4
商家使用网店管家ERP对接当当接入使用手册
5
点击该应用对应的“使用服务”链接，进入应用授权页面，完成对应用的授
权。授权后，会自动生成一串token，填入到网店管家对应的接口软件：专业版
esapi中即可使用了。如有问题，联系网店管家客服。