更新节日
目的
要更新您组织的假期设置。
端点
- 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"
}
]
}