Yousign API技术问询：如何判断签署流程已完全完成？

针对你在入职流程中遇到的Yousign签署状态查询问题，这里有几个可行的解决方案：

方案1：手动创建流程时同步保存流程ID #

你当前是从Yousign UI手动创建签署流程，复制签名链接的同时，可以在流程详情页面找到对应的流程ID（格式类似proc_xxxxxx），把流程ID和签名链接一起存储到用户账户中。后续需要检查状态时，直接调用GET /procedures/{procedureId}接口就能获取完整的流程状态，判断是否已完成签署。

方案2：配置Webhook接收状态变更通知 #

Yousign支持Webhook机制，你可以在后台配置监听procedure.completed事件：

• 当签署流程完成时，Yousign会主动向你指定的后端接口发送通知
• 创建流程时，可添加自定义元数据（比如绑定用户ID），这样Webhook通知中会携带该元数据，方便你直接关联到对应的用户账户
• 后端收到通知后，更新用户的签署状态标记，模态框关闭时直接读取本地存储的状态即可，无需主动调用API查询

方案3：通过流程列表接口过滤关联流程 #

如果暂时无法修改存储逻辑，可尝试调用GET /procedures接口并添加过滤参数，筛选包含目标成员ID的流程。例如使用过滤条件members=/members/a8xxxxxx（具体参数格式参考Yousign API文档），不过这种方法可能存在效率问题，若该成员关联多个流程，还需要额外判断哪个是目标入职流程，优先级低于前两个方案。

内容的提问来源于stack exchange，提问作者maxime