Signal-CLI-REST-API 中的群组消息过期时间功能解析

Signal-CLI-REST-API 项目近期新增了对群组消息过期时间（expiration_time）的支持，这是一个值得关注的功能更新。本文将深入解析这一功能的实现细节和使用方法。

功能背景

消息自动销毁（Disappearing Messages）是Signal应用中的一项隐私保护功能，允许用户设置消息在特定时间后自动删除。在Signal-CLI-REST-API中，最初这一功能仅支持在创建群组时设置，而现在已扩展到支持对现有群组的更新操作。

技术实现

项目通过以下方式实现了这一功能：

1. 在创建群组（create group）端点中增加了expiration_time参数
2. 随后在更新群组（update group）端点中也加入了相同参数
3. 参数值为以秒为单位的整数，表示消息保留时间

使用方法

要设置或修改群组的消息过期时间，可以使用以下REST API调用：

PUT /v1/groups/{number}/{group_id}
Content-Type: application/json

{
  "expiration_time": 3600
}

其中3600表示消息将在1小时（3600秒）后自动删除。若要禁用该功能，可将值设为0。

注意事项

1. 该功能需要Signal-CLI-REST-API的0.173-dev或更高版本
2. 群组列表和详情API目前尚未返回expiration_time信息
3. 更新操作需要管理员权限

最佳实践

建议开发者在实现该功能时：

1. 在前端界面中提供常见时间选项（如1小时、1天、1周等）
2. 添加明确的说明文字，告知用户此功能的作用
3. 考虑添加确认步骤，防止误操作
4. 在设置成功后给予用户反馈

这一功能的加入使得Signal-CLI-REST-API在群组管理方面更加完善，为开发者提供了更多隐私保护的选择。