PHP实例开发源码——BizPower CRM客户管理系统中文版.zip

CRM移动设备接口API调用约定规范 版本1.0 最后编辑时间：2013/06/04 ****************************************** 更新记录： 2013.5.29 #列表类读接口修改成为了按店铺的数据权限方式（会员列表、会员关怀列表、会员跟踪日志、订单列表、订单日志、发货单列表、发货日志、退货单列表、会员列表坐标版） 说明：如果需要进行店铺选择才能显示数据，则接口会返回‘need choose shop’，选择好店铺后在原请求地址后面加上店铺ID参数即可“&shop_id={店铺ID}” #增加了一个店铺列表获取接口，详见48号接口说明 2013.4.12 #新增了会员列表坐标版接口，详见47号接口说明 2013.3.21 #记事本详情添加附件图片列表，记事本编辑接口更新，详见下面接口说明 2013.3.16 ＃记事本新增和编辑增加了上传图片的功能 2013.3.15 ＃会员列表接口增加了几个返回字段 2013.3.13 ＃商品列表接口现在搜索时可以不加classid从而可以在全库中进行商品检索 2013.3.8 ＃列表类接口现在会返回2个字段：count（共有多少条数据）和haveMore（是否有更多数据，有true没有false） 例如：{"code":200,"datas":[{"cm_id":"1","cm_subject":"\u516c\u53f8\u5f00\u5e74\u4f1a","cm_type":"\u4f1a\u8bae","cm_donedate":"1360305000","is_expire":1}],"count":"2","haveMore":"false"} 注意：所有接口都会返回这个2个字段，但一般会为null ＃增加了获取系统数据字典的接口 2013.3.1 ＃增加了员工类统计图表、商品类统计图表、月度类统计图表 2013.2.28 ＃增加了会员类统计图表 2013.2.27 ＃为日程详情接口添加了2个字段；销售机会主题cha_title为空会返回“无” ＃任务详情接口会员和联系人为空现在会返回“无” 2013.2.22 ＃会员列表增加针对会员名称的搜索 ＃订单列表增加针对订单编号的搜索 ＃发货单列表增加针对发货单编号的搜索 ＃收款单列表增加针对收款单编号的搜索 ＃退货单列表增加针对退货单编号的搜索 ＃商品列表增加针对商品名称的搜索 ========================================================================================= 协议解释： CRM端以GET或POST方式请求服务器，服务器以JSON形式返回数据，编码为UTF-8 ＃接口地址为 http://<CRM网站域名>/api/index.php ＃各协议以commend参数为标识 (如请求任务列表的commend值为mlist,完整URL为http://192.168.1.36/crm/index.php?commend=mlist&uid=1&page=1&size=50) ＃返回数据格式定义举例 {"code":200,"datas":[{"cm_id":"1","cm_subject":"\u516c\u53f8\u5f00\u5e74\u4f1a","cm_type":"\u4f1a\u8bae","cm_donedate":"1360305000","is_expire":0}]} code有以下几种状态： 200 代表数据返回正常 404 代表参数错误 500 代表WEB端内部执行异常 ========================================================================================= 详细接口说明： 1.登陆 方式：POST 参数：username（用户名）、password（md5加密过的密码串）、device（移动设备名称） 请求URL：http://<CRM网站域名>/api/index.php?commend=login 返回：A、成功：{"code":200,"datas":{"uid":"1","username":"admin","truename":"\u8d85\u7ea7\u7ba1\u7406\u5458","did":"1"}} B、失败：{"code":200,"datas":"login failed"} 字段说明：uid（员工ID）、username（用户名）、truename（真实姓名）、did（所属部门ID） PS：device移动设备名称列表 安卓设备：android 苹果设备：ios 微软设备：wp 黑莓设备：bb 2.检查未完成任务数量 方式：GET 参数：uid（员工ID） 请求URL：请求URL：http://<CRM网站域名>/api/index.php?commend=mcheck 返回：{"code":200,"datas":1} 字段说明：返回未完成任务数量，int型 3.任务列表 方式：GET 参数：uid（员工ID）、page（页数）、size（单次最大请求数量） 请求URL：http://<CRM网站域名>/api/index.php?commend=mlist 返回：{"code":200,"datas":[{"cm_id":"1","cm_subject":"\u516c\u53f8\u5f00\u5e74\u4f1a","cm_type":"\u4f1a\u8bae","cm_donedate":"1360305000","is_expire":0}]} 字段说明：cm_id（任务ID）、cm_subject（任务标题）、cm_type（任务类型）、cm_donedate（任务计划完成时间）、is_expire（任务是否过期 0未过期1已过期） 4.任务详情 方式：GET 参数：mid（任务ID） 请求URL：http://<CRM网站域名>/api/index.php?commend=mdetail 返回：{"code":200,"datas":{"cm_id":"2","cm_subject":"\u7ed9\u82f9\u679c\u516c\u53f8\u53d1\u9001\u5f8b\u5e08\u51fd","cc_id":"1","cm_chanceid":"0","cm_contact":"1","cm_priority":"3","cm_donedate":"1360135800","cm_excstaff":",3,","cm_status":"1","cm_addstaff":"1","cm_addtime":"1360049869","cm_type":"\u7535\u5b50\u90ae\u4ef6","cm_note":"\u53d1\u9001\u5f8b\u5e08\u51fd\u8bf4\u660e\u4fb5\u6743\u95ee\u9898","cm_attachment":"","cm_dp_id":"1","user_truename":"\u8d85\u7ea7\u7ba1\u7406\u5458","cc_name":"\u7f8e\u56fd\u82f9\u679c\u8ba1\u7b97\u673a\u6709\u9650\u516c\u53f8","ccc_name":"\u8482\u59c6\u5e93\u514b","is_expire":1}} 字段说明：cm_id（任务ID）、cm_subject（任务标题）、cm_type（任务类型）、cm_donedate（任务计划完成时间）、is_expire（任务是否过期 0未过期1已过期）、cc_id（会员ID）、cm_chanceid（销售机会ID）、cm_contact（联系人ID）、cm_priority（任务优先级 1低2中3高）、cm_excstaff（任务执行人ID 以逗号分割）、cm_status（任务状态 1未结束0已结束-1取消）、cm_addstaff（任务添加人ID）、cm_addtime（任务添加时间）、cm_type（任务类型）、cm_note（任务内容）、cm_attachment（任务附件）、cm_dp_id（任务所属部门ID）、user_truename（任务添加人姓名）、cc_name（会员名称）、ccc_name（联系人姓名） 5.日程列表 方式：GET 参数：uid（员工ID）、page（页数）、size（单次最大请求数量） 请求URL：http://<CRM网站域名>/api/index.php?commend=schlist 返回：{"code":200,"datas":[{"cs_id":"1","cs_subject":"\u53bb\u82f9\u679c\u603b\u90e8\u53c2\u89c2","cs_type":"\u4e0a\u95e8\u62dc\u8bbf","cs_start_time":"1360308000","cs_end_time":"1360740600"}]} 字段说明：cs_id（日程ID）、cs_subject（日程标题）、cs_type（日程类型）、cs_start_time（日程起始时间）、cs_end_time（日程结束时间） 6.日程详情 方式：GET 参数：schid（日程ID） 请求URL：http://<CRM网站域名>/api/index.php?commend=schdetail 返回：{"code":200,"datas":{"cs_id":"1","cs_subject":"\u53bb\u82f9\u679c\u603b\u90e8\u53c2\u89c2","cc_id":"1","cs_chanceid":null,"cs_staff_id":"1","cs_addtime":"1360049094","cs_start_time":"1360308000","cs_end_time":"1360740600","cs_note":"\u53c2\u89c2\u82f9\u679c\u4ea7\u54c1\u5f00\u53d1\u90e8","cs_type":"\u4e0a\u95e8\u62dc\u8bbf","cs_dp_id":"1","cc_name":"\u7f8e\u56fd\u82f9\u679c\u8ba1\u7b97\u673a\u6709\u9650\u516c\u53f8","cha_title":"\u65e0","cs_staff_name":"\u8d85\u7ea7\u7ba1\u7406\u5458","cs_dp_name":"\u516c\u53f8"}} 字段说明：cs_id（日程ID）、cs_subject（日程标题）、cs_type（日程类型）、cc_id（会员ID）、cs_chanceid（销售机会ID）、cs_staff_id（所属员工ID）、cs_addtime（日程添加时间）、cs_start_time（日程起始时间）、cs_end_time（日程结束时间）、cs_note（日程内容）、cs_dp_id（所属部门ID）、cc_name（会员名称）、cha_title（销售机会标题）、cs_staff_name（所属员工姓名）、cs_dp_name（所属部门名称） 7.记事本列表 方式：GET 参数：uid（员工ID）、page（页数）、size（单次最大请求数量） 请求URL：http://<CRM网站域名>/api/index.php?commend=nplist 返回：{"code":200,"datas":[{"np_id":"1","np_title":"\u4eca\u5929\u7ed9\u82f9\u679c\u53d1\u4e86\u7535\u5b50\u90ae\u4ef6\u8be2\u95ee\u4ef7\u683c"}]} 字段说明：np_id（记事本ID）、np_ti