客户端请求数据

由于服务器采用JAVA Servlet的Struct框架执行,所有请求均使用*.action方式post加密数据进行访问,返回加密的json数据

请求和程序执行的对应关系来自struct.xml

• 不对业务逻辑产生影响的请求:

  • Login (对应Login.action)
    用户登陆

    请求数据(request):

    {
        Phone:"123456789012",   // 必须
        PwdEnc:"xxxxxxx",       // 必须,加密后的密码
        AppVersion:"0.0.0.0",   // 应用版本号, 非必要
        SyscfgID:-1,            // 系统配置id, 非必要
        Syscfg:""               // 系统配置, 非必要
    }

    返回(response):

    {
        ID:-1,                  // 用户ID
        ErrorCode:-1,           // 错误标号
        SyscfgID:-1,
        Syscfg:""
    }

    如果没有对应的用户,则返回错误

  • CheckUpgrade(对应CheckUpgrade.action)
    检查是否有更新的版本(针对移动端)
    提示是否强制升级

    请求数据(request):

    {
        AppVerion:"0.0.0.0"
    }

    返回(request):

    {
        IsNewest:false,         // 是否最新(通过请求数据中的AppVersion来进行判断)
        MustUpgrade:false,      // 是否必须升级
        AppVersion:"0.0.0.0",   // 当前最新版本号
        AppUrl:"http://...",    // 当前版本的下载地址
        ContantUrl:"http://..." // 
    }

  • Reg(对应Reg.action)
    新用户注册(基本信息)

    请求数据(request):

    {
        Phone:"123456789012",           // 电话号码,必须
        Pwdenc:"xxxxxx",                // 加密后的登陆密码
        UserName:"xxxxxx",              // 用户名
        IDCard:"000000",                // 
        AppVersion:"0.0.0.0",
        WillBePartC:false
    }

    返回(response):

    {
        ID:-1,                  // 用户ID
        ErrorCode:-1,           // 错误标号
        SyscfgID:-1,
        Syscfg:""
    }

    如果用户已经存在, 则ErrorCode=2, 注册失败,如果用户不存在则可以成功注册

  • GetTotalIncome (对应GetTotalIncome.action)

    请求数据(request):

    {
        UID:-1,                     // 用户ID
        KeyWord:""                  // 参数
    }

    返回(response):

    {
        Result:-1,                  
        ErrorCode:-1,
        TotalHour:-1,               // 总小时
        TotalIncome:-1              // 总收入(单位元???)
    }

  • GetUserBaseInfo (对应GetUserBaseInfo.action)

    请求数据(request):

    {
        UID:-1,                     // 用户ID
        KeyWord:""                  // 参数
    }

    返回(response):

    {
        Result:-1,                  
        ErrorCode:-1,
        Phone:"",                   // 电话号码
        UserName:"",                // 用户名称
        IDCard:"",
        CarCode:"",                 // 车牌号码
        Level:0.0,
        WillBePartC:false,
        OwingMoney:0.0,
        OwingComment:"",
        hasautodelrents:0
    }

  • SetUserBaseInfo (对应SetUserBaseInfo.action)

    请求数据(request):

    {
        UID:-1,                     // 用户ID
        WillBePartC:false
    }

    只改变用户WillBePartC的状态
    返回(response):

    {
    Result:-1,
    ErrorCode:-1
    }

  • 修改用户基本信息

    • SetPwd (对应SetPwd.action) 在请求中使用PwdEnc 替换{x}
    • SetIDCard (对应SetIDCard.action) 在请求中使用IDCard 替换{x}

    • SetCarCode (对应SetCarCode.action) 在请求中使用CarCode 替换{x}

      请求数据(request):

      {
          UID:-1,                     // 用户ID
          {x}:"xxxxxx"
      }

      返回(response):

      {
      Result:-1,
      ErrorCode:-1
      }

  • SearchIdleParkingSpaces (对应SearchIdleParkingSpaces.action)
    以当前地图中心位置为圆心搜索周围的已经注册的停车位

    请求数据(request);

    {
        UID:-1,
        MapLatLngNortheast: "xx,yy",          // 地图西北角坐标(左上)
        MapLatLngSouthwest: "xx,yy", // 地图东南角坐标(右下)
        DateRange:"xxxx/xx/xx~yyyy/yy/yy",
        TimeRange:"00:00~12:59",               // 有效时间
        PriceRange:"0~100.00",              // 价格区间
        IsAllCanUse:false           // 
    }

    返回(response):

    {
        Result:-1,
        ErrorCode:-1,
        [
            {
                PID:-1,
                Lat:-1,                     // 维度值 
                Lng:-1,                     // 经度值
                Address:"",
                Spacecode:"",
                RentNum:0,
                PartCUID:-1,
                PartCName:"",
                PartCPhone:""
                Status:0
            },
            ...
        ]
    }

• 影响业务流程的请求: