Outsmart
    Voltar para Zoho Deluge
    Zoho Deluge

    REST API

    Por Victor2021-08-034 min de leitura

    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;
    				
    			

    Artigos relacionados