删除服务
目的
删除您的组织中的现有服务。
端点
- DELETE /Services__s?ids={service_ID1,service_ID2,...service_ID100}
- DELETE /Services__s/{service_id}
Request 详情
Request URL
{api-domain}/crm/{version}/Services__s?ids={service_id1,service_id2,...service_id100}
To delete a specific service:
{api-domain}/crm/{version}/Services__s/{service_id}
标题
授权:Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
范围
scope=ZohoCRM.modules.services.{operation_type}
可能的操作类型
ALL - Full access to services data
DELETE - Delete services data
参数
- ids字符串,必填(仅在删除多个服务时)
指定需要删除的服务的独特ID。
您可以从GET 服务API获取服务ID。
注意
- 您每次API调用最多可以删除100个服务。
- 与被删除服务相关的所有预约默认会被删除。
- 在被删除服务下完成预约创建的交易不会被删除。
样本请求
可能的错误
- INVALID_DATAHTTP 400
请求URL中给出的服务ID要么不正确,要么已被删除。
解决方案:进行GET Services 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.services.Delete或ZohoCRM.modules.services.ALL范围来创建一个新的有效令牌。 - NO_PERMISSIONHTTP 403
您没有权限删除任何服务。
解决方案:联系您的系统管理员。 - INVALID_URL_PATTERNHTTP 404
检查您是否正在尝试访问正确的URL。
解决方案:您提供了一个无效的请求URL。请使用/Services__s?ids={service_id1,service_id2,...service_id100} 或 /Services__s/{service_id} 端点来提供有效的URL。 - INTERNAL_ERRORHTTP 500
内部服务器错误
解决方案:服务器中出现意外且未处理的异常。请联系我们的支持团队。