REST API 文档

  • 插入子表单
  • 插入客户
  • 插入联系人
  • 插入服务支持
  • 插入任务
  • 插入活动
  • 插入线索
  • 插入商机
  • 插入产品
  • 插入市场活动
  • 插入解决方案
  • 插入供货商
  • 插入价格表
  • 插入报价
  • 插入销售订单
  • 插入采购订单
  • 插入发货单
  • 插入通话
  • 插入备注并关联到主模块
+
    • 插入记录 - 示例
      • 插入子表单
      • 插入客户
      • 插入联系人
      • 插入服务支持
      • 插入任务
      • 插入活动
      • 插入线索
      • 插入商机
      • 插入产品
      • 插入市场活动
      • 插入解决方案
      • 插入供货商
      • 插入价格表
      • 插入报价
      • 插入销售订单
      • 插入采购订单
      • 插入发货单
      • 插入通话
      • 插入备注并关联到主模块

插入记录 - 示例

插入子表单

用途

在模块的子表单中插入新的记录

请求 URL

https://www.zohoapis.com.cn/crm/v2/Leads

请求方法

POST

样本请求:

curl "https://www.zohoapis.com.cn/crm/v2/Leads"

-H "Authorization: Zoho-oauthtoken d92d401c803988c5cb849d0b4215f52"

-d "@newaccount.json"

-X POST

复制样本输入

样本输入:

备注:

要添加多个子表单,请按照下列格式提供输入数据:
{
   “data”: [
      {....
        Subform_1:[
          {sub_form_data},
        ],...
      },
      {....
        Subform_2:[
          {sub_form_data},
        ],...
      }
   ]
}

  • 每个批量操作允许最多插入2000个子表单。
复制样本响应

样本响应:

备注

  • 如果在子表单属性中没有给定的JSON对象,那么这个子表单将被删除。
  • 插入客户

    用途

    在客户模块中插入一个新的记录

    请求 URL

    https://www.zohoapis.com.cn/crm/v2/Accounts

    请求方法

    POST

    样本请求:

    curl "https://www.zohoapis.com.cn/crm/v2/Accounts"

    -H "Authorization: Zoho-oauthtoken d92d401c803988c5cb849d0b4215f52"

    -d "@newaccount.json"

    -X POST

    复制样本输入

    样本输入:

    备注:

    要添加多个记录,请按照下列格式提供输入数据:
    {
       “data”: [
          {
          {record_data}
          },
          {
          {record_data}
          }
       ]
    }

    复制样本响应

    样本响应:

    备注

    属性modified_timecreated_time应该遵循 ISO8601 格式。例如: 2017-08-16T14:32:23+05:30

    只有属性 date 可以使用普通格式。例如:2017-08-16

    插入联系人

    用途

    在联系人模块中插入一个新的记录

    请求 URL

    https://www.zohoapis.com.cn/crm/v2/Contacts

    请求方法

    POST

    样本请求:

    curl "https://www.zohoapis.com.cn/crm/v2/Contacts"

    -H "Authorization: Zoho-oauthtoken d92d401c803988c5cb849d0b4215f52"

    -d "@newcontact.json"

    -X POST

    复制样本输入

    样本输入:

    备注:

    要添加多个记录,请按照下列格式提供输入数据:
    {
       “data”: [
          {
          {record_data}
          },
          {
          {record_data}
          }
       ]
    }

    复制样本响应

    样本响应:

    插入服务支持

    用途

    在服务支持模块中插入一个新记录

    请求 URL

    https://www.zohoapis.com.cn/crm/v2/Cases

    请求方法

    POST

    样本请求:

    curl "https://www.zohoapis.com.cn/crm/v2/Cases"

    -H "Authorization: Zoho-oauthtoken d92d401c803988c5cb849d0b4215f52"

    -d "@newcase.json"

    -X POST

    复制样本输入

    样本输入:

    备注:

    字段 Deal_Name 指的是商机 ID,而字段 Related_To 指的是联系人 ID。

    要添加多个记录,请按照下列格式提供输入数据:
    {
       “data”: [
          {
          {record_data}
          },
          {
          {record_data}
          }
       ]
    }

    复制样本响应

    样本响应:

    插入任务

    用途

    在任务模块中插入一个新的记录

    请求 URL

    https://www.zohoapis.com.cn/crm/v2/Tasks

    请求方法

    POST

    样本请求:

    curl "https://www.zohoapis.com.cn/crm/v2/Tasks"

    -H "Authorization: Zoho-oauthtoken d92d401c803988c5cb849d0b4215f52"

    -d "@newtask.json"

    -X POST

    复制样本输入

    样本输入:

    备注:

    • 要添加多个记录,请按照下列格式提供输入数据:
      {
         “data”: [
            {
            {record_data}
            },
            {
            {record_data}
            }
         ]
      }
    • Who_Id - 与任务相关联的联系人 ID 。
    • $se_module - 与任务相关联的记录的模块 API 名称。
    • What_Id - 与任务相关的记录 ID。

    备注:

    • 除了联系人模块的记录之外,还需要 $semodule 和 whatid 来将任务与任何CRM记录联系起来。
    复制样本响应

    样本响应:

    插入活动

    用途

    在活动模块中插入一个新的记录

    请求 URL

    https://www.zohoapis.com.cn/crm/v2/Events

    请求方法

    POST

    样本请求:

    curl "https://www.zohoapis.com.cn/crm/v2/Events"

    -H "Authorization: Zoho-oauthtoken d92d401c803988c5cb849d0b4215f52"

    -d "@newevent.json"

    -X POST

    复制样本输入

    样本输入:

    备注:

    要添加多个记录,请按照下列格式提供输入数据:
    {
       “data”: [
          {
          {record_data}
          },
          {
          {record_data}
          }
       ]
    }

    复制样本响应

    样本响应:

    插入线索

    用途

    在线索模块中插入一个新的记录

    请求 URL

    https://www.zohoapis.com.cn/crm/v2/Leads

    请求方法

    POST

    样本请求:

    curl "https://www.zohoapis.com.cn/crm/v2/Leads"

    -H "Authorization: Zoho-oauthtoken d92d401c803988c5cb849d0b4215f52"

    -d "@newlead.json"

    -X POST

    复制样本输入

    样本输入:

    备注:

    要添加多个记录,请按照下列格式提供输入数据:
    {
       “data”: [
          {
          {record_data}
          },
          {
          {record_data}
          }
       ]
    }

    复制样本响应

    样本响应:

    插入商机

    用途

    在商机模块中插入一个新记录

    请求 URL

    https://www.zohoapis.com.cn/crm/v2/Deals

    请求方法

    POST

    样本请求:

    curl "https://www.zohoapis.com.cn/crm/v2/Leads"

    -H "Authorization: Zoho-oauthtoken d92d401c803988c5cb849d0b4215f52"

    -d "@newdeal.json"

    -X POST

    复制样本输入

    样本输入:

    备注:

    要添加多个记录,请按照下列格式提供输入数据:
    {
       “data”: [
          {
          {record_data}
          },
          {
          {record_data}
          }
       ]
    }

    复制样本响应

    样本响应:

    插入产品

    用途

    在产品模块中插入一个新的记录

    请求 URL

    https://www.zohoapis.com.cn/crm/v2/Products

    请求方法

    POST

    样本请求:

    curl "https://www.zohoapis.com.cn/crm/v2/Products"

    -H "Authorization: Zoho-oauthtoken d92d401c803988c5cb849d0b4215f52"

    -d "@newproduct.json"

    -X POST

    复制样本输入

    样本输入:

    备注:

    要添加多个记录,请按照下列格式提供输入数据:
    {
       “data”: [
          {
          {record_data}
          },
          {
          {record_data}
          }
       ]
    }

    复制样本响应

    样本响应:

    插入市场活动

    用途

    在市场活动模块中插入一个新的记录

    请求 URL

    https://www.zohoapis.com.cn/crm/v2/Campaigns

    请求方法

    POST

    样本请求:

    curl "https://www.zohoapis.com.cn/crm/v2/Campaigns"

    -H "Authorization: Zoho-oauthtoken d92d401c803988c5cb849d0b4215f52"

    -d "@newcampaign.json"

    -X POST

    复制样本输入

    样本输入:

    备注:

    要添加多个记录,请按照下列格式提供输入数据:
    {
       “data”: [
          {
          {record_data}
          },
          {
          {record_data}
          }
       ]
    }

    复制样本响应

    样本响应:

    插入解决方案

    用途

    在解决方案模块中插入一个新的记录

    请求 URL

    https://www.zohoapis.com.cn/crm/v2/Solutions

    请求方法

    POST

    样本请求:

    curl "https://www.zohoapis.com.cn/crm/v2/Solutions"

    -H "Authorization: Zoho-oauthtoken d92d401c803988c5cb849d0b4215f52"

    -d "@newsolution.json"

    -X POST

    复制样本输入

    样本输入:

    备注:

    要添加多个记录,请按照下列格式提供输入数据:
    {
       “data”: [
          {
          {record_data}
          },
          {
          {record_data}
          }
       ]
    }

    复制样本响应

    样本响应:

    插入供货商

    用途

    在供货商模块中插入一个新的记录

    请求 URL

    https://www.zohoapis.com.cn/crm/v2/Vendors

    请求方法

    POST

    样本请求:

    curl "https://www.zohoapis.com.cn/crm/v2/Vendors"

    -H "Authorization: Zoho-oauthtoken d92d401c803988c5cb849d0b4215f52"

    -d "@newvendor.json"

    -X POST

    复制样本输入

    样本输入:

    备注:

    要添加多个记录,请按照下列格式提供输入数据:
    {
       “data”: [
          {
          {record_data}
          },
          {
          {record_data}
          }
       ]
    }

    复制样本响应

    样本响应:

    插入价格表

    用途

    在价格表模块中插入一个新记录

    请求 URL

    https://www.zohoapis.com.cn/crm/v2/Price_Books

    请求方法

    POST

    样本请求:

    curl "https://www.zohoapis.com.cn/crm/v2/Price_Books"

    -H "Authorization: Zoho-oauthtoken d92d401c803988c5cb849d0b4215f52"

    -d "@newpricebook.json"

    -X POST

    复制样本输入

    样本输入:

    备注:

    要添加多个记录,请按照下列格式提供输入数据:
    {
       “data”: [
          {
          {record_data}
          },
          {
          {record_data}
          }
       ]
    }

    复制样本响应

    样本响应:

    插入报价

    用途

    在报价模块中插入一个新的记录

    请求 URL

    https://www.zohoapis.com.cn/crm/v2/Quotes

    请求方法

    POST

    样本请求:

    curl "https://www.zohoapis.com.cn/crm/v2/Quotes"

    -H "Authorization: Zoho-oauthtoken d92d401c803988c5cb849d0b4215f52"

    -d "@newquote.json"

    -X POST

    复制样本输入

    样本输入:

    备注:

    要添加多个记录,请按照下列格式提供输入数据:
    {
       “data”: [
          {
          {record_data}
          },
          {
          {record_data}
          }
       ]
    }

    复制样本响应

    样本响应:

    插入销售订单

    用途

    在销售订单模块中插入一个新记录

    请求 URL

    https://www.zohoapis.com.cn/crm/v2/Sales_Orders

    请求方法

    POST

    样本请求:

    curl "https://www.zohoapis.com.cn/crm/v2/Sales_Orders"

    -H "Authorization: Zoho-oauthtoken d92d401c803988c5cb849d0b4215f52"

    -d "@newsalesorder.json"

    -X POST

    复制样本输入

    样本输入:

    备注:

    要添加多个记录,请按照下列格式提供输入数据:
    {
       “data”: [
          {
          {record_data}
          },
          {
          {record_data}
          }
       ]
    }

    复制样本响应

    样本响应:

    插入采购订单

    用途

    在采购订单模块中插入一个新记录

    请求 URL

    https://www.zohoapis.com.cn/crm/v2/Purchase_Orders

    请求方法

    POST

    样本请求:

    curl "https://www.zohoapis.com.cn/crm/v2/Purchase_Orders"

    -H "Authorization: Zoho-oauthtoken d92d401c803988c5cb849d0b4215f52"

    -d "@newpurchaseorder.json"

    -X POST

    复制样本输入

    样本输入:

    备注:

    要添加多个记录,请按照下列格式提供输入数据:
    {
       “data”: [
          {
          {record_data}
          },
          {
          {record_data}
          }
       ]
    }

    复制样本响应

    样本响应:

    插入发货单

    用途

    在发货单模块中插入一个新的记录

    请求 URL

    https://www.zohoapis.com.cn/crm/v2/Invoices

    请求方法

    POST

    样本请求:

    curl "https://www.zohoapis.com.cn/crm/v2/Invoices"

    -H "Authorization: Zoho-oauthtoken d92d401c803988c5cb849d0b4215f52"

    -d "@newinvoice.json"

    -X POST

    复制样本输入

    样本输入:

    备注:

    • 要添加多个记录,请按照下列格式提供输入数据:
      {
         “data”: [
            {
            {record_data}
            },
            {
            {record_data}
            }
         ]
      }
    • 输入的属性 "line_tax" 用来表示 特定产品的税收金额。
    • 输入的属性 "$line_tax" 用来表示 全部发货单记录的税收金额。
    复制样本响应

    样本响应:

    插入通话

    用途

    在活动模块的通话部分插入一个新的记录

    请求 URL

    https://www.zohoapis.com.cn/crm/v2/Calls

    请求方法

    POST

    样本请求:

    curl "https://www.zohoapis.com.cn/crm/v2/Calls"

    -H "Authorization: Zoho-oauthtoken d92d401c803988c5cb849d0b4215f52"

    -d "@newcall.json"

    -X POST

    复制样本输入

    样本输入:对于已完成的通话

    复制样本输入

    样本输入:对于计划通话

    备注:

    要添加多个记录,请按照下列格式提供输入数据:
    {
       “data”: [
          {
          {record_data}
          },
          {
          {record_data}
          }
       ]
    }

    复制样本响应

    样本响应:

    插入备注并关联到主模块

    用途

    将新的记录添加到备注模块中

    请求 URL

    https://www.zohoapis.com.cn/crm/v2/Notes

    请求方法

    POST

    样本请求:

    curl "https://www.zohoapis.com.cn/crm/v2/Notes"

    -H "Authorization: Zoho-oauthtoken d92d401c803988c5cb849d0b4215f52"

    -d "@newnote.json"

    -X POST

    复制样本代码

    样本输入:

    备注:

    要添加多个记录,请按照下列格式提供输入数据:
    {
       “data”: [
          {
          {record_data}
          },
          {
          {record_data}
          }
       ]
    }

    复制样本代码

    样本响应: