A documentação técnica das APIs está dividida em dois portais para sua consulta.
APIs Padrões OPIN
Para consultar a documentação técnica no padrão Swagger das APIs padrões especificadas pela estrutura do OPIN Brasil:
- Acesse a Área do Desenvolvedor OPIN;
- No menu lateral esquerdo selecione "Especificações de APIs"
- Selecione o agrupamento de APIs desejado. Por exemplo para consultar a API de dados de seguro Auto, selecione "Fase 2 - Dados relacionados à movimentações"
- Selecione o sub-grupo desejado. Seguindo o exemplo acima, selecione "API - Auto"
- Selecione a versão desejada
- Por fim, selecione a opção "Informações Técnicas"
Nesta página será exibido a especificação técnica da API no padrão Swagger. Você poderá consultar os endpoints especificados, padrões de corpo das chamadas e respostas, códigos de erros e schema dos dados relacionados.
Para consultar o Schema dos dados transacionados:
- Selecione o endpoint desejado. Por exemplo para consultar os dados retornados de informações da apólice, selecione o endpoint que termina em "policy-info"
- Desça a tela até o exemplo de retorno de sucesso da chamada (código 200)
- Clique em "Schema"
- Aqui você poderá navegar pela estrutura da resposta, verificar a descrição de cada campo, se contém múltiplos valores, obrigatoriedade, entre outras informações
Os campos marcados com "*" são campos que obrigatoriamente serão retornados na resposta da transmissora
APIs Brick Insurance
Para consultar a documentação técnica das APIs exclusivas da plataforma Brick Insurance:
- Acesse o nosso Portal do Desenvolvedor
- Selecione o menu "API"
- No menu lateral esquerdo navegue até a API desejada. Por exemplo para consultar a documentação técnica da API de solicitação de consentimentos, navegue até "BRICK INSURANCE - RECEPTORA - COMPARTILHAMENTO DE DADOS V2" e selecione "Consentimento" e "Solicitação de Consentimento"
- Na tela exibida você poderá consultar todas as informações da especificação da API, incluindo os padrões de chamadas e respostas, códigos de erro, etc.
Comentários
0 comentário
Artigo fechado para comentários.