SNDesk API

Introdução

Bem-vindo ao SNDesk Developers!

Neste repositório, você encontrará toda a documentação essencial para a integrtação com o SNDesk. Através de nossa API, é possível acessar as funcionalidades do nosso sistema que atendem às demandas de sua empresa e clientes. Desenvolvida conforme o padrão REST, permitindo o uso dos métodos GET, POST, PUT, PATCH e DELETE, com segurança da autentificação OAuth 2.0. Esta documentação esta organizada afim de oferecer detalhes sobre o SNDesk, explicar como pode ser feito seu uso.

O que é o SNDesk

O SNDesk é uma plataforma completa de gerenciamento de suporte e atendimento ao cliente, oferecendo gestão de chamados, portal do cliente, automação de processos e relatórios detalhados. Com ele, empresas de todos os tamanhos podem centralizar e organizar suas solicitações de suporte, atribuí-las a técnicos específicos e acompanhar o status em tempo real. O portal do cliente permite aos clientes enviar e acompanhar seus próprios chamados, fornecendo feedback sobre o atendimento recebido. A automação ajuda a simplificar processos repetitivos, enquanto os relatórios fornecem insights valiosos para melhorar o desempenho do suporte. Com integrações e atualizações regulares, o SNDesk está sempre evoluindo para atender às necessidades dos clientes e garantir uma experiência excepcional.

Padrão REST

No SNDesk usamos um padrão de arquitetura para a API chamada de REST.

O REST abstrai os detalhes técnicos da implementação dos componentes e a estrutura de protocolo, enfocando nas funções que estes componentes exercem, nas normas para sua interação e na maneira como interpretam elementos de dados relevantes. Portanto, para solicitar, atualizar ou enviar dados ao sistema, o usuário deve efetuar um pedido HTTP a um endpoint específico. Em seguida, esse endpoint da API responde, informando sobre o estado atual do recurso solicitado. Esta resposta é enviada através de HTTP, utilizando o formato JSON para estruturar a mensagem.

Cada requisição consiste em um método HTTP, um Header, uma URI e um Body que são explicados a seguir:

O método HTTP diferencia a ação que o usuário deseja realizar pela API, sendo eles:

  • GET: Ação para obter uma ou mais entidades
  • POST: Ação para criar uma entidade ou executar uma ação
  • PUT: Ação para atualizar todos os dados de uma entidade
  • PATCH: Ação para atualizar parcialmente os dados de uma entidade
  • DELETE: Ação para remover uma entidade

  • Header: É o cabeçalho da requisição, as informações enviadas no header podem ser utilizadas para o servidor interpretar a requisição.

    URI: Define o caminho onde a requisição irá ocorrer, por exemplo, em uma requisição para obtenção dos dados de produtos, a URI seria: /Api/v3/produtos.

    Body: É o corpo da requisição, nele são informados os dados que serão enviados para o sistema e também são retornadas as informações da resposta de uma requisição.