fetch, inclui builds em ES module e CommonJS e não tem dependências de runtime. Consulte a visão geral dos SDKs de servidor para saber o que todos os SDKs têm em comum.
Instalação
@didit-protocol/sdk-node no npm. O código-fonte e o changelog estão em didit-protocol/sdk-node no GitHub.
Configurar o cliente
new Didit() lê DIDIT_API_KEY do ambiente em Node.js, Bun e Deno (com --allow-env). Runtimes de edge não têm ambiente de processo, então, nesses casos, passe a chave como opção: new Didit({ apiKey: env.DIDIT_API_KEY }). Passe opções para substituí-la ou para definir os IDs de organização e de aplicação exigidos pelas chamadas no escopo da aplicação (casos, redes, relatórios regulatórios). O timeout é em milissegundos.
const { Didit } = require("@didit-protocol/sdk-node");.
Criar uma sessão
Crie uma sessão de verificação para um workflow e envie seu usuário para a URL dela. Os campos da requisição mantêm os nomes da própria API.Ler a decisão
Quando o usuário terminar a verificação (ou quando o webhook chegar), leia a decisão. Cada resultado de recurso de verificação é uma lista com uma entrada por nó do fluxo, e as datas e horas são objetosDate.
Verificar um webhook
Passe o corpo bruto (não o JSON já interpretado) e os cabeçalhos da requisição: um objetoreq.headers do Node.js ou do Express, um objeto Headers da Fetch API ou pares [name, value] (o tipo WebhookHeaders). verify retorna uma promise e é rejeitada com WebhookVerificationError para qualquer coisa que não seja uma entrega válida e recente.
express.raw({ type: "application/json" }) e chame handleWebhook(req.body, req.headers). Enquanto você faz a rotação do segredo, passe os dois: [newSecret, oldSecret]. Consulte Webhooks para ver os eventos e o esquema de assinatura.
Analisar uma transação
Envie um pagamento, saque ou transferência de cripto para o monitoramento de transações; a resposta traz o status e a pontuação de risco.Verificar tokens de Authentication
Authentication verifica, no seu backend, os tokens de acesso assinados pelo seu emissor de Authentication, sem chamar a Didit a cada requisição. Ele também troca códigos, renova tokens, verifica e revoga sessões e executa step-ups.
A verificação de tokens faz as checagens descritas em Verificar um token no seu servidor, usando o emissor e as chaves de assinatura da sua aplicação.