联系人已删除 Webhook 示例

​

功能简介

​

准备工作

• 在您的应用程序中创建一个公开的 HTTPS 端点。
• 为您所需的事件类型配置 YCloud Webhook 端点。
• 安全存储端点签名密钥。
• 确保事件处理具备幂等性。

​

工作原理

​

请求

​

响应

HTTP/1.1 200 OK

• Webhook 端点 URL 应由您的服务器提供，而非 YCloud。 请务必将该 URL 替换为您实际的 Webhook 端点 URL。
• 请确保您的 Webhook 端点正在监听相应的事件类型。 另请参阅 配置 Webhook、获取 Webhook 端点 API。

​

联系人已删除基础示例

​

请求

{
  "id": "evt_3456789012",
  "type": "contact.deleted",
  "apiVersion": "v2",
  "createTime": "2024-01-01T12:00:00.000Z",
  "contactDeleted": {
    "id": "1824266594102064128",
    "nickName": "John Doe",
    "phoneNumber": "+16315551111",
    "updateTime": "2024-01-01T12:00:00.000Z"
  }
}

​

响应

HTTP/1.1 200 OK

​

说明

• 最简信息：contactDeleted 对象仅包含基本信息：id、nickName、phoneNumber 和 updateTime。
• Null 值：如果联系人未设置昵称，则 nickName 字段可能为 null。
• 更新时间：updateTime 反映了联系人在删除前的最后修改时间。
• 联系人 ID：id 字段包含已删除联系人的唯一标识符，以供参考。
• 电话号码：phoneNumber 始终存在并采用 E.164 格式。