Zoho crm Logo

更新预约改期历史

目的

更新预约改期的详细信息。

端点

  • PUT /Appointments_Rescheduled_History__s

请求详情

请求 URL

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

标题

授权:Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

范围

scope=ZohoCRM.modules.appointments_rescheduled_history.{operation_type}

可能的操作类型

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

示例请求

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

请求 JSON 键

  • id字符串,必填

    表示需要更新的重新安排历史记录的唯一ID。要获取此ID,请调用 获取预约重新安排历史记录 API。

  • Rescheduled_Time字符串,可选

    表示预约被重新安排的日期和时间。

  • Rescheduled_ByJSON 对象,可选 

    包含重新安排预约的用户姓名和ID。你可以通过 GET Users API 获取用户详细信息。

  • 重新安排_From字符串,可选

    表示预约被重新安排的日期和时间From。

  • Rescheduled_To字符串,可选

    表示预约被重新安排到的日期和时间。

注意

  • 您也可以在请求中传递记录ID。例如: {api-domain}/crm/v6/Appointments_Rescheduled_History__s/{record_id}
  • 每次API调用最多可以更新100条预约重新安排历史记录。
  • 除了 Appointment_Name 键之外,您可以更新添加预约重新安排历史API中所有其他请求 JSON 键。

示例输入

Copied{
    "data": [
        {
            "id": "5545974000002324198", 
            "Rescheduled_By": {
                "name": "Patricia Boyle",
                "id": "5545974000001170042"
            },
            "Rescheduled_From": "2023-04-11T12:30:00+05:30",
            "Rescheduled_To": "2023-04-11T12:45:00+05:30",
            "Rescheduled_Time": "2023-04-07T17:25:13+05:30"
        }
    ]
}

可能的错误

  • INVALID_DATAHTTP 400

    您指定了一个无效的记录ID。
    解决方案:请调用 获取预约重新安排历史 的API,以获取有效的ID。

  • INVALID_DATAHTTP 400

    您在 Rescheduled_By 键中指定了无效的 ID。
    解决方案:请调用 获取预约 API,并提供有效的重新安排用户和预约 ID。

  • INVALID_DATAHTTP 400

    Rescheduled_Time 键的时间大于当前时间。
    解决方案:Rescheduled_Time 的值应小于当前时间。

  • INVALID_MODULEHTTP 400

    您在请求的URL中提供了无效的模块名称。
    解决方案:您只能在请求的URL中使用Appointments_Rescheduled_History__s。

  • INVALID_REQUEST_METHODHTTP 400

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

  • MANDATORY_NOT_FOUNDHTTP 400

    您未指定需要更新的记录ID。
    解决方案:请调用 获取预约重新安排历史 API 以获取有效的ID。

  • INVALID_TOKENHTTP 401

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

  • OAUTH_SCOPE_MISMATCHHTTP 401

    您使用了错误的 oauth 范围创建授权令牌。
    解决方法: 请使用 ZohoCRM.modules.appointments_rescheduled_history.UPDATE 或 ZohoCRM.modules.appointments_rescheduled_history.ALL 范围来创建一个新的有效授权令牌。

  • NO_PERMISSIONHTTP 403

    您没有权限更新任何预约重新安排的历史记录。
    解决方案: 请联系您的系统管理员。

  • INVALID_URL_PATTERNHTTP 404

    请检查您是否正在尝试访问正确的URL。
    解决方案:您提供了一个无效的请求URL。请仅在请求URL中使用/Appointments_Rescheduled_History__s端点。

  • INTERNAL_ERRORHTTP 500

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

示例回复

Copied{
    "data": [
        {
            "code": "SUCCESS",
            "details": {
                "Modified_Time": "2023-04-11T11:25:41+05:30",
                "Modified_By": {
                    "name": "Patricia Boyle",
                    "id": "5545974000000393001"
                },
                "Created_Time": "2023-04-07T17:26:30+05:30",
                "id": "5545974000002324198",
                "Created_By": {
                    "name": "Patricia Boyle",
                    "id": "5545974000000393001"
                }
            },
            "message": "record updated",
            "status": "success"
        }
    ]
}