沃土开放平台

SDK > JAVA-SDK > 概述与指导
1、沃土SDK概述
沃土SDK是杭州宇泛智能科技有限公司,围绕设备管理、人员管理、照片管理、照片下发等诸多宇泛无场景应用相关的核心业务,提供统一的对外服务接口,供宇泛智能客户接入具体应用场景时调用,便捷完成对接任务,无需手动操作,加快开发周期的服务。
2、下载
3、开发概述
  • 联系宇泛运营人员开设沃土应用,并提供用于SDK开发所需的appId,appKey与appSecret。
  • 利用提供的appId,appKey与appSecret生成调用SDK方法所需的token。(SDK已内部实现)
  • 参照具体SDK文档格式调用,比较返回响应码,确认是否调用成功。
4、token说明
宇泛运营人员会提供给第三方对接所需的appId,appKey和appSecret。此三个参数为生成token的关键所在。只有通过此三个参数生成的token去调用SDK方法才能通过沃土平台验证操作,因为第三方对接方需谨慎保管秘钥,以防外泄。
Demo
Java版本
public class  Main{
    public static void main(String[] args){
       AppAuthParam appAuthParam = new AppAuthParam("appKey","appSecret","appId");
       TokenFetcher.init(appAuthParam);
        // 此初始化行为主要是为了获取权限相关的信息,如不使用
       // BaseAuthRemoteService(下文将会提到)的子类,可以不进行此权限信息初始化
       // 生产环境下可以将init的行为配置到spring的容器中来进行初始化
       // 初始化成功后,接下来每次调用业务方法,都会自动为发起的请求附上相应的权限信息,而无需手工传入
        RDeviceService deviceService = new DeviceService();
        ContentResult<DeviceSetting> setting = deviceService.getSetting("deviceKey");//原接口需要显示传入权限凭证,而这里不用
        //应用结束时调用,关闭定时自动获取token的线程池,如webApp关闭时
        TokenFetcher.shutdown();
    }
}
5、方法调用说明
方法调用说明
SDK文档共提供4个模块的方法。
  • RDeviceOperationService 设备操作
  • RDeviceService 设备交互
  • RFaceService 人脸照片交互
  • RPersonService 人员交互
  • RDevicePersonCookieService 人员设备信息交互
//返回数据示例
{
"result": 1,
"code": "EXP-FACE-0",
"msg":"照片格式错误",
"data",""
}
参数 描述 说明
result 处理结果 1成功,0失败
code 返回码 接口统一定义的成功/错误类型码
msg 返回信息 接口返回的信息,通常是错误类型码的原因信息
data 返回数据 返回的业务数据,类型可为数值、字符串或集合等