app接口文档模板

XXX项目APP接口文档首页.........................................................................................................................................................................................................3首页.................................................................................................................................................................................................3加载更多商品.................................................................................................................................................................................7用户注册.................................................................................................................................................................................................9注册.................................................................................................................................................................................................9发送手机验证码...........................................................................................................................................................................11用户中心...............................................................................................................................................................................................12登录...............................................................................................................................................................................................12登出...............................................................................................................................................................................................14原产品...................................................................................................................................................................................................15产品列表.......................................................................................................................................................................................15产品详情.......................................................................................................................................................................................18分类树...........................................................................................................................................................................................22备注：...................................................................................................................................................................................................23注：传参一律用post方式，key=request,value为一串json格式字符串，格式如：request={head:{partner:xxxxxxxxxxxxxxxxxxxxxxx,key:xxxxxxxxx,mdkey:xxxxxxxxxxx},para:{user_name:user_name,pwd:123456},result:{start:0,count:10}}head：头信息，用于安全校验，参数固定为partner、key、mdkey三项，mdkey随不同接口而变，partner和key为常量头部信息校验错误统一返回，错误码分三种：1：PARTNER有误{head:{code:C0004,msg:PARTNER验证失败！}}2：KEY有误{head:{code:C0005,msg:KEY验证失败！}}3：MD5加密错误{head:{code:C0001,msg:请求验证失败！}}para：请求体，客户端请求所需要传入的参数，依据不同接口而定result：结果集，主要用于分页首页首页URL：输入参数：request={head:{partner:77b872abfe1260053032219354882d91,key:ldingadmin,mdkey:md5(partner+key)},result:{start:0,//从第0条数据开始，（首页此项参数只能为0）count:20//总共返回20条数据，（即每页显示数量，由客户端自定）}}输入参数说明：参数参数明细类型（长度范围）参数说明是否可空样例headpartnerString合作者ID不可空a4bf5363f7bd76c5a4975b75f19f63cakeyString合作者KEY不可空ldingadminmdkeyStringMD5加密字符md5(partner+key)不可空a4bf5363f7bd76c5a4975b75f19f63caresultstartInt分页数据开始标示id可空（固定为0）0countInt返回总数据条数可空（为空时采用系统默认值20）20返回码描述：错误码：参考头部信息校验统一错误码正确返回：{head:{code:10000,msg:数据获取成功},para:{banner:[{ad_id:2,ad_name:首页轮转2,pic::=search&act=products&cid=1312,image_size:{width:1200,height:475}},{ad_id:3,ad_name:首页轮转3,pic:::{width:1200,height:475}}……],cate:[{cate_id:1216,cate_name:女装,cate_ename:WOMEN,cate_banner::{width:460,height:300}},{cate_id:1217,cate_name:男装,cate_ename:MEN,cate_banner::{width:460,height:300}}……],pic:[{pic_id:311,pic_name:小女孩·柠檬汽水,price:25.00,pic_url::1,views:0,sales:0,image_size:{width:2063,height:2063},love:true//是否关注，true已关注，false未关注},{pic_id:314,pic_name:小女孩·漫漫花事,price:35.00,pic_url::1,views:0,sales:0,image_size:{width:2244,height:3488},love:false}……],products:[{product_id:176,product_name:三脚猫原创手工皮革染色单肩包手工定制,price:400.00,image_url::1,views:0,sales: