Zoho crm Logo

删除服务

目的

删除您的组织中的现有服务。

端点

  • 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

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

样本回应