GET/api/medical-specialties

Especialidades

O catálogo de especialidades e áreas de atuação reconhecidas pelo CFM (Resolução nº 2.221/2018 e posteriores), em ordem alfabética. É o mesmo para todas as clínicas.

Exige o token de acesso — como obter

Headers

Nome	Tipo	Obrig.	Descrição
`Authorization`	string	Sim	Bearer {access_token}, com o token que o login devolve.

Query string

Nome	Tipo	Obrig.	Descrição
`kind`	string	Não	especialidade ou area_atuacao. Sem ele, as duas.
`include_inactive`	string	Não	true para incluir as que saíram do catálogo.

Campos da resposta

Nome	Tipo	Descrição
`[ ]`	array	As especialidades.

Request URL

https://api-endosystem.imagemais.com.br/api/medical-specialties?kind=especialidade

curl -X GET "https://api-endosystem.imagemais.com.br/api/medical-specialties?kind=especialidade" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Respostas

[
  {
    "id": "8b1d3f5a-7c9e-4b2d-a4f6-8b0d2f4a6c8e",
  ...

[
  {
    "id": "8b1d3f5a-7c9e-4b2d-a4f6-8b0d2f4a6c8e",
    "name": "Ginecologia e Obstetrícia",
    "kind": "especialidade",
    "is_active": true
  },
  {
    "id": "0c2e4a6b-8d0f-4c3e-b5a7-9c1e3a5b7d9f",
    "name": "Ultrassonografia Geral",
    "kind": "area_atuacao",
    "is_active": true
  }
]

{
  "error": "Token ausente",
  "message": "Token de autenticação necessário.",
  ...

{
  "error": "Token ausente",
  "message": "Token de autenticação necessário.",
  "code": "TOKEN_MISSING"
}

{
  "error": "Token expirado",
  "message": "Sua sessão expirou. Faça login novamente.",
  ...

{
  "error": "Token expirado",
  "message": "Sua sessão expirou. Faça login novamente.",
  "code": "TOKEN_EXPIRED"
}

{
  "error": "Token inválido",
  "message": "Token de autenticação inválido. Faça login novamente.",
  ...

{
  "error": "Token inválido",
  "message": "Token de autenticação inválido. Faça login novamente.",
  "code": "TOKEN_INVALID"
}

{
  "error": "Acesso revogado",
  "message": "Seu acesso foi desativado. Procure o administrador da clínica.",
  ...