A API professionals/{professionalCode}/professionalSpecialities tem como objetivo trabalhar com ações relacionadas as especialidades vinculadas a um profissional.
VERBO GET
Através do verbo GET, informamos o código do profissional como pathParam e as especialidades vinculados a ele são devolvidos.
Para iniciar a instalação do processo, devemos configurar seu INI Protheus com a funcionalidade REST para habilitar o acesso as API´s. Documentos auxiliares:
1. Configuração do REST do Protheus
Com o INI Protheus configurado, a nomenclatura das API´s ficará no formato: <url + Porta + chave rest definidos no INI Protheus> + /totvsHealthPlans/v1/professionals/{professionalCode}/professionalSpecialities. Exemplo:
Logo, a minha URL será: http://localhost:8080/rest/totvshealthplans/v1/professionals/{professionalCode}/professionalSpecialities.
Seguem os verbos disponíveis na API:
Verbo | Path | Descrição |
|---|---|---|
| GET | professionals/{professionalCode}/professionalSpecialities | Especialidades vinculadas ao profissional |
GET - ESPECIALIDADES VINCULADAS A UM PROFISSIONAL
Queryparams:
Atributo | Tipo | Regra | Descrição |
|---|---|---|---|
| pageSize | Caracter | Opcional | Controle de quantidade de itens que serão retornados. |
| page | Caracter | Opcional | Controle de paginação |
Chamada GET
Exemplo solicitando dados de especialidades vinculadas ao profissional 0000026:

Chamada GET
Atributo | Campo | Tipo |
|---|---|---|
| code | BTQ_CDTERM | Caracter |
| description | BTQ_DESTER | Caracter |
| specialtyDescription | BAQ_DESCRI | Caracter |
| specialtyCode | BQ1_CODESP | Caracter |
Solicitação GET
{
"items": [
{
"code": "225105",
"description": "Médico acupunturista",
"specialtyDescription": "Medico clinico",
"specialtyCode": "001"
},
{
"code": "225125",
"description": "Médico clínico",
"specialtyDescription": "Medico clinico",
"specialtyCode": "001"
}
],
"hasNext": true
} |
{
"code": 400,
"message": "Profissional informado nao encontrado",
"detailedMessage": "Entre em contato com o Suporte"
} |