Introdução#
Esta API foi criada para que aplicações parceiras possam consumir informações e serviços oferecidos pela Dental Gold. Ela foi desenvolvida obedecendo os padrões REST.Esta documentação detalha os endpoints disponíveis na API da Dental Gold. Além disso, através desta documentação, é possível visualizar o código das requisições para diversas linguagens (PHP, Java, Ruby, Nodejs, entre outras). Para poder utilizá-las, é preciso possuir credenciais fornecidas pela equipe de tecnologia da empresa.Ambiente de teste#
Nossa API possui um ambiente de testes, que pode ser acessada através do endereço abaixo:As credenciais do ambiente de teste não são as mesmas do ambiente de produção. Portanto, assim todos os testes necessários forem realizados neste ambiente, é necessário solicitar novas credenciais para o ambiente de produção.Autenticação#
A autenticação é feita através do fornecimento de uma chave e uma senha. O Access Token gerado no processo de autenticação deve ser transmitido no Header de todas as requisições. Caso o token não seja informado ou ser inválido, uma resposta HTTP 401 será retornada.Atenção! Suas credenciais, como também seu Access Token carrega muitos privilégios. Portanto, certifique-se de mantê-los protegidos. Não informe ela em atendimentos e nem a exponha no front-end da sua aplicação. Havendo suspeita de vazamento destas informações, elas serão inutilizadas e perderão validade. Além disso, não é possível recuperá-la caso perdida, sendo necessário a geração de uma nova.Códigos HTTP das respostas#
A API da Dental Gold utiliza respostas HTTP convencionais para indicar sucesso ou falha nas requisições. Respostas com status 2XX indicam sucesso, status 4xx indicam falhas decorrentes de erros nas informações enviadas, e status 500 indicam erros internos no servidor.Eis alguns retornos comuns da API:200 OK - Sua requisição foi bem sucedida.422 Unprocessable Entity - Algum parâmetro obrigatório não foi enviado ou é inválido. Nestes casos, analisar a resposta. A própria indicará qual é o problema.401 Unauthorized - Access Token não informado, inválido ou expirado.404 Not Found - O endpoint ou o objeto solicitado não existe.500 Internal Server Error - A requisição causou um erro interno no servidor. Nestes casos, a equipe de desenvolvimento é notificada quando este erro ocorre. Se o erro for persistente por muito tempo, entre em contato com o suporte.Todos os endpoints da API do Dental Gold recebem e respondem no formato JSON.Listas e paginação#
Todos os endpoints da API que retornam uma lista de itens são paginados. Informações sobre a paginação será enviado na resposta das requisições. Para navegar entre as páginas, utilize os parâmetros abaixo:| Parâmetro | Descrição | Padrão |
|---|
| offset | Posição do objeto a partir do qual a página deve ser carregada | 0 |
| limit | Quantidade de objetos por página | 20 |
| orderby | Nome da coluna que o resultado será ordenado | * |
| sort | Tipo de ordenação. Opções: asc, desc | asc |
* Os valores padrões e opções disponíveis podem variar para cada tipo de objetoPor exemplo, utilizando limit=20 e offset=0 será retornado os primeiros 20 registros. Utilizando limit=20 e offset=20 trará 20 registros, começando pelo registro 21. O limit deve ser um valor numérico entre 1 e 50. Caso seja omitido será utilizado o valor padrão: 20. O atributo total_count indica quantos registros.Buscas e filtros#
Ainda nos endpoints que retornam uma lista de itens, em alguns será possível realizar buscas e filtrar os resultados. Por exemplo, para encontrar um cliente, será possível realizar buscas pelo seu código, nome, cpf ou data de nascimento. Na lista de mensalidades, será possível filtrá-las pela data de vencimento ou a sua situação.Observe a documentação para cada endpoint que estes recursos estarão disponíveis.Suporte#
Se mesmo após ler a documentação, ainda restarem dúvidas ou encontrar algum problema, envie um e-mail para suporte@dentalgold.com.br com a descrição do seu problema.Modificado em 2026-05-05 17:27:50
