Zoho API предоставляет мощные функциональные возможности для интеграции и автоматизации различных аспектов ваших приложений Zoho. Одной из важных функций является поиск по критериям, который позволяет вам искать и извлекать определенные записи из вашей базы данных Zoho на основе определенных критериев. В этой статье мы рассмотрим несколько методов реализации поиска по критериям с помощью Zoho API, а также приведем примеры кода, иллюстрирующие каждый метод.

Метод 1. Использование Zoho API SDK
Zoho предоставляет SDK для популярных языков программирования, таких как Python, Java и PHP, которые упрощают процесс интеграции. Вот пример использования Python SDK для поиска по критериям:

from zcrmsdk import ZCRMRestClient
# Initialize Zoho API client
ZCRMRestClient.initialize()
# Get the module instance
module_instance = ZCRMRestClient.get_instance().get_module_instance("Leads")
# Create a search criteria
search_criteria = module_instance.get_criteria()
# Add search conditions
search_criteria.add("Last_Name", "equals", "Smith")
search_criteria.add("City", "equals", "New York")
# Perform the search
response = module_instance.search_records_by_criteria(search_criteria)
# Process the response
if response.is_success():
    records = response.get_data()
    for record in records:
        print(record.get_field_value("First_Name"))

Метод 2. Использование конечных точек REST API Zoho.
Если вы предпочитаете работать напрямую с API REST, Zoho предоставляет конечные точки REST для поиска по критериям. Вот пример использования конечной точки searchRecords:

import requests
# Set up API endpoint and parameters
url = "https://www.zohoapis.com/crm/v2/Leads/searchRecords"
params = {
    "criteria": "(Last_Name:equals:Smith) AND (City:equals:New York)",
}
# Make the API request
response = requests.get(url, params=params, headers={"Authorization": "Bearer <YOUR_AUTH_TOKEN>"})
# Process the response
if response.status_code == 200:
    data = response.json()
    records = data["data"]
    for record in records:
        print(record["First_Name"])

Метод 3: использование языка запросов Zoho API (Zoqle)
Zoho API также поддерживает язык запросов Zoqle, который позволяет создавать сложные запросы для поиска по критериям. Вот пример:

import requests
# Set up API endpoint and parameters
url = "https://www.zohoapis.com/crm/v2/Leads/search"
params = {
    "zoql": "select First_Name from Leads where Last_Name='Smith' and City='New York'",
}
# Make the API request
response = requests.get(url, params=params, headers={"Authorization": "Bearer <YOUR_AUTH_TOKEN>"})
# Process the response
if response.status_code == 200:
    data = response.json()
    records = data["data"]
    for record in records:
        print(record["First_Name"])

В этой статье мы рассмотрели три различных метода реализации поиска по критериям с помощью Zoho API. Первый метод использует SDK Zoho API, обеспечивая удобный способ интеграции с приложениями Zoho. Второй метод демонстрирует использование конечных точек REST, обеспечивающих прямое взаимодействие с API. Наконец, третий метод демонстрирует возможности Zoqle, языка запросов Zoho. Используя эти методы, вы можете эффективно искать и извлекать определенные записи из вашей базы данных Zoho на основе желаемых критериев.