Trust Center
Verifique os seus próprios utilizadores: documentos de identidade, correspondência facial e verificações de empresa.
Três métodos fazem a partir de código o que a janela Verificar alguém faz: abrir uma sessão, ler uma sessão e listar sessões. Cada um atua no Trust Center da conta cuja chave de API usa.
Abra uma sessão
Chame verify_session_create. Envie level (1 a 4, por omissão 2) e, se quiser, a sua própria external_ref (200 carateres no máximo). A resposta traz um session_id, um hosted_url para enviar à pessoa e expires_at, que é 24 horas depois.
Envie a ligação
Redirecione o seu utilizador para hosted_url, ou envie-lha.
Leia o resultado
Chame verify_session_result com o session_id. Devolve o status, a sua external_ref, as horas e o result quando a sessão estiver concluída.
O que decide a sessão
- O modo. Uma sessão é de teste quando o serviço corre em modo de teste, e live quando corre em Live. As sessões de teste são gratuitas, nunca são contadas e podem ser terminadas a partir do dashboard. As ligações live ainda não podem ser concluídas.
- O nível. Um nível acima do que o seu plano permite é recusado, indicando qual o plano que o inclui. O pedido nunca é reduzido em silêncio.
- Acima da franquia. Uma sessão live acima da franquia mensal do seu plano é recusada no Free e, num plano pago, é criada e marcada como excedente.
As chaves criam-se em Programadores, e criar uma exige o seu próprio Nível 2.
Webhooks
No Starter e acima, defina um endereço nas definições do Trust Center e é enviado um pedido assinado quando uma verificação é decidida, para não ter de fazer polling. Cada um traz um cabeçalho Xuda-Event e um cabeçalho Xuda-Signature composto por uma data e hora e um HMAC da data e hora e do corpo, assinado com o segredo mostrado uma vez nas definições. Uma entrega que falha é repetida, até cinco tentativas.