Envio de Formulários

Tópicos:

1 - URL base API

Ambientes	URL
Homologação	https://ms3.tapcore.com.br/mssuite/
Produção	https://ms3.tapcore.com.br/mssuite/

1.1 - Como configurar a URL de Callback

Acesse o seu painel administrativo em: painel.tapcore.com.br e no menu lateral busque a funcionalidade:

Beneficiário -> Nome da Feature -> Configuração

Preencha o campo: URL de Callback com a URL que receberá a requisição de callback após inserção de uma nova solicitação de cartão.

2 - Segurança das URLs

IMPORTANTE

Todas as imagens que estão sob nosso domínio não são disponibilizadas de forma pública, favor seguir as recomendações abaixo!

Por questões de segurança todas as imagens ou objetos disponíveis através de uma URL serão enviadas com uma assinatura, desta forma, o download dos objetos ou imagens disponíveis, só serão possíveis por um período de aproximadamente 15 minutos.

Recomenda-se que seja feito o download da imagem ou objeto assinado assim que receber este payload e não salve a URL pois ela ficará indisponível após o tempo pré-determinado.

Em casos que seja necessário o acesso a este objeto ou imagem depois desse período, re-envie o callback através do painel para receber uma nova assinatura válida por mais 15 minutos

Exemplo da url ->https://autorizacao.s3-sa-east-1.amazonaws.com/AWSAccessKeyId=ABC&Expires=1616095118&Signature=ABCD

3 - Endpoints

Feature	Endpoint	Método	Descrição
Atualização Cadastral	formulario/submit_formulario	PUT	Responsável por inserir uma nova solicitação de atualização cadastral para análise, o beneficiário envia seus dados pessoais, correções e alterações de seu cadastro e arquivos de comprovante.

Feature	Endpoint	Método	Descrição
2 via de Cartão	solicitacao/solicitacao_cartao	PUT	Responsável por inserir uma nova solicitação de segunda via de cartão para análise, o beneficiário informa os beneficiários que desejam novos cartões, motivo e forma de entrega, por fim os administradores autorizam ou não a segunda via.

Feature	Endpoint	Método	Descrição
Reembolso	reembolso/inserir	POST

Endpoint	Método	Descrição
v4/post_grupo	PATCH	Descrição do método PATCH.

Endpoint	Método	Descrição
v4/post_grupo	DELETE	Descrição do método DELETE.

3- Parâmetros query string

Parâmetro	Obrigatório	Tipo	Descrição
id_operadora	true	Inteiro	Id da operadora para a qual serão buscados os grupos de menu
mshash	true	String	HASH que identifica de qual ambiente (Homologação ou Produção) os dados serão buscados.

4- Exemplo de retorno API (Sucesso)

Retorno API sucesso Expandir origem

[ { "id_cms_menu_site_grupo": 34, "nome": "Área do Beneficiário", "chave": "area-do-beneficiario", "base_url_producao": "http://localhost:8080/#/", "base_url_homologacao": "http://localhost:8080/#/", "base_url_dev": "http://localhost:8080/#/", "id_operadora": 165, "id_aplicacao": 7, "qtd_niveis": 1 }, { "id_cms_menu_site_grupo": 35, "nome": "Área do Conveniado", "chave": "area-do-conveniado", "base_url_producao": "http://localhost:8080/#/", "base_url_homologacao": "http://localhost:8080/#/", "base_url_dev": "http://localhost:8080/#/", "id_operadora": 165, "id_aplicacao": 7, "qtd_niveis": 1 }, { "id_cms_menu_site_grupo": 33, "nome": "Menu do Rodapé", "chave": "menu-do-rodape", "base_url_producao": "http://homologacao.tapcore.com.br/mssuite/site/site-mutua/frontend/", "base_url_homologacao": "http://homologacao.tapcore.com.br/mssuite/site/site-mutua/frontend/", "base_url_dev": "http://localhost:8080/#/", "id_operadora": 165, "id_aplicacao": 7, "qtd_niveis": 2 }, { "id_cms_menu_site_grupo": 31, "nome": "Menu do Topo", "chave": "menu-do-topo", "base_url_producao": "http://homologacao.tapcore.com.br/mssuite/site/site-mutua/frontend/", "base_url_homologacao": "http://homologacao.tapcore.com.br/mssuite/site/site-mutua/frontend/", "base_url_dev": "http://localhost:8080/#/", "id_operadora": 165, "id_aplicacao": 7, "qtd_niveis": 3 }, { "id_cms_menu_site_grupo": 36, "nome": "Menu Topo Botões", "chave": "menu-topo-botoes", "base_url_producao": "http://localhost:8080/#/", "base_url_homologacao": "http://localhost:8080/#/", "base_url_dev": "http://localhost:8080/#/", "id_operadora": 165, "id_aplicacao": 7, "qtd_niveis": 2 } ]

5- Exemplo de retorno API (Erro)

Retorno API falha Expandir origem

{ "error": "Erro: Cliente não encontrado.", "code": 0, "status": false }

ATENÇÃO

Esse endpoint não possui retorno de erro mesmo enviando dados inválidos ele retorna como se não tivesse registro.Padrões documentação API