何时使用
常见输入来自:1. 收集 Personnel ID
sourceType 数组和 Event ID。只提交仍处于锁定状态的人员。
2. 创建解锁任务
2000 个 Personnel ID。event_id 可省略;省略时服务不会校验人员是否属于某个展会。
task_id,后续轮询需要使用该值。
3. 轮询任务
4. 处理结果
- 任务仍在进行:继续按退避策略轮询。
- 任务完成:检查每一项结果。只有状态已解锁且确实返回邮箱时,才计为交付成功。
- 任务失败:展示错误,让用户决定是否重试。
404 Not Found:任务 ID 无效或当前 API Key 无权查看。
Credits
邮箱解锁当前对每个可计费联系人消耗15 Credits:
- 已解锁联系人不会重复计费。
- 超过
2000个 Personnel ID 的批次会返回422 Unprocessable Entity。 - 余额不足返回
402 Payment Required。 - 接口响应和商业协议是最终计费依据。
推荐集成行为
- 创建任务前展示锁定联系人数量。
- 大批次前调用
GET /external/credits/balance。 - 保存任务 ID,让轮询可以在中断后恢复。
- 对
429 Too Many Requests使用退避。 - 任务完成后按需重新获取余额和 Personnel/Contact 状态。