Zoho crm Logo

撤销共享记录

目的

要撤销对Zoho CRM中共享记录的访问权限,移除授予用户、群组或角色的共享权限。

端点

  • DELETE /{module_API_name}/{record_ID}/actions/share

请求详情

请求URL

{api-domain}/crm/{version}/{module_API_name}/{record_ID}/actions/share

支持的模块

潜在客户,Account,联系人,交易,活动,案例,解决方案,产品,Vendors,价格表,报价单,Sales Orders,采购Orders,Invoices,以及自定义。

标题

授权: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

范围

ZohoCRM.分享.{module_name}.{operation_type}

可能的模块名称

线索、账户、联系人、交易、活动、案例、解决方案、产品、供应商、价格表、报价单、销售订单、采购订单、发票和自定义。

可能的操作类型

全部 - 完全访问记录
删除 - 撤销访问权限

注意

  • 每次 API 调用只能撤销对一个共享记录的访问权限。

示例请求

Copiedcurl "https://www.zohoapis.com/crm/v8/Contacts/4150868000001148212/actions/share"
-X DELETE
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"
Copiedresponse = invokeurl
[
	url: "https://www.zohoapis.com/crm/v8/Contacts/4150868000001148212/actions/share"
	type: DELETE
	connection:"crm_oauth_connection"
];
info response;

可能的错误

  • INVALID_REQUEST_METHODHTTP 400

    请求方法不正确。
    解决方法:使用 HTTP DELETE 方法来进行此 API 调用。任何其他请求方法都会导致此错误。

  • AUTHORIZATION_FAILEDHTTP 400

    用户没有足够的权限删除记录。
    解决方法:联系您的系统管理员。

  • INVALID_MODULEHTTP 400

    您指定了无效或不支持的模块名称,或者没有标签权限,或者该模块可能已从可用模块中删除。 
    解决方案:指定有效的支持模块 API 名称。

  • INVALID_DATAHTTP 400

    在URL中提供的记录ID无效或不属于提到的模块。
    解决方法:请指定一个有效的记录ID。

  • BAD_REQUESTHTTP 400

    没有可撤销的共享记录。
    解决方案:该记录未与任何用户共享。

  • OAUTH_SCOPE_MISMATCHHTTP 401

    客户端没有权限访问 ZohoCRM.share.{module_name}.DELETE
    (或)
    在 URL 中给出的模块名称是 Events、Calls、Tasks 或任何链接模块。
    (或)
    在 URL 中给出的模块名称无效。
    解决方案: 生成一个具有此 API 所需权限的新访问令牌。请参阅本页开头的 Scope 部分以获取所需权限的列表。

  • NO_PERMISSIONHTTP 403

    无权限删除记录
    解决方案:联系您的系统管理员。

  • INVALID_URL_PATTERNHTTP 404

    请求的URL不正确。
    解决方法:指定一个有效的请求URL。有关详细信息,请参阅本页开头的请求URL部分。

  • INTERNAL_ERRORHTTP 500

    服务器中出现意外且未处理的异常。 
    解决方法:请联系支持团队,邮箱地址为 support@zohocrm.com。

示例响应

Copied{
    "share": {
        "code": "SUCCESS",
        "details": {
            "id": "4150868000001148212"
        },
        "message": "Sharing Revoked",
        "status": "success"
    }
}