API Rest - IMED Simah

[ Base URL: connectt.ddns.me:3001/api ] - 1.0

Sessão de exames

1. Consulta de Preço por Código

Este endpoint retorna o valor de um item específico utilizando o seu código numérico de identificação (ID).

URL: connectt.ddns.me:3001/api/itemvlr
Método HTTP: GET

Cabeçalhos (Headers) da Requisição:

Authorization
item: Código numérico do item. Deve conter apenas números e ter no máximo 9 dígitos.

Exemplo de Resposta de Sucesso (200 OK):

Erros:

400 Bad Request: Falta o cabeçalho item. (Mensagem: "Todos os headers são requeridos")
403 Forbidden: Falha ou ausência do token de autenticação.
404 Not Found: O código informado não existe no banco de dados. (Mensagem: "Nenhum registro encontrado")
406 Not Acceptable: O código contém letras ou ultrapassa o limite de 9 dígitos.

2. Busca de Item por Nome

Este endpoint permite pesquisar itens no banco de dados pelo nome (ou parte dele) e retorna uma lista contendo o código, o nome completo e o valor de cada item encontrado.

URL: connectt.ddns.me:3001/api/itemsearch
Método HTTP: GET

Cabeçalhos (Headers) da Requisição:

Authorization
itemname: Texto para busca. Deve conter no mínimo 3 caracteres (Ex: Abdome total).

Exemplo de Resposta de Sucesso (200 OK):

Erros:

400 Bad Request: Falta o cabeçalho itemname. (Mensagem: "O header 'itemname' é requerido")
403 Forbidden: Falha ou ausência do token de autenticação.
404 Not Found: Nenhum item compatível com a busca foi encontrado. (Mensagem: "Nenhum registro encontrado")
406 Not Acceptable: O termo de busca possui menos de 3 caracteres. (Mensagem: "A busca deve conter pelo menos 3 caracteres")