Integração, estrutura e navegação
      Voltar para o início
      1. Central de Ajuda
      2. Contele Fleet
      3. Integração, estrutura e navegação

      API Aberta Contele Fleet

      Vídeo explicativo de como usar API da Contele Fleet

      Como saber quais módulos podem ser integrados.

      Documentação

      Introdução a API

      Contele Open API Documentation

      Introdução

      A API Aberta da Contele fornece uma interface padronizada para desenvolvedores interagirem com os serviços e dados da Contele. Ela é projetada para facilitar a integração com várias aplicações, permitindo que os usuários aproveitem as funcionalidades da Contele em suas próprias soluções de software.

      Esta API segue os princípios RESTful, permitindo que os desenvolvedores realizem operações usando métodos HTTP padrão. Utilizando a API Aberta da Contele, os desenvolvedores podem acessar uma ampla gama de recursos, incluindo recuperação de dados, atualizações e gerenciamento de recursos.

      image.png

      Propósito

      O principal objetivo da API Aberta da Contele é fornecer uma plataforma robusta e flexível para que os desenvolvedores construam aplicações que possam se comunicar com os serviços da Contele. Esta API capacita os usuários a automatizar tarefas, integrar com sistemas existentes e aprimorar suas aplicações com as capacidades da Contele.

      Contexto dos Serviços Web

      No contexto mais amplo dos serviços web, a API Aberta da Contele se encaixa no cenário das APIs RESTful, amplamente utilizadas para construir aplicações web escaláveis e de fácil manutenção. Seguindo convenções e padrões estabelecidos, a API Aberta da Contele garante que os desenvolvedores possam entender e utilizar suas funcionalidades facilmente, levando a ciclos de desenvolvimento mais rápidos e melhores experiências para os usuários.

      Começando

      Para começar a usar a API Aberta da Contele, os desenvolvedores devem se familiarizar com os seguintes conceitos-chave:

      1. Modelo HTTP: Compreender o ciclo de requisição-resposta, métodos HTTP e códigos de status é crucial para o uso eficaz da API.
      2. Estrutura de Dados Base: Conhecer os tipos de dados comuns e formatos usados na API ajudará na construção de requisições e interpretação de respostas.
      3. Serviços e Endpoints: Cada serviço oferece funcionalidades específicas, acessíveis através de endpoints definidos. Documentação detalhada para cada serviço e seus endpoints está disponível nas seções respectivas.
      4. Ao aproveitar a API Aberta da Contele, os desenvolvedores podem desbloquear todo o potencial dos serviços da Contele e criar soluções inovadoras adaptadas às suas necessidades.

      Autenticação

      A API Aberta da Contele requer autenticação para acessar os recursos protegidos. Os desenvolvedores devem incluir um token de autenticação válido em cada requisição para autenticar com sucesso e acessar os recursos protegidos. O token de autenticação é gerado para cada usuário e deve ser mantido em segredo para garantir a segurança dos dados.

      Disclaimer

      Para utilizar a documentação para efetuar requisições é necessário seguir as seguintes etapas:

       
      1. No Sistema Contele Fleet, clique em Gerar Token de Acesso
       
      2. Criar informações do seu Token
       
      3. Copiar seu Token (Após criado, esse token nunca mais será exibido)
      4. Após gerar o token, acessar a documentação

      5. Instale a Extensão da APIDOG requerida no endpoint

      image.png


      6. Adicione a Chave obtida como uma variável em "Go to Set Value"

      image.png



      Formato de Resposta

      As respostas da API Aberta da Contele são retornadas em formato JSON. Os desenvolvedores devem analisar e interpretar as respostas JSON para extrair os dados necessários e tomar as ações apropriadas em suas aplicações.

      Tratamento de Erros

      A API Aberta da Contele utiliza códigos de status HTTP padrão para indicar o resultado de uma requisição. Além disso, a API retorna mensagens de erro detalhadas para ajudar os desenvolvedores a diagnosticar e corrigir problemas rapidamente.

      Considerações Finais

      A API Aberta da Contele é uma ferramenta poderosa para os desenvolvedores que desejam integrar seus aplicativos com os serviços da Contele. Ao seguir as práticas recomendadas e as diretrizes fornecidas nesta documentação, os desenvolvedores podem criar soluções inovadoras e eficazes que aproveitam todo o potencial dos serviços da Contele.

      Principais Técnologias Utilizadas

      1. Node.js: Utilizado para construir a maioria dos serviços.
      2. Docker: Utilizado para containerização dos serviços.
      3. Redis: Utilizado como banco de dados em memória.
      4. Google Cloud BigQuery: Utilizado para análise de dados.
      5. Express.js: Framework web para Node.js, utilizado em vários serviços.
      6. Swagger: Utilizado para documentação de APIs.
      7. Axios: Utilizado para fazer requisições HTTP.
      8. Jest: Utilizado para testes unitários.
      9. GitHub Actions: Utilizado para CI/CD.
      10. Bitbucket Pipelines: Utilizado para CI/CD.
      11. MySQL: Utilizado como banco de dados relacional.
      12. Google Cloud Pub/Sub: Utilizado para mensageria.
      13. Nginx: Utilizado como proxy reverso.
      14. Kubernetes: Utilizado para orquestração de contêineres.
      15. dumb-init: Utilizado como um init system para contêineres Docker.