沃土开放平台

API文档 > 照片管理类 > 注册任务状态查询接口
URL:http://gs-api.uface.uni-ubi.com/v1/{appId}/person/{personGuid}/device/{deviceKey}/registeration/state/{taskId},method:GET
  • 发送人员编号、设备序列号和任务id至云端,可查询此任务id对应的任务状态进行到哪一步
  • 设备开启拍照注册模式后,任务步骤先后有:任务创建、进入拍照模式并开启摄像头、准备就绪可开始拍照、拍完照任务完

查询该设备上的某次拍照任务的进度

  • 任务状态state为2:准备就绪,指设备可进行拍照
  • 任务状态state为3:开启失败,指某种异常导致无法进入拍照模式
  • 任务状态state为4:任务完成,指此次拍照任务结束
  • 任务状态state为5:任务过期,指拍摄照片超时
  • 任务状态state为6:任务失败,指拍摄未顺利完成
字段 描述 类型 必传 说明
appId 应用Id String Y
token 调用接口凭证 String Y
personGuid 人员id String Y
deviceKey 设备序列号 String Y
taskId 任务id String Y
{
	"code": "GS_SUS210",//人员查询注册状态接口调用成功  
	"msg": "success",
	"data": 1;//state 1.任务创建2.准备就绪3.开启失败4.任务完成5.任务过期6.任务失败
	"result": 1
}
state名称 设备状态state 照片在设备上的注册状态state (拍照)注册任务状态state
state说明 1:未绑定,设备-appId绑定关系
2:绑定中,设备与云端确认通信中
3:解绑中,设备删除中,与appId解绑中
4:未同步,云端数据未同步至设备
5:同步中,云端数据正在同步至设备
6:已同步,云端数据已同步至设备
7:已禁用,设备不可被使用
8:禁用中,设备正在“禁用”过程中
9:启用中,设备正在“启用”过程中
1:已上传
2:注册中
3:注册成功
4:注册失败
1:任务创建
2:准备就绪
3:开启失败
4:任务完成
5:任务过期
6:任务失败
出现接口名称
  • 设备查询
  • 设备列表查询
人员照片状态查询
  • 注册任务状态查询
  • 注册任务状态变更