Zoho crm Logo

删除预约改期历史记录

目的

要从预约改期历史中删除一条记录。

端点

  • DELETE /Appointments_Rescheduled_History__s/{record_id}

请求详情

请求 URL

{api-domain}/crm/{version}/Appointments_Rescheduled_History__s/{record_id}

标题

授权: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

范围

scope=ZohoCRM.modules.appointments_rescheduled_history.{operation_type}

可能的操作类型

ALL- 完全访问预约改期历史数据
Delete - Delete 预约改期历史数据

注意

  • 每次 API 调用只能从预约改期历史中删除一条记录。
  • 当你从组织的回收站中删除该预约时,该预约的所有改期历史记录都会被删除。

示例请求

Copiedcurl "https://www.zohoapis.com/crm/v8/Appointments_Rescheduled_History__s/5545974000002324052"
-X DELETE
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"

可能的错误

  • INVALID_DATAHTTP 400

    您指定的记录 ID 不正确或已被删除。
    解决方案:发起一次 GET 预约重新安排历史 API 调用,并提供有效的记录 ID。

  • INVALID_REQUEST_METHODHTTP 400

    您提供了无效的 HTTP 请求方法类型。
    解决方案:请仅在请求 URL 中使用 DELETE 方法来访问此 API。

  • REQUIRED_PARAM_MISSINGHTTP 400

    您未指定需要删除的记录 ID。
    解决方案:请在请求 URL 中指定一个来自预约改期历史记录的记录 ID。

  • INVALID_TOKENHTTP 401

    您使用了无效的 OAuth 令牌。
    解决方案:您使用的访问令牌已过期。请刷新您的令牌并重试。

  • OAUTH_SCOPE_MISMATCHHTTP 401

    您使用错误的 OAuth 作用域创建了授权码。
    解决方案: 使用 ZohoCRM.modules.appointments_rescheduled_history.DELETE 或 ZohoCRM.modules.appointments_rescheduled_history.ALL 作用域来创建一个新的有效授权码。

  • NO_PERMISSION HTTP 403

    您无权从预约重新安排历史中删除任何记录。
    解决方案:请联系您的系统管理员。

  • INVALID_URL_PATTERN HTTP 404

    请检查您是否正在尝试访问正确的 URL。
    解决方案:您提供的请求 URL 无效。请在请求 URL 中使用 /Appointments_Rescheduled_History__s?ids={record_id} 或 /Appointments_Rescheduled_History__s/{record_id} 端点。

  • INTERNAL_ERROR HTTP 500

    内部服务器错误
    解决方案: 在服务器中出现了意外且未处理的异常。请联系我们的支持团队。

示例回应

Copied{
    "data": [
        {
            "code": "SUCCESS",
            "details": {
                "id": "5545974000002324052"
            },
            "message": "record deleted",
            "status": "success"
        }
    ]
}