API que provém do inglês Application Programming Interface, trata-se de um conjunto de rotinas e padrões estabelecidos e documentados por uma aplicação, para que os outros serviços consigam utilizar as funcionalidades desta aplicação, sem precisar conhecer os detalhes de sua implementação.
Abaixo apresentaremos recursos das API utilizados na Zoho
APIs REST
Todas as APIs seguem os padrões REST, ou seja, utilizam os métodos de solicitação HTTP GET, POST, PUT, DELETE etc.
GET – Buscar os registros
POST – Inserir novos registros
PUT – Atualizar os registros existentes
DELETE – Exclui os registros
Todas as entradas e respostas estão no formato JSON.
Todas as respostas terão um código de status HTTP.
JSON apenas
Todas as entradas e respostas da API estão apenas no formato JSON.
Algumas das vantagens de usar JSON são:
Menos verboso : JSON não tem tags como XML e, portanto, requer menos caracteres para representar os dados.
Mais rápido : como o JSON usa menos dados, é fácil ler e analisar os dados, portanto, aumenta a velocidade de análise.
Legível : JSON é dados muito simples e fáceis de ler.
Domínio de CRM dedicado e manipulação de DC múltiplo
As APIs Zoho CRM têm um domínio dedicado https://www.zohoapis.com/ (EUA)
Isso é útil para atender às solicitações CORS.
Os outros domínios suportados são:
Europa – https://www.zohoapis.eu/
China – https://www.zohoapis.com.cn/
Índia – https://www.zohoapis.in/
Alterações de endpoint
APIs têm o endpoint https://www.zohoapis.com/crm/v2/ onde
https://www.zohoapis.com é o nome do domínio e
/ crm / v2 / é o endpoint para as APIs CRM v2
Por exemplo, o URL de solicitação para obter a lista de Leads no CRM é
https://www.zohoapis.com/crm/v2/Leads
Nomes de API
As APIs Zoho CRM usam nomes de API gerados internamente durante a criação de um módulo personalizado, campo ou rótulo de lista relacionada. O sistema usa essa chave “api_name” nos dados JSON ao acessar as APIs de CRM. Isso garante que as alterações do nome do rótulo em módulos ou campos personalizados não afetem suas integrações existentes.
Por exemplo, Leads para o módulo de Negócios, currency para o campo de moeda e Notes para a lista relacionada de notas.
Paginação
Todas as respostas GET da API têm o seguinte objeto JSON “info”.
Observação
“info”: {
“per_page”: 200,
“count”: 1,
“page”: 1,
“more_records”: false
}
“per_page” : Use este parâmetro para definir o número de registros que você deseja buscar por página. O valor padrão é 200 .
“page” : Use este parâmetro para buscar os registros dessa página. O valor padrão é 1 .
“more_records” : este parâmetro indica se há mais registros nesse módulo. Os valores são verdadeiros ou falsos.
API de Módulos
Zoho CRM tem módulos padrão como Leads, Contas, Contatos, Negócios, Previsões, Atividades e assim por diante. Usando a API REST do Zoho CRM, você pode recuperar a lista de módulos disponíveis por meio da API Get List of Modules.
Obter lista de módulos
Propósito
Para recuperar a lista de todos os módulos disponíveis na sua conta CRM.
Pedir detalhes
Solicitar URL
https://www.zohoapis.com/crm/v2/settings/modules
Cabeçalho
Autorização: Zoho-oauthtoken d92d4xxxxxxxxxxxxxxx15f52
Escopo
scope = ZohoCRM.settings.ALL
(ou)
scope = ZohoCRM.settings.modules. {operation_type}
Possíveis tipos de operação
ALL- Acesso total aos dados
READ – Obter dados do módulo
Observação
Consulte a chave api_name nos dados JSON ao acessar o recurso. Cada módulo, campo e listas relacionadas terão um nome de API, que você pode usar nas integrações de terceiros. Por exemplo, se você deseja acessar o módulo Leads, use “Leads” que é o api_name toda vez que você acessar o recurso. O Zoho CRM gera um nome de API internamente ao criar um módulo personalizado, campo personalizado ou rótulo de lista relacionada. observe que você não pode alterar os nomes da API para os módulos, campos e listas relacionadas padrão. Você pode alterar os nomes da API apenas para módulos personalizados, campos e listas relacionadas.
O nome da API gerado pode conter apenas letras, números e sublinhados. O nome da API deve começar com um alfabeto e não deve ter dois sublinhados consecutivos ou terminar com um sublinhado.
Consulte a Estrutura de resposta para obter mais detalhes sobre as chaves JSON, valores e descrições dos módulos disponíveis. Você também pode usar a resposta de amostra de cada módulo como entrada ao inserir, atualizar ou fazer o upsert de um registro nesse módulo correspondente.
requisicao = invokeurl
[
url: "https://www.zohoapis.com/crm/v2/users"
type: GET
connection:"crm"
];
info requisicao;