La clau API és a Desenvolupadors, Claus d'API; l'ID del flux, a Workflows; el secret de signatura del webhook és per endpoint a Desenvolupadors, Webhooks.

Resposta curta

Necessites tres valors de la consola. La clau API es crea a Desenvolupadors → Claus d'API. L'ID del flux de treball es copia de la pàgina Fluxos de treball. El secret de signatura del webhook pertany a cada endpoint a Desenvolupadors → Webhooks, i el pots tornar a mostrar quan vulguis amb Mostra. Agafa els tres de la mateixa aplicació i del mateix entorn, Live o Sandbox.

Una aplicació d'inici o un projecte generat amb IA sovint llista variables d'entorn com DIDIT_API_KEY, DIDIT_WORKFLOW_ID i DIDIT_WEBHOOK_SECRET. Els noms són d'aquesta aplicació: Didit no els defineix per tu. Aquesta taula diu d'on surt cada valor.

#On és cada valor

ValorOn obtenir-loQuè cal saber
Clau APIDesenvolupadors → Claus d'API, i després Crea una clau (cada aplicació també té una clau Principal)El secret complet es mostra una sola vegada, quan crees o rodes la clau, així que copia'l llavors al teu gestor de secrets. Una aplicació Live i una aplicació Sandbox tenen claus diferents: una clau de sandbox mai no crea una verificació live. Envia-la a la capçalera x-api-key, només des del teu servidor
ID del flux de treballVerificació d'identitat → Fluxos de treball: obre el menú de la fila i tria Copia l'ID del flux de treball (el panell de previsualització té el mateix botó)Cada flux de treball té el seu propi ID a cada aplicació. Una còpia d'un flux de treball rep un ID nou
Secret de signatura del webhookDesenvolupadors → Webhooks, obre l'endpoint, després el seu secret de signatura i prem MostraUn secret per endpoint, no per aplicació. Reveal et demana que confirmis que ets tu, i després el secret s'amaga de nou al cap de 60 segons. El pots tornar a mostrar sempre que ho necessitis
URL base de l'APINo és a la consola: la indica docs.didit.mehttps://verification.didit.me serveix l'API de verificació (sessions, fluxos de treball, llistes, webhooks), autenticada amb la capçalera x-api-key. Vegeu autenticació de l'API
Nota

La clau API i el secret de signatura són valors diferents. La clau API autentica les teves crides a Didit; el secret de signatura et permet comprovar que un webhook ve realment de Didit. Usar-ne un en lloc de l'altre dona un 401 o una discrepància de signatura.

#Puc tornar a veure el secret de signatura del webhook?

Sí. Obre Desenvolupadors → Webhooks, obre l'endpoint i prem Mostra. Confirma que ets tu, i el secret es mostra fins a 60 segons. Si Mostra està en gris, demana-ho a un company amb accés o contacta amb suport. Si vols un secret nou, rota'l: l'antic continua funcionant durant 24 hores. Més informació a rebre els resultats de la verificació amb webhooks.

#Comprova la teva configuració

  1. Fes coincidir l'entorn

    Tria primer l'aplicació i l'entorn Producció o Sandbox a la consola, i després copia-hi la clau, l'ID del flux de treball i crea-hi l'endpoint del webhook. Una clau de sandbox amb l'ID d'un flux de treball live és un motiu habitual d'un 401 o un 403.

  2. Posa els valors a la configuració del teu servidor

    Guarda'ls com a secrets del servidor. No posis mai la clau API ni el secret de signatura en codi de frontend, en un repositori públic ni en una aplicació mòbil.

  3. Crea una sessió

    Crida l'endpoint de creació de sessió a https://verification.didit.me amb la teva clau i l'ID del flux de treball. Un 401 vol dir que la clau és errònia, caducada o revocada; un 403 sobre un flux de treball sol voler dir que la clau pertany a una altra aplicació. Vegeu errors de l'API.

  4. Envia un esdeveniment de prova

    A Desenvolupadors → Webhooks, obre el teu endpoint i prem Envia un esdeveniment de prova. El teu servidor ha de comprovar la signatura amb el secret de signatura i respondre amb un 2xx. Si no arriba res, vegeu quan un webhook no arriba mai.

#Relacionat

Encara estàs encallat? Parla amb una persona.

Inclou l'ID de la teva organització i l'ID de la sessió sobre la qual preguntes.

Contacta amb el suport