沃土开放平台

API文档 > 照片管理类 > 注册任务状态变更接口
URL:http://gs-api.uface.uni-ubi.com/v1/{appId}/person/{personGuid}/device/{deviceKey}/registeration/state/{taskId},method:PUT

发送人员编号、设备序列号和任务id及state至云端,可更改此任务id对应的任务状态进度,例如:将任务状态更改为state2:准备就绪,能重新进行所有照片的拍摄

需要更改任务状态,如取消任务,可更改为state5:任务过期;结束此次任务,可更改为state4:任务完成或state5:任务失败

  • 任务已经完成/失败则不能更改状态
  • "code": "GS_SUS211",//注册任务状态变更接口调用成功,无论设备是否在线,任务状态进行变更,若设备在线,则设备响应变更的状态
字段 描述 类型 必传 说明
appId 应用Id String Y
token 调用接口凭证 String Y
state 状态 Int Y
personGuid 人员id String Y
deviceKey 设备序列号 String Y
taskId 任务id String Y
{
	"code": "GS_SUS211",//注册任务状态变更接口调用成功
	"msg": "success",
	"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:任务失败
出现接口名称
  • 设备查询
  • 设备列表查询
人员照片状态查询
  • 注册任务状态查询
  • 注册任务状态变更