0.返回字段

字段统一返回为JSON格式!格式如下:
{
"Result":true/false,
"Detail":(错误为错误信息,正确为JSON信息)
}
通用错误返回字符串:
程序类错误:
NOT_FOUND:URL不合法或接口不存在
SERVER_ERROR:服务器错误,程序崩溃
PARAM_ERROR:参数错误,缺少参数或参数格式不正确
DB_ERROR:数据库错误
METHOD_NOT_ALLOW:方法不允许,如不能使用GET方法
用户相关:
USER_NOT_EXISTED:用户不存在
USER_EXISTED:用户已存在
USER_NOT_AVALIABLE:用户被封禁
USER_VERIFIED:用户已验证
NOT_LOGIN:用户未登录
VERIFY_FAILED:验证失败或密码错误
业务预约:
APPOINT_ERROR:预约失败
其他:
UNKNOWN_ERROR:未知错误

1.用户

主URL:/User

①用户注册

URL:/User/Register
方法:POST
参数:username(必选,用户名)、password(必选,密码)、truename(必选,真实姓名)、phone(必选,手机)
注册成功后返回成功字段,然后向用户邮箱发送验证邮件
返回数据字段:
皆为String类型,USER_EXISTED(用户已存在)、REGISTER_SUCCESSED(注册成功)

②用户登录

URL:/User/Login
方法:POST
参数:username(必选,用户名)、password(必选,密码)
返回数据字段:
ID(用户ID)、Email(注册邮箱)、Phone(注册手机)、TrueName(真实姓名)、RegisterDate(注册日期)
同时须接收回传的Session,后面的预约接口会用到以验证用户登录!

③用户验证

功能说明:用于在用户注册以后,验证其邮箱的有效性,并激活账号
URL:/User/Verify
方法:GET/POST
参数:p(必选,验证序列)、id(必选,用户ID)
返回数据字段:(根据通用错误字符串判断)

2.业务预约

主URL:/Appoint
以下接口皆须回传Session

①信用卡预约申请

URL:/Appoint/CreditCard/Apply
方法:POST
参数:id(必选,用户ID)、type(必选,int,信用卡类型)、location(必选,String,预约银行)、date(必选,String,预约日期,格式:yyyy-MM-dd)、period(可选,int,上下午标志,0为上午,1为下午,默认为0)
返回数据字段:(根据通用错误字符串判断)

②理财业务预约申请

URL:/Appoint/Finance/Apply
方法:POST
参数:id(必选,用户ID)、type(必选,int,信用卡类型)、location(必选,String,预约银行)、date(必选,String,预约日期,格式:yyyy-MM-dd)、period(可选,int,上下午标志,0为上午,1为下午,默认为0)
返回数据字段:(根据通用错误字符串判断)

Last edited Nov 20, 2014 at 4:17 AM by yuanguozheng, version 1