任务服务
TaskService 是管理任务的服务。
iPaaS 的整体服务设计为幂等。在发起任务时,客户端可以提供一个客户端令牌以确保请求的幂等性。如果客户端没有提供客户端令牌,服务将生成一个随机令牌以确保幂等性。
一般来说,如果你请求的接口包含 client_task_token
字段,则这个接口便是一个发起任务的接口。可以使用本服务查询任务的处理结果。
如果接口名不包含 Async
,是同步接口,在调用会立即返回任务的处理结果。如果你没能收到响应,可以通过 GetTaskResult
再次查询结果。
如果接口名包含 Async
,是异步接口,在调用会返回任务的 ID。你可以稍后通过 GetTaskResult
查询任务的处理结果。
任务有时效性。在任务创建一段时间(7 天)后,将无法再查询到任务结果。
当任务过期后,再次使用同一 client_task_token
发起任务时,将视为新任务(原先的已经过期)。
因此,你应该在任务完成后尽快查询任务的处理结果,并且不要重用 client_task_token
。
请参考 API 文档 以获取接口细节。