添加假期
目的
每个企业都有自己的假期,包括国家假期和特定于企业或地区的假期。使用此API将假期添加到您的组织中。
端点
- POST /settings/holidays
Request 详细信息
Request URL
{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.CREATE
样本请求
输入 JSON
- name字符串,必填
假期的名称。请注意,特殊字符~ , ` , # , % , & , + , = , [ , ] , { , } , | , ; , < , > , ^是不允许的。
- date字符串,必填
假期日期,格式为YYYY-MM-DD。
- type字符串,必填
假期类型。可能的值有shift_holiday和business_holiday。默认值是business_holiday。
- shift_hour字符串,当type=shift_holiday时必填
你想要将此假期关联的班次小时的唯一ID。使用获取班次小时API来获取ID。
输入JSON
可能的错误
- 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。
解决方案:使用ZohoCRM.settings.business_hours.ALL或ZohoCRM.settings.business_hours.CREATE范围创建新的令牌。 - INACTIVE_USERHTTP 403
您是组织中的非活跃用户。
解决方案:非活跃用户无法访问此API。请联系管理员。 - NO_PERMISSIONHTTP 403
您不是管理员。
解决方案:只有管理员用户可以为组织设置假期。 - INVALID_URL_PATTERNHTTP 404
请检查尝试访问的URL是否正确
解决方案:指定的请求URL不正确。请指定一个有效的请求URL。请参考上面的请求URL部分。