Autenticação

Para usar a API, primeiro você precisa obter um token JWT:

JavaScript

cURL

// Obter token de acesso
const response = await fetch(`${baseURL}/Acesso/login`, {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    identificacao: 'seu_usuario',
    senha: 'sua_senha'
  })
});

const data = await response.json();
const token = data.token; // Guarde este token para requisições futuras

curl -X POST "${baseURL}/Acesso/login" \
  -H "Content-Type: application/json" \
  -d '{"identificacao":"seu_usuario","senha":"sua_senha"}'

// Obter token de acesso
using (var client = new HttpClient())
{
  client.BaseAddress = new Uri(baseURL);
  
  var loginData = new {
      identificacao = "seu_usuario",
      senha = "sua_senha"
  };
  
  var response = await client.PostAsJsonAsync("Acesso/login", loginData);
  var result = await response.Content.ReadAsAsync();
  string token = result.token; // Guarde este token
}

Renovar Token

O token expira em 15 minutos. Use o refresh token para renová-lo:

JavaScript

cURL

// Renovar token
const refreshResponse = await fetch(`${baseURL}/Acesso/refreshToken?refreshToken=SEU_REFRESH_TOKEN&token=SEU_TOKEN`);
const newToken = await refreshResponse.json();

curl -X POST "${baseURL}/Acesso/refreshToken?refreshToken=SEU_REFRESH_TOKEN&token=SEU_TOKEN"

// Renovar token
using (var client = new HttpClient())
{
  client.BaseAddress = new Uri(baseURL);
  
  var response = await client.PostAsync($"Acesso/refreshToken?refreshToken={refreshToken}&token={token}", null);
  var result = await response.Content.ReadAsAsync();
  string newToken = result.token; // Novo token para usar
}

Agendamento

Listar Agendamentos

JavaScript

cURL

// Listar agendamentos
const response = await fetch(`${baseURL}/Medware/Agendamento/Listar?codMedico=123&dataInicio=01/10/2023&dataFim=31/10/2023`, {
  headers: {
    'Authorization': `Bearer ${token}`
  }
});

const agendamentos = await response.json();
console.log(agendamentos);

curl -X GET "${baseURL}/Medware/Agendamento/Listar?codMedico=123&dataInicio=01/10/2023&dataFim=31/10/2023" \
  -H "Authorization: Bearer SEU_TOKEN"

// Listar agendamentos
using (var client = new HttpClient())
{
  client.BaseAddress = new Uri(baseURL);
  client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", token);
  
  var response = await client.GetAsync("Medware/Agendamento/Listar?codMedico=123&dataInicio=01/10/2023&dataFim=31/10/2023");
  var agendamentos = await response.Content.ReadAsAsync();
}

Criar Agendamento

JavaScript

cURL

// Criar novo agendamento
const agendamento = {
  codMedico: 123,
  codPaciente: 456,
  codProcedimento: 789,
  codPlano: 101,
  codUnidade: 202,
  dataHoraAgendada: "2023-12-31T14:00:00"
};

const response = await fetch(`${baseURL}/Medware/Agendamento/Salvar`, {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': `Bearer ${token}`
  },
  body: JSON.stringify(agendamento)
});

const resultado = await response.json();

curl -X POST "${baseURL}/Medware/Agendamento/Salvar" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer SEU_TOKEN" \
  -d '{"codMedico":123,"codPaciente":456,"codProcedimento":789,"codPlano":101,"codUnidade":202,"dataHoraAgendada":"2023-12-31T14:00:00"}'

// Criar novo agendamento
using (var client = new HttpClient())
{
  client.BaseAddress = new Uri(baseURL);
  client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", token);
  
  var agendamento = new {
      codMedico = 123,
      codPaciente = 456,
      codProcedimento = 789,
      codPlano = 101,
      codUnidade = 202,
      dataHoraAgendada = "2023-12-31T14:00:00"
  };
  
  var response = await client.PostAsJsonAsync("Medware/Agendamento/Salvar", agendamento);
  var resultado = await response.Content.ReadAsAsync();
}

Médicos e Especialidades

Listar Médicos

JavaScript

cURL

// Listar médicos
const response = await fetch(`${baseURL}/Medware/Medico/Listar?codunidade=1&codPlano=101&codprocedimento=201&dataInicio=01/01/2023&dataFim=31/12/2023`, {
  headers: {
    'Authorization': `Bearer ${token}`
  }
});

const medicos = await response.json();

curl -X GET "${baseURL}/Medware/Medico/Listar?codunidade=1&codPlano=101&codprocedimento=201&dataInicio=01/01/2023&dataFim=31/12/2023" \
  -H "Authorization: Bearer SEU_TOKEN"

// Listar médicos
using (var client = new HttpClient())
{
  client.BaseAddress = new Uri(baseURL);
  client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", token);
  
  var response = await client.GetAsync("Medware/Medico/Listar?codunidade=1&codPlano=101&codprocedimento=201&dataInicio=01/01/2023&dataFim=31/12/2023");
  var medicos = await response.Content.ReadAsAsync();
}

Listar Especialidades

JavaScript

cURL

// Listar especialidades
const response = await fetch(`${baseURL}/Medware/Especialidade/Listar?codUnidade=1&codMedico=123&codProcedimento=456&dataInicio=01/01/2023&dataFim=31/12/2023`, {
  headers: {
    'Authorization': `Bearer ${token}`
  }
});

const especialidades = await response.json();

curl -X GET "${baseURL}/Medware/Especialidade/Listar?codUnidade=1&codMedico=123&codProcedimento=456&dataInicio=01/01/2023&dataFim=31/12/2023" \
  -H "Authorization: Bearer SEU_TOKEN"

// Listar especialidades
using (var client = new HttpClient())
{
  client.BaseAddress = new Uri(baseURL);
  client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", token);
  
  var response = await client.GetAsync("Medware/Especialidade/Listar?codUnidade=1&codMedico=123&codProcedimento=456&dataInicio=01/01/2023&dataFim=31/12/2023");
  var especialidades = await response.Content.ReadAsAsync();
}

Pacientes

Criar/Atualizar Paciente

JavaScript

cURL

// Cadastrar paciente
const paciente = {
  nome: "Maria Oliveira",
  dataNascimento: "25/08/1990",
  email: "maria.oliveira@email.com",
  cpf: "98765432100",
  numeroCelularddd: "11",
  numeroCelular: "987654321"
};

const response = await fetch(`${baseURL}/Medware/Paciente/Atualizar`, {
  method: 'PUT',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': `Bearer ${token}`
  },
  body: JSON.stringify(paciente)
});

const codPaciente = await response.json(); // Retorna o ID do paciente

curl -X PUT "${baseURL}/Medware/Paciente/Atualizar" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer SEU_TOKEN" \
  -d '{"nome":"Maria Oliveira","dataNascimento":"25/08/1990","email":"maria.oliveira@email.com","cpf":"98765432100","numeroCelularddd":"11","numeroCelular":"987654321"}'

// Cadastrar paciente
using (var client = new HttpClient())
{
  client.BaseAddress = new Uri(baseURL);
  client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", token);
  
  var paciente = new {
      nome = "Maria Oliveira",
      dataNascimento = "25/08/1990",
      email = "maria.oliveira@email.com",
      cpf = "98765432100",
      numeroCelularddd = "11",
      numeroCelular = "987654321"
  };
  
  var response = await client.PutAsJsonAsync("Medware/Paciente/Atualizar", paciente);
  var codPaciente = await response.Content.ReadAsAsync(); // Retorna o ID do paciente
}

Procedimentos

Listar Procedimentos

JavaScript

cURL

// Listar procedimentos
const response = await fetch(`${baseURL}/Medware/ProcedPlanoOp/Listar?codMedico=123&codPlano=456&codUnidade=789&dataInicio=01/01/2023&dataFim=31/12/2023`, {
  headers: {
    'Authorization': `Bearer ${token}`
  }
});

const procedimentos = await response.json();

curl -X GET "${baseURL}/Medware/ProcedPlanoOp/Listar?codMedico=123&codPlano=456&codUnidade=789&dataInicio=01/01/2023&dataFim=31/12/2023" \
  -H "Authorization: Bearer SEU_TOKEN"

// Listar procedimentos
using (var client = new HttpClient())
{
  client.BaseAddress = new Uri(baseURL);
  client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", token);
  
  var response = await client.GetAsync("Medware/ProcedPlanoOp/Listar?codMedico=123&codPlano=456&codUnidade=789&dataInicio=01/01/2023&dataFim=31/12/2023");
  var procedimentos = await response.Content.ReadAsAsync();
}

Dicas Importantes

Sempre inclua o token JWT no cabeçalho Authorization
Trate os erros adequadamente (status 400, 401, 404, etc.)
Implemente renovação automática do token quando estiver perto de expirar
Para produção, armazene credenciais de forma segura (não no código)
Formato de datas: dd/MM/yyyy para parâmetros de URL

Dúvidas Comuns

Autenticação e Segurança

Como obtenho minhas credenciais de acesso?

As credenciais são fornecidas após a aprovação do cadastro como desenvolvedor. Entre em contato com nosso suporte técnico para solicitar acesso.

Quanto tempo um token JWT permanece válido?

Os tokens têm validade de 15 minutos. Recomendamos implementar lógica de renovação automática quando o token estiver perto de expirar (últimos 5 minutos).

Posso usar o mesmo token para múltiplas requisições?

Sim, até sua expiração. Porém, para maior segurança, recomendamos gerar novos tokens periodicamente.

Erros e Soluções

Como tratar erros de validação (status 400)?

Erros 400 incluem detalhes dos campos inválidos no corpo da resposta. Sempre verifique a estrutura de erro:

{
  "error": "ValidationError",
  "message": "Dados inválidos",
  "details": [
      {
          "field": "email",
          "message": "Deve ser um email válido"
      }
  ]
}

O que significa o erro 503 (Service Unavailable)?

Indica que nosso serviço está temporariamente indisponível.

Suporte

Como reportar um problema?

Para problemas técnicos, abra um ticket em nosso WhatsApp incluindo:

Endpoint acessado
Parâmetros utilizados
Token de requisição (sem o valor real)
Logs de erro (se aplicável)

Documentação da API Medware

Bem-vindo à documentação da API Medware, uma ferramenta para facilitar a gestão de agendamentos e informações médicas. Nossa API oferece um conjunto abrangente de endpoints que permitem:

Autenticação segura com tokens JWT
Gestão completa de agendamentos médicos com consulta de horários disponíveis
Acesso ao catálogo de médicos e especialidades disponíveis em todas as unidades
Cadastro e atualização de pacientes de forma simples e rápida
Consulta de procedimentos por médico, plano, unidade e especialidade
Obtenção de resultados em formato PDF
Avaliação de atendimento com geração de links para pesquisa de satisfação

REST API

Versão Estável

Atualizado: Maio 2025

Início Rápido

Comece rapidamente com exemplos de código prontos para uso.

Ver guia

Autenticação

Aprenda a autenticar suas requisições com nossa API.

Ver guia

Token JWT

Digite 'Bearer' [espaço] e, em seguida, seu token na entrada de texto.

Medware WebApi

Documentação

Documentação da API Medware

Início Rápido

Autenticação

Recursos da API

Documentação

Início Rápido

Autenticação

Renovar Token

Agendamento

Listar Agendamentos

Criar Agendamento

Médicos e Especialidades

Listar Médicos

Listar Especialidades

Pacientes

Criar/Atualizar Paciente

Procedimentos

Listar Procedimentos

Dicas Importantes

Perguntas Frequentes (FAQ)

Dúvidas Comuns

Autenticação e Segurança

Como obtenho minhas credenciais de acesso?

Quanto tempo um token JWT permanece válido?

Posso usar o mesmo token para múltiplas requisições?

Erros e Soluções

Como tratar erros de validação (status 400)?

O que significa o erro 503 (Service Unavailable)?

Suporte

Como reportar um problema?

Documentação da API Medware

Início Rápido

Autenticação

Recursos da API

Guia de Autenticação