1.7 - formPreLoadData
Índice
- 1 Índice
- 2 Método “formPreLoadData”
- 2.1 Endpoint
- 2.2 Parâmetros de entrada
- 2.3 Exemplo request
- 2.4 Descrição dos objetos e atributos de retorno - Sucesso
- 2.5 Retorno da API - Sucesso
- 2.6 Integrando formPreLoadData ao FormBuilder
- 2.6.1 Aba API
- 2.6.2 Aba Dados (Json Injetado)
- 2.7 Visualização de resultado aplicado no App
- 2.7.1 Retorno da API - Falha
Só são suportadas integrações no padrão REST.
Método “formPreLoadData”
Atente-se as orientações fornecidas pela Mobile Saúde;
Atente-se aos critérios de preenchimento;
Atente-se aos critérios de objetos e atributos de retorno;
Atente-se as mensagens de retorno para cada HTTPS Status Code;
Esta integração sempre será executada antes de renderizar qualquer um formulário
Endpoint
Endpoint | Método | Header Content-Type | Descrição |
|---|---|---|---|
exemplo.com/formPreLoadData | POST | application/json | Endpoint de formPreLoadData. Importante: o nome do método é sugerido, podendo ser configurado com outro nome caso necessário. |
Parâmetros de entrada
Serão enviados no HEADER os headers estáticos definidos ao configurar a integração, combinado com os tokens retornados pela configuração de autorização da integração (caso seja vinculada) e os headers de segurança retornado no login do beneficiário.
Serão enviados no BODY os seguintes parâmetros:
Atributo | Obrigatoriedade | Tipo | Descrição |
|---|---|---|---|
chaveUnica | M | String | Chave de identificação do usuário retornada no login |
integracao | OP | Objeto | nó integração retornado no login |
numeroContrato | M | String | Código do contrato que do beneficiário que foi selecionado |
idFuncionalidade | M | String | Código da funcionalidade que está acionando a integração, deve ser utilizada para controlar quais dados são retornados |
Exemplo request
url:
https://www.operadoradesaude.com.br/mobilesaude/autenticacao/formPreLoadData
Body:
{
"chaveUnica": "String",
"integracao": {
"xpto": "voluptatibus",
"xyz": "quibusdam",
"abcdef": 9288701
},
"beneficiarioSelecionado": {
"chaveUnica": "String",
"integracao": {
"xpto": "voluptatibus",
"xyz": "quibusdam",
"abcdef": 9288701
},
"numeroContrato": "String"
},
"idFuncionalidade": "String",
}
Descrição dos objetos e atributos de retorno - Sucesso
Está indicado abaixo a estrutura de retorno do seu método login. Esse método deve obedecer as regras indicadas no objeto principal e em seus desdobramentos.
Atributo | Critério | Tipo | Descrição | Regra de preenchimento |
|---|---|---|---|---|
key | M | String | Definir nome para o atributo | Formato: Texto livre. |
value | M | String | Define valor para o atributo | Formato: Texto livre. |
Retorno da API - Sucesso
{
"teste1": "String",
"teste2": "String"
}
Integrando formPreLoadData ao FormBuilder
Aba API
Aba Dados (Json Injetado)
Visualização de resultado aplicado no App
Retorno da API - Falha
Atente-se as mensagens de retorno para cada HTTPS Status Code;
Siga as instruções de Descrição dos objetos e atributos de retorno - falha;