# On trobo la clau API, l'ID del flux de treball i el secret del webhook?

Source: https://help.didit.me/ca/integration/api-key-workflow-id-and-webhook-secret
Updated: 2026-11-12

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.

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

| Valor | On obtenir-lo | Què cal saber |
|---|---|---|
| **Clau API** | **Desenvolupadors → 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 treball** | **Verificació 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 webhook** | **Desenvolupadors → Webhooks**, obre l'endpoint, després el seu secret de signatura i prem **Mostra** | Un 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'API** | No és a la consola: la indica docs.didit.me | `https://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](https://docs.didit.me/getting-started/api-authentication) |

> **Note:** 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](https://help.didit.me/ca/getting-started/contacting-didit-support). 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](https://help.didit.me/ca/integration/webhooks-basics).

## 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](https://help.didit.me/ca/integration/api-errors).

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](https://help.didit.me/ca/integration/webhook-troubleshooting).

## Relacionat

- [Gestionar les teves claus API](https://help.didit.me/ca/account-organization/api-keys)
- [Rebre els resultats de la verificació amb webhooks](https://help.didit.me/ca/integration/webhooks-basics)
- [Com crear un flux de verificació](https://help.didit.me/ca/workflows/build-a-verification-workflow)
- [Autenticació de l'API](https://docs.didit.me/getting-started/api-authentication) a docs.didit.me