跳转至

任务服务

TaskService 是管理任务的服务。

iPaaS 的整体服务设计为幂等。在发起任务时,客户端可以提供一个客户端令牌以确保请求的幂等性。如果客户端没有提供客户端令牌,服务将生成一个随机令牌以确保幂等性。

一般来说,如果你请求的接口包含 client_task_token 字段,则这个接口便是一个发起任务的接口。可以使用本服务查询任务的处理结果。

如果接口名不包含 Async,是同步接口,在调用会立即返回任务的处理结果。如果你没能收到响应,可以通过 GetTaskResult 再次查询结果。

如果接口名包含 Async,是异步接口,在调用会返回任务的 ID。你可以稍后通过 GetTaskResult 查询任务的处理结果。

任务有时效性。在任务创建一段时间(7 天)后,将无法再查询到任务结果。

当任务过期后,再次使用同一 client_task_token 发起任务时,将视为新任务(原先的已经过期)。

因此,你应该在任务完成后尽快查询任务的处理结果,并且不要重用 client_task_token

请参考 API 文档 以获取接口细节。