Zoho crm Logo

更新节日

目的

要更新您组织的假期设置。

端点

  • PUT /settings/holidays
  • PUT /settings/holidays/{holiday_ID}

请求详情

请求 URLs

{api-domain}/crm/{version}/settings/holidays

标题

授权:Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
X-CRM-ORG:{your_org_id}

范围

scope=ZohoCRM.settings.business_hours.ALL(全部)
(或)
scope=ZohoCRM.settings.business_hours.UPDATE(更新)

样本请求

Copiedcurl "https://www.zohoapis.com/crm/v8/settings/holidays"
-X PUT
-d "@update.json"
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"
-H "X-CRM-ORG:{your_org_id}"

输入 JSON

  • id字符串,必填

    要更新的假期的唯一ID。请使用获取假期 API来检索假期ID。

  • name字符串,必填

    假期名称。请注意,不允许使用特殊字符 ~ 、` 、# 、% 、& 、+ 、= 、[ 、] 、{ 、} 、| 、; 、< 、> 、^。

  • date字符串,必填

    假期的日期,格式为YYYY-MM-DD。

注意

每次 API 调用最多可以更新 100 个假期。

输入 JSON

Copied{
    "holidays": [
        {
            "id": "3652397000011199002",
            "name": "Founder's Day",
            "date": "2023-08-24"
        }
    ]
}

可能的错误

  • INVALID_DATAHTTP 400

    原因:

    • 节假日名称包含以下一个或多个特殊字符:~ 、` 、# 、% 、& 、+ 、= 、[ 、] 、{ 、} 、| 、; 、< 、> 、^。
    • 日期、班次ID、节假日类型或名称无效。

    解决方法:
    请参考响应中的“details”键,获取输入中出错字段的 API 名称。

  • MANDATORY_NOT_FOUNDHTTP 400

    以下一项或多项数据无效 - 姓名、日期、类型。

    解决方法:
    请参阅响应中的 "details" 键,以获取输入中出错字段的 API 名称。

  • DEPENDENT_FIELD_MISSINGHTTP 400

    您尚未指定一个或多个依赖字段。
    解决方法: 当您向轮班时间添加节假日时,"type" 键为必填项。

  • API_NOT_SUPPORTEDHTTP 400

    您正在尝试使用 API 版本 2 或更低版本的 API。
    解决方法:此 API 仅支持从 API 版本 2.1 及以上版本。

  • LIMIT_EXCEEDEDHTTP 400

    您试图在一年内创建超过52个假期。
    解决方法:一年内最多只能有52个假期。

  • OAUTH_SCOPE_MISMATCHHTTP 401

    您没有访问此 API 的权限范围。
    解决方法: 使用 Zoho CRM .settings.business_hours.ALL 或 Zoho CRM .settings.business_hours.UPDATE 权限范围创建新令牌。

  • INACTIVE_USER HTTP 403

    你是组织中的非活跃US用户。
    解决办法:非活跃US用户无法访问此API。请联系管理员。

  • NO_PERMISSIONHTTP 403

    您不是管理员。
    解决方案:只有管理员用户才能为组织设置假期。

  • INVALID_URL_PATTERNHTTP 404

    请检查您尝试访问的URL是否正确
    解决方法:请求的URL不正确。请指定有效的请求URL。请参阅上方请求URL部分。

样本回复

Copied{
    "holidays": [
        {
            "code": "SUCCESS",
            "details": {
                "id": "3652397000011199002"
            },
            "message": "Holidays updated successfully",
            "status": "success"
        }
    ]
}