REST API 文档

  • 更新线索
  • 更新子表单
  • 更新客户
  • 更新联系人
  • 更新服务支持
  • 更新任务
  • 更新活动
  • 更新商机
  • 更新产品
  • 更新市场活动
  • 更新解决方案
  • 更新供货商
  • 更新价格表
  • 更新报价
  • 更新销售订单
  • 更新采购订单
  • 更新发货单
+
    • 更新记录 - 示例
      • 更新线索
      • 更新子表单
      • 更新客户
      • 更新联系人
      • 更新服务支持
      • 更新任务
      • 更新活动
      • 更新商机
      • 更新产品
      • 更新市场活动
      • 更新解决方案
      • 更新供货商
      • 更新价格表
      • 更新报价
      • 更新销售订单
      • 更新采购订单
      • 更新发货单

更新记录 - 示例

更新线索

样本请求：

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

-X PUT

-d "updatelead.json"

-H "-H "Authorization: Zoho-oauthtoken d92d401c803988c5cb849d0b4215f52"

备注：

在上面的请求中， @updatelead.json 包含了样本输入。

复制样本输入

样本输入：

▼{
    "data": ▼[
       ▼{
            "id": "410888000000643117",
            "Company": "Zylker",
            "Last_Name": "Peterson"
        }
    ]
}
+
复制样本响应

样本响应：

▼{
    "data": ▼[
       ▼{
            "message": "record updated",
            "details": ▼{
                "created_by": ▼{
                    "id": "2883756000000133013",
                    "name": "Chakra"
                },
                "id": "410888000000643117",
                "modified_by": ▼{
                    "id": "2883756000000133013",
                    "name": "Chakra"
                },
                "modified_time": "2016-04-28T17:59:21+05:30",
                "created_time": "2016-04-28T17:59:21+05:30"
            },
            "status": "record updated",
            "code": "SUCCESS"
        }
    ]
}
+

更新子表单

样本请求：

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

-X PUT

-d "@updateaccount.json"

-H "Authorization: Zoho-oauthtoken d92d401c803988c5cb849d0b4215f52"-

注意事项：

  • 记录的 "ID" (例如：线索 ID) 必须在输入中指定。
  • 必须指定子表单记录的 "ID" 。
  • 假设在子表单中有 3 行记录，如果更新了一个新的记录，那么其他三个子表单记录的 ID 必须被提及。没有 ID 的记录将被删除。例如：如果子表单更新了一条新的记录，并且和已有记录1,3一起更新，那么将删除记录2并创建一个新的记录（假设记录 ID 为 4）。当前的子表单记录是1、3和4
  • 在没有任何JSON对象的情况下更新子表单记录将删除子表单。例如： " subform_1:[] "
复制样本输入

样本输入：

▼{
    "data": ▼[
       ▼{
            "id": "2883756000000135187",
            "Sub_products": ▼[
               ▼{
                    "$approval": ▼{
                        "delegate": false,
                        "approve": false,
                        "reject": false,
                        "resubmit": false
                    },
                    "Owner": ▼{
                        "name": "David Sierra",
                        "id": "2883756000000133013"
                    },
                    "$currency_symbol": "$",
                    "Quantity": 1500,
                    "Name": "3",
                    "Name_of_the_product": "Bandages",
                    "Vendor_Email": "d.collins@ebspharma.com",
                    "Price": 15,
                    "id": "2883756000000458386"
                },
               ▼{
                    "$approval": ▼{
                        "delegate": false,
                        "approve": false,
                        "reject": false,
                        "resubmit": false
                    },
                    "Owner": ▼{
                        "name": "David Sierra",
                        "id": "2883756000000133013"
                    },
                    "Quantity": 1500,
                    "Name": "2",
                    "Name_of_the_product": "Syringes",
                    "Vendor_Email": "d.collins@ebcpharma.com",
                    "Price": 25,
                    "id": "2883756000000458384"
                },
               ▼{
                    "$approval": ▼{
                        "delegate": false,
                        "approve": false,
                        "reject": false,
                        "resubmit": false
                    },
                    "Owner": ▼{
                        "name": "David Sierra",
                        "id": "2883756000000133013"
                    },
                    "Quantity": 150,
                    "Name": "1",
                    "Name_of_the_product": "Fans",
                    "Vendor_Email": "p.boyle@zylker.com",
                    "Price": 150,
                    "id": "2883756000000458344"
                }
            ]
        }
    ]
}
+

备注：

要更新多个子表单，请从请求URL中删除记录 ID，并按照下列格式提供输入数据：
{
   “data”: [
      {....
        Subform_1:[
          {sub_form_data},
        ],...
      },
      {....
        Subform_2:[
          {sub_form_data},
        ],...
      }
   ]
}

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

样本响应：

▼{
    "data": ▼[
       ▼{
            "code": "SUCCESS",
            "details": ▼{
                "Modified_Time": "2018-03-23T12:01:37+05:30",
                "Modified_By": ▼{
                    "name": "David Sierra",
                    "id": "2883756000000133013"
                },
                "Created_Time": "2017-12-20T11:56:47+05:30",
                "id": "2883756000000135187",
                "Created_By": ▼{
                    "name": "David Sierra",
                    "id": "2883756000000133013"
                }
            },
            "message": "record updated",
            "status": "success"
        }
    ]
}
+

更新客户

样本请求：

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

-X PUT

-d "@updateaccount.json"

-H "Authorization: Zoho-oauthtoken d92d401c803988c5cb849d0b4215f52"-

复制样本输入

样本输入：

▼{
    "data": ▼[
       ▼{
            "id": "410888000000643117",
            "Account_Name": "Zylker",
            "Website": "www.zylker.com",
            "Employees": 250
        }
    ]
}
+
复制样本响应

样本响应：

▼{
    "data": ▼[
       ▼{
            "code": "SUCCESS",
            "details": ▼{
                "created_time": "2016-07-05T17:06:53+05:30",
                "modified_time": "2016-08-08T11:26:16+05:30",
                "modified_by": ▼{
                    "name": "Chakra",
                    "id": "2883756000000133013"
                },
                "id": "410888000000643117",
                "created_by": ▼{
                    "name": "Chakra",
                    "id": "2883756000000133013"
                }
            },
            "message": "record updated",
            "status": "success"
        }
    ]
}
+

更新联系人

样本请求：

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

-X PUT

-d @updatecontact.json

-H "Authorization: Zoho-oauthtoken d92d401c803988c5cb849d0b4215f52"

复制样本输入

样本输入：

▼{
    "data": ▼[
       ▼{
            "id": "410888000000643123",
            "Last_Name": "Jasmine",
            "Email": "jasmine.frank@zylker.com"
        }
    ]
}
+
复制样本响应

样本响应：

▼{
    "data": ▼[
       ▼{
            "code": "SUCCESS",
            "details": ▼{
                "created_time": "2016-07-05T17:13:24+05:30",
                "modified_time": "2016-08-08T11:28:41+05:30",
                "modified_by": ▼{
                    "name": "Chakra",
                    "id": "2883756000000133013"
                },
                "id": "410888000000643123",
                "created_by": ▼{
                    "name": "Chakra",
                    "id": "2883756000000133013"
                }
            },
            "message": "record updated",
            "status": "success"
        }
    ]
}
+

更新服务支持

样本请求：

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

-X PUT

-d "@updatecase.json"

-H "Authorization: Zoho-oauthtoken d92d401c803988c5cb849d0b4215f52"

复制样本输入

样本输入：

▼{
    "data": ▼[
       ▼{
            "id": "410888000000694001",
            "Case_Origin": "Phone",
            "Status ": "Closed",
            "Subject ": "New Case",
            "Account_Name": "Account for Cases",
            "State": "Texas"
        }
    ]
}
+
复制样本响应

样本响应：

▼{
    "data": ▼[
       ▼{
            "code": "SUCCESS",
            "details": ▼{
                "created_time": "2016-08-08T13:18:45+05:30",
                "modified_time": "2016-08-08T13:26:50+05:30",
                "modified_by": ▼{
                    "name": "Chakra",
                    "id": "2883756000000133013"
                },
                "id": "410888000000694001",
                "created_by": ▼{
                    "name": "Chakra",
                    "id": "2883756000000133013"
                }
            },
            "message": "record updated",
            "status": "success"
        }
    ]
}
+

更新任务

样本请求：

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

-X PUT

-d "@updatetask.json"

-H "Authorization: Zoho-oauthtoken d92d401c803988c5cb849d0b4215f52"

复制样本输入

样本输入：

▼{
    "data": ▼[
       ▼{
            "id": "410888000000694001",
            "Subject": "Call",
            "Due_Date ": "2016-08-12",
            "Status": "Deferred"
        }
    ]
}
+
复制样本响应

样本响应：

▼{
    "data": ▼[
       ▼{
            "code": "SUCCESS",
            "details": ▼{
                "created_time": "2016-08-08T13:18:45+05:30",
                "modified_time": "2016-08-08T13:26:50+05:30",
                "modified_by": ▼{
                    "name": "Chakra",
                    "id": "2883756000000133013"
                },
                "id": "410888000000694001",
                "created_by": ▼{
                    "name": "Chakra",
                    "id": "2883756000000133013"
                }
            },
            "message": "record updated",
            "status": "success"
        }
    ]
}
+

更新活动

样本请求：

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

-X PUT

-d "@updateevent.json"

-H "Authorization: Zoho-oauthtoken d92d401c803988c5cb849d0b4215f52"

复制样本输入

样本输入：

▼{
    "data": ▼[
       ▼{
            "id": "4108880000694001",
            "Event_Title": "Event_Title",
            "Start_DateTime": "2016-04-11T10:50:41+05:30",
            "End_DateTime": "2016-04-11T10:50:41+05:30"
        }
    ]
}
+
复制样本响应

样本响应：

▼{
    "data": ▼[
       ▼{
            "code": "SUCCESS",
            "details": ▼{
                "created_time": "2016-08-08T13:18:45+05:30",
                "modified_time": "2016-08-08T13:26:50+05:30",
                "modified_by": ▼{
                    "name": "Chakra",
                    "id": "2883756000000133013"
                },
                "id": "4108880000694001",
                "created_by": ▼{
                    "name": "Chakra",
                    "id": "2883756000000133013"
                }
            },
            "message": "record updated",
            "status": "success"
        }
    ]
}
+

更新商机

样本请求：

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

-X PUT

-d "@updatedeal.json"

-H "Authorization: Zoho-oauthtoken d92d401c803988c5cb849d0b4215f52"

复制样本输入

样本输入：

▼{
    "data": ▼[
       ▼{
            "id": "2883756000000215026",
            "Closing_Date": "2018-02-30",
            "Expected_Revenue": 58000,
            "Stage": "Proposal/Price Quote",
            "Account_Name": ▼{
                "name": "Northrop Grumman Corporation",
                "id": "2883756000000153009"
            },
            "Amount": 58500,
            "Probability": 85,
            "Type": "Existing Business"
        }
    ],
    "wf_trigger": false
}
+
复制样本响应

样本响应：

▼{
    "data": ▼[
       ▼{
            "code": "SUCCESS",
            "details": ▼{
                "Modified_Time": "2018-01-16T12:17:01+05:30",
                "Modified_By": ▼{
                    "name": "Chakra",
                    "id": "2883756000000133013"
                },
                "Created_Time": "2018-01-16T12:11:44+05:30",
                "id": "2883756000000215026",
                "Created_By": ▼{
                    "name": "Chakra",
                    "id": "2883756000000133013"
                }
            },
            "message": "record updated",
            "status": "success"
        }
    ]
}
+

更新产品

样本请求：

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

-X PUT

-d "@updateproduct.json"

-H "Authorization: Zoho-oauthtoken d92d401c803988c5cb849d0b4215f52"

复制样本输入

样本输入：

▼{
    "data": ▼[
       ▼{
            "id": "2883756000000192006",
            "Reorder_Level": 20,
            "Qty_Ordered": 15,
            "Qty_in_Stock": 105
        }
    ],
    "wf_trigger": false
}
+
复制样本响应

样本响应：

▼{
    "data": ▼[
       ▼{
            "code": "SUCCESS",
            "details": ▼{
                "Modified_Time": "2018-01-10T14:51:19+05:30",
                "Modified_By": ▼{
                    "name": "Chakra",
                    "id": "2883756000000133013"
                },
                "Created_Time": "2018-01-10T14:48:23+05:30",
                "id": "2883756000000192006",
                "Created_By": ▼{
                    "name": "Chakra",
                    "id": "2883756000000133013"
                }
            },
            "message": "record updated",
            "status": "success"
        }
    ]
}
+

更新市场活动

样本请求：

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

-X PUT

-d "@updatecampaign.json"

-H "Authorization: Zoho-oauthtoken d92d401c803988c5cb849d0b4215f52"

复制样本输入

样本输入：

▼{
    "data": ▼[
       ▼{
            "id": "2883756000000192014",
            "Status": "Completed",
            "Campaign_Name": "Christmas Special",
            "End_Date": "2018-01-10",
            "Expected_Revenue": 58000,
            "Actual_Cost": 75000,
            "Start_Date": "2017-12-20",
            "Type": "Advertisement"
        }
    ],
    "wf_trigger": false
}
+
复制样本响应

样本响应：

▼{
    "data": ▼[
       ▼{
            "code": "SUCCESS",
            "details": ▼{
                "Modified_Time": "2018-01-10T14:59:32+05:30",
                "Modified_By": ▼{
                    "name": "Chakra",
                    "id": "2883756000000133013"
                },
                "Created_Time": "2018-01-10T14:56:43+05:30",
                "id": "2883756000000192014",
                "Created_By": ▼{
                    "name": "Chakra",
                    "id": "2883756000000133013"
                }
            },
            "message": "record updated",
            "status": "success"
        }
    ]
}
+

更新解决方案

样本请求：

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

-X PUT

-d "@updatesolution.json"

-H "Authorization: Zoho-oauthtoken d92d401c803988c5cb849d0b4215f52"

复制样本输入

样本输入：

▼{
    "data": ▼[
       ▼{
            "id": "2883756000000215015",
            "Solution_Title": "Handling Customers",
            "Status": "Reviewed"
        }
    ],
    "wf_trigger": false
}
+
复制样本响应

样本响应：

▼{
    "data": ▼[
       ▼{
            "code": "SUCCESS",
            "details": ▼{
                "Modified_Time": "2018-01-16T12:06:32+05:30",
                "Modified_By": ▼{
                    "name": "Chakra",
                    "id": "2883756000000133013"
                },
                "Created_Time": "2018-01-16T12:03:32+05:30",
                "id": "2883756000000215015",
                "Created_By": ▼{
                    "name": "Chakra",
                    "id": "2883756000000133013"
                }
            },
            "message": "record updated",
            "status": "success"
        }
    ]
}
+

更新供货商

样本请求：

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

-X PUT

-d "@updatevendor.json"

-H "Authorization: Zoho-oauthtoken d92d401c803988c5cb849d0b4215f52"

复制样本输入

样本输入：

▼{
    "data": ▼[
       ▼{
            "id": "2883756000000192028",
            "Website": "www.mangolite.com",
            "Phone": "8885553478"
        }
    ],
    "wf_trigger": false
}
+
复制样本响应

样本响应：

▼{
    "data": ▼[
       ▼{
            "code": "SUCCESS",
            "details": ▼{
                "Modified_Time": "2018-01-10T15:09:32+05:30",
                "Modified_By": ▼{
                    "name": "Chakra",
                    "id": "2883756000000133013"
                },
                "Created_Time": "2018-01-10T15:07:18+05:30",
                "id": "2883756000000192028",
                "Created_By": ▼{
                    "name": "Chakra",
                    "id": "2883756000000133013"
                }
            },
            "message": "record updated",
            "status": "success"
        }
    ]
}
+

更新价格表

样本请求：

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

-X PUT

-d "@updatepricebook.json"

-H "Authorization: Zoho-oauthtoken d92d401c803988c5cb849d0b4215f52"

复制样本输入

样本输入：

▼{
    "data": ▼[
       ▼{
            "id": "2883756000000215041",
            "Pricing_Details": ▼[
               ▼{
                    "to_range": 10000,
                    "discount": 250,
                    "from_range": 1000
                }
            ],
            "Pricing_Model": "Flat",
            "Price_Book_Name": "New Customers-2",
            "Active": true
        }
    ],
    "wf_trigger": false
}
+
复制样本响应

样本响应：

▼{
    "data": ▼[
       ▼{
            "code": "SUCCESS",
            "details": ▼{
                "Modified_Time": "2018-01-16T12:26:43+05:30",
                "Modified_By": ▼{
                    "name": "Chakra",
                    "id": "2883756000000133013"
                },
                "Created_Time": "2018-01-16T12:24:04+05:30",
                "id": "2883756000000215041",
                "Created_By": ▼{
                    "name": "Chakra",
                    "id": "2883756000000133013"
                }
            },
            "message": "record updated",
            "status": "success"
        }
    ]
}
+

更新报价

样本请求：

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

-X PUT

-d "@updatequote.json"

-H "Authorization: Zoho-oauthtoken d92d401c803988c5cb849d0b4215f52"

复制样本输入

样本输入：

▼{
    "data": ▼[
       ▼{
            "id": "2883756000000192039",
            "Subject": "Test Quote",
            "Quote_Stage": "Confirmed"
        }
    ],
    "wf_trigger": false
}
+
复制样本响应

样本响应：

▼{
    "data": ▼[
       ▼{
            "code": "SUCCESS",
            "details": ▼{
                "Modified_Time": "2018-01-10T17:01:25+05:30",
                "Modified_By": ▼{
                    "name": "Chakra",
                    "id": "2883756000000133013"
                },
                "Created_Time": "2018-01-10T16:58:14+05:30",
                "id": "2883756000000192039",
                "Created_By": ▼{
                    "name": "Chakra",
                    "id": "2883756000000133013"
                }
            },
            "message": "record updated",
            "status": "success"
        }
    ]
}
+

更新销售订单

样本请求：

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

-X PUT

-d "@updatesalesorder.json"

-H "Authorization: Zoho-oauthtoken d92d401c803988c5cb849d0b4215f52"

复制样本输入

样本输入：

▼{
    "data": ▼[
       ▼{
            "id": "2883756000000192052",
            "Subject": "Deal for System Fans",
            "Due_Date": "2018-01-13",
            "Customer_No": "42453"
        }
    ],
    "wf_trigger": false
}
+
复制样本响应

样本响应：

▼{
    "data": ▼[
       ▼{
            "code": "SUCCESS",
            "details": ▼{
                "Modified_Time": "2018-01-11T16:14:20+05:30",
                "Modified_By": ▼{
                    "name": "Chakra",
                    "id": "2883756000000133013"
                },
                "Created_Time": "2018-01-11T16:10:16+05:30",
                "id": "2883756000000192052",
                "Created_By": ▼{
                    "name": "Chakra",
                    "id": "2883756000000133013"
                }
            },
            "message": "record updated",
            "status": "success"
        }
    ]
}
+

更新采购订单

样本请求：

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

-X PUT

-d "@updatepurchaseorder.json"

-H "Authorization: Zoho-oauthtoken d92d401c803988c5cb849d0b4215f52"

复制样本输入

样本输入：

▼{
    "data": ▼[
       ▼{
            "id": "2883756000000192065",
            "Subject": "Order for System HDDs",
            "Due_Date": "2018-03-20",
            "Product_Details": ▼[
               ▼{
                    "product": ▼{
                        "Product_Code": "AE146",
                        "name": "System Internal HDD",
                        "id": "2883756000000192006"
                    },
                    "quantity": 50,
                    "Discount": 0,
                    "total_after_discount": 25000,
                    "net_total": 25000,
                    "book": null,
                    "Tax": 0,
                    "list_price": 500,
                    "unit_price": 50000,
                    "quantity_in_stock": 30,
                    "total": 25000,
                    "product_description": "",
                    "line_tax": ▼[
                       ▼{
                            "percentage": 0,
                            "name": "Vat",
                            "value": 0
                        }
                    ]
                }
            ]
        }
    ],
    "wf_trigger": false
}
+
复制样本响应

样本响应：

▼{
    "data": ▼[
       ▼{
            "code": "SUCCESS",
            "details": ▼{
                "Modified_Time": "2018-01-11T16:31:24+05:30",
                "Modified_By": ▼{
                    "name": "Chakra",
                    "id": "2883756000000133013"
                },
                "Created_Time": "2018-01-11T16:28:15+05:30",
                "id": "2883756000000192065",
                "Created_By": ▼{
                    "name": "Chakra",
                    "id": "2883756000000133013"
                }
            },
            "message": "record updated",
            "status": "success"
        }
    ]
}
+

更新发货单

样本请求：

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

-X PUT

-d "@updateinvoice.json"

-H "Authorization: Zoho-oauthtoken d92d401c803988c5cb849d0b4215f52"

复制样本输入

样本输入：

▼{
    "data": ▼[
       ▼{
            "Invoice_Date": "2018-01-28",
            "Account_Name": ▼{
                "name": "Presbyterian Intercommunity Hosp",
                "id": "2883756000000153028"
            },
            "id": "2883756000000215002",
            "Due_Date": "2018-02-04"
        }
    ],
    "wf_trigger": false
}
+
复制样本响应

样本响应：

▼{
    "data": ▼[
       ▼{
            "code": "SUCCESS",
            "details": ▼{
                "Modified_Time": "2018-01-16T11:56:27+05:30",
                "Modified_By": ▼{
                    "name": "Chakra",
                    "id": "2883756000000133013"
                },
                "Created_Time": "2018-01-16T11:49:57+05:30",
                "id": "2883756000000215002",
                "Created_By": ▼{
                    "name": "Chakra",
                    "id": "2883756000000133013"
                }
            },
            "message": "record updated",
            "status": "success"
        }
    ]
}
+

更新通话

样本请求：

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

-X PUT

-d "@updatecall.json"

-H "Authorization: Zoho-oauthtoken d92d401c803988c5cb849d0b4215f52"

复制样本输入

样本输入：

▼{
    "data": ▼[
       ▼{
            "Call_Duration": "34:45",
            "Call_Status": "Attended Dialled",
            "Call_Type": "Outbound"
        }
    ],
    "wf_trigger": false
}
+
复制样本响应

样本响应：

▼{
    "data": ▼[
       ▼{
            "code": "SUCCESS",
            "details": ▼{
                "Modified_Time": "2018-01-16T11:56:27+05:30",
                "Modified_By": ▼{
                    "name": "Chakra",
                    "id": "2883756000000133013"
                },
                "Created_Time": "2018-01-16T11:49:57+05:30",
                "id": "2883756000000186003",
                "Created_By": ▼{
                    "name": "Chakra",
                    "id": "2883756000000133013"
                }
            },
            "message": "record updated",
            "status": "success"
        }
    ]
}
+