POST/api/patients

Criar Paciente

Cria um novo paciente

Access Token

Para realizar requisições GET, POST, PUT, DELETE e PATCH nos endpoints da API você precisa de uma chave de autorização. Chamamos essa chave de accessToken.

Para ter acesso ao accessToken, é necessário que o usuário master da licença efetue a liberação deste pela interface do ImageMais Clinic. O accessToken tem validade de 1 hora.

Headers

AuthorizationOBRIGATÓRIO
Tipo:string
Token de autenticação no formato Bearer {accessToken}
Content-TypeOBRIGATÓRIO
Tipo:string
Tipo de conteúdo (application/json)

Parâmetros

nameOBRIGATÓRIO
Tipo:string
Nome do paciente

Este parâmetro representa o nome do paciente que será utilizado na requisição. O nome é obrigatório e deve ser uma string válida.

Atenção: Caso o campo name seja removido da requisição, não seja fornecido ou esteja vazio, a API retornará um erro 400 Bad Request

dateBirthOPCIONAL
Tipo:string
Data de nascimento do paciente (formato: YYYY-MM-DD)

Este parâmetro representa a data de nascimento do paciente. O campo é opcional e pode ser omitido na requisição sem causar erros.

Formato:

dateBirth: "2000-01-01"

Atenção: Caso o campo dateBirth seja fornecido na requisição, ele deve estar no formato correto (YYYY-MM-DD) e ser uma data válida. Se o formato estiver incorreto ou a data for inválida, a API retornará um erro 400 Bad Request com a mensagem: "patient.dateBirth must be a Date instance".

genderOPCIONAL
Tipo:string
Gênero do paciente (M ou F)

Este parâmetro representa o gênero do paciente. O campo é opcional e pode ser omitido na requisição sem causar erros.

Valores aceitos:

  • M - Masculino
  • F - Feminino

Atenção: Caso o campo gender seja fornecido na requisição, ele deve conter um dos valores aceitos (M ou F). Se for passado um valor diferente ou inválido, a API retornará um erro 400 Bad Request.

rgOPCIONAL
Tipo:string
RG do paciente
cpfOPCIONAL
Tipo:string
CPF do paciente

Este parâmetro representa o CPF do paciente. O campo é opcional e pode ser omitido na requisição sem causar erros.

Observação sobre o CPF: O campo cpf é opcional. Caso não seja fornecido na requisição, o paciente será criado normalmente. No entanto, se o campo cpf for informado de forma inválida (formato incorreto, quantidade de caracteres insuficiente ou valores não numéricos), a API retornará um erro 400 Bad Request.

Atenção: Não é possível criar um paciente com o mesmo CPF. Caso seja fornecido um CPF que já existe no sistema, a API retornará um erro 409 Conflict com a mensagem: "Já existe um paciente com esse CPF".

addressOPCIONAL
Tipo:object
Endereço do paciente (objeto com street, number, district, city, state, cep, complement)
contactOPCIONAL
Tipo:object
Contato do paciente (objeto com phone, secondary_phone, email)

Request URL

https://api-dev.imagemais.com/api/patients
curl -X 'POST' \
  'https://api-dev.imagemais.com/api/patients' \
  -H 'accept: */*' \
  -H 'Authorization: Bearer string' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "João da Silva",
  "dateBirth": "2000-01-01",
  "gender": "M",
  "rg": "123456789",
  "cpf": "",
  "address": {
    "street": "Rua das Flores",
    "number": "123",
    "district": "Bairro Central",
    "city": "Recife",
    "state": "Pernambuco",
    "cep": "50000-000",
    "complement": "Apartamento 101"
  },
  "contact": {
    "phone": "string",
    "secondary_phone": "string",
    "email": "string"
  }
}'
{
  "name": "João da Silva",
  "dateBirth": "2000-01-01",
  ...
{
  "name": "João da Silva",
  "dateBirth": "2000-01-01",
  "gender": "M",
  "rg": "123456789",
  "cpf": "12345678912",
  "address": {
    "street": "Rua das Flores",
    "number": "123",
    "district": "Bairro Central",
    "city": "Recife",
    "state": "Pernambuco",
    "cep": "50000-000",
    "complement": "Apartamento 101"
  },
  "contact": {
    "phone": "string",
    "secondary_phone": "string",
    "email": "string"
  }
}

Respostas

{
  "id": 9267,
  "name": "João da Silva",
  ...
{
  "id": 9267,
  "name": "João da Silva",
  "gender": {
    "name": "M"
  },
  "dateBirth": "2000-01-01T00:00:00.000Z",
  "rg": "123456789",
  "cpf": null,
  "address": {
    "street": "Rua das Flores",
    "number": "123",
    "district": "Bairro Central",
    "city": "Recife",
    "state": "Pernambuco",
    "cep": "50000-000",
    "complement": "Apartamento 101"
  },
  "contact": {
    "phone": "string",
    "secondary_phone": "string",
    "email": "string"
  },
  "createdAt": "2025-12-04T14:08:26.676Z",
  "updatedAt": "2025-12-04T14:08:26.676Z",
  "deletedAt": null
}
{
  "message": [
    "patient.cpf must be longer than or equal to 11 characters",
  ...
{
  "message": [
    "patient.cpf must be longer than or equal to 11 characters",
    "patient.cpf must be a number string"
  ],
  "error": "Bad Request"
}
{
  "message": [
    "patient.name should not be empty",
  ...
{
  "message": [
    "patient.name should not be empty",
    "patient.name must be shorter than or equal to 200 characters",
    "patient.name must be a string"
  ],
  "error": "Bad Request"
}
{
  "message": [
    "patient.dateBirth must be a Date instance"
  ...
{
  "message": [
    "patient.dateBirth must be a Date instance"
  ],
  "error": "Bad Request"
}
{
  "message": [
    "gender must be one of the following values: M, F"
  ...
{
  "message": [
    "gender must be one of the following values: M, F"
  ],
  "error": "Bad Request"
}
{
  "message": [
    "Já existe um paciente com esse CPF"
  ...
{
  "message": [
    "Já existe um paciente com esse CPF"
  ],
  "error": "Conflict"
}
{
  "statusCode": 401,
  "message": "invalid token"
  ...
{
  "statusCode": 401,
  "message": "invalid token"
}
{
  "statusCode": 401,
  "message": "jwt expired"
  ...
{
  "statusCode": 401,
  "message": "jwt expired"
}
{
  "statusCode": 500,
  "message": "Internal server error"
  ...
{
  "statusCode": 500,
  "message": "Internal server error"
}