OneSpan Developer: Introdução à API da Sandbox de autenticação adaptativa inteligente

A API Sandbox de autenticação adaptativa inteligente (IAA) permite que os desenvolvedores integrem as soluções OneSpan, incluindo Autenticação adaptativa inteligente , Análise de risco e Autenticação na nuvem OneSpan , nos produtos para celular e na web para detectar melhor fraudes e melhorar a experiência do usuário. Você pode usar a API do IAA Sandbox para gerenciar usuários, validar eventos, atribuir autenticadores, provisionar dispositivos e muito mais.

Para facilitar a integração, todos os serviços no IAA Sandbox aderem à arquitetura REST. Além disso, há uma página de API interativa com a documentação do OpenAPI Swagger. Possui exemplos para ajudá-lo a entender cada um dos serviços e construir suas cargas JSON para explorar os diferentes pontos de extremidade. Neste blog, analisaremos como acessar a página da API interativa e usar a documentação do Open API Swagger.

Participe da comunidade OneSpan:

Antes de explorar a API interativa, você deve ser um membro da Comunidade OneSpan e se inscrever em uma conta gratuita da sandbox IAA. Confira nosso blog anterior ”Soluções OneSpan Cloud em ação - Demonstração do MyBank Web Portal, Parte 1” para aprender como fazê-lo.

Acesse a API interativa de autenticação adaptativa

Primeiro, faça login no Página da Comunidade OneSpan . Em seguida, na barra de navegação no canto superior direito, passe o mouse sobre o menu suspenso que exibe seu nome de usuário e clique em "Sandbox", que o direcionará para a página de detalhes da sua conta Sandbox.

Na página de detalhes da Sandbox, clique no link "API interativa de autenticação adaptativa", como mostra a captura de tela abaixo. Isso o levará à página da API da API do OpenAPI Swagger Interactive.

Ao clicar no link acima, você será direcionado para a página da API do OpenAPI Swagger Interactive API mostrada abaixo.

A página da API Interactive Swagger:

Na página API interativa, os pontos de extremidade serão agrupados por recursos. Por exemplo, o recurso autenticador abrangerá os pontos de extremidade para consultar, atribuir, remover a atribuição e todos os pontos de extremidade para manipular os autenticadores, conforme visto abaixo. Da mesma maneira, os outros recursos conterão seus pontos de extremidade relacionados, agrupados em uma abordagem lógica. 

A lista completa de recursos disponíveis na API interativa inclui:
Autenticadores
• Upload de arquivos em massa
• Comandos do dispositivo
Eventos
• Provisionamento
• Sessões
Transações
• Comercial
• códigos visuais

Cada ponto de extremidade na API é marcado por seu método HTTP, seja Get, Post, Put, Delete ou Patch. Esses pontos de extremidade podem ser testados na API interativa IAA. Além disso, o editor OpenAPI Swagger oferece a opção de editar convenientemente os parâmetros do caminho da URL com uma descrição para cada um desses parâmetros. Esta função é mostrada na captura de tela abaixo. Cada um desses parâmetros será marcado com um asterisco quando for necessário para cada nó de extremidade. 

Além disso, a API interativa apresentará a estrutura esperada e exemplos de 

• O corpo da solicitação JSON para cada nó de extremidade

• O corpo de resposta JSON para cada nó de extremidade

• O código de resposta esperado para uma chamada de serviço da web bem-sucedida ou incorreta. Por exemplo, um exemplo de um código de resposta 200 que indica uma solicitação bem-sucedida ou um exemplo de código de resposta 400 que indica um erro nos dados de entrada.

Os esquemas de API interativos

Uma das seções mais importantes da API interativa é a seção Esquema. Dentro, você encontrará todos os atributos que podem ser utilizados para cada nó de extremidade. Eles serão listados juntamente com seus tipos de dados e um exemplo para cada um dos campos de dados. Você notará que os atributos necessários estão marcados com um asterisco vermelho. Se um atributo não possui o asterisco, é um atributo opcional, que é desnecessário fornecer quando não é necessário no corpo da solicitação.

Saiba mais nos fóruns do portal da comunidade

Esta postagem do blog foi uma introdução à API do IAA Sandbox. Vimos como a página da API interativa é estruturada com um modelo de exemplo para cada chamada de terminal, como os terminais são agrupados em recursos e como explorar o esquema dos campos de dados. Nos próximos blogs, exploraremos cada um dos pontos de extremidade individualmente. Enquanto isso, se você tiver alguma dúvida, entre em contato conosco no Fóruns do Portal da Comunidade .

Comunidade de desenvolvedores OneSpan Sign

Participe da comunidade de desenvolvedores do OneSpan Sign! Fóruns, blogs, documentação, downloads de SDK e muito mais.

Junte-se hoje