> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Advertències i codis de risc d'estimació d'edat

> Codis de risc d'estimació d'edat a Didit: consulta AGE_BELOW_MINIMUM, LOW_LIVENESS_SCORE, NO_FACE_DETECTED, llindars i accions.

La funcionalitat d'Estimació d'edat emet **advertències** sempre que s'activa un senyal de risc en la comprovació combinada d'edat i prova de vida passiva: l'edat estimada està per sota del teu mínim, no s'ha pogut calcular l'edat, el subjecte no ha superat la prova de vida, no s'ha trobat cap cara o s'ha detectat un atac de presentació. Aquesta pàgina enumera tots els codis, què els activa i com configurar la resposta del flux de treball.

## Visió general

L'Estimació d'edat sempre executa **dues comprovacions en una sola crida** —una prova de vida passiva i un model de regressió d'edat—, de manera que les seves advertències passen pel canal compartit de prova de vida i s'etiqueten amb la funcionalitat `LIVENESS`. Apareixen a l'informe a `age_estimation.warnings[]` (API independent) o a `liveness_checks[].warnings[]` (integrat en un flux de treball). L'esquema de l'objecte d'advertència està documentat a [Models de dades — Objecte d'advertència](https://docs.didit.me/ca/reference/data-models.md#objecte-d’advertència).

Generadors:

* **API independent** — l'endpoint genera les cinc advertències enumerades a [Activadors de denegació](#activadors-de-denegació).
* **Fluxos de treball** — els generadors compartits de prova de vida més les comprovacions específiques d'edat. Les advertències d'edat només s'activen en fluxos d'estimació d'edat (fluxos de treball adaptatius de verificació d'edat o nodes de flux de treball `AGE_ESTIMATION`); un pas simple de prova de vida informa d'una edat estimada però mai emet advertències d'edat.

Gravetats: els cinc riscos de denegació automàtica (`NO_FACE_DETECTED`, `LIVENESS_FACE_ATTACK`, `FACE_IN_BLOCKLIST`, `AGE_BELOW_MINIMUM`, `AGE_NOT_DETECTED`) són sempre `log_type: "error"` i forcen l'estat `Declined`; la resta de riscos donen lloc a `error` / `warning` / `information` segons els llindars o l'acció configurada.

## Activadors de denegació

A l'API independent, la decisió és `Declined` sempre que s'activi **qualsevol** advertència:

* **Edat per sota del llindar** — edat estimada estrictament per sota de `age_estimation_decline_threshold` (per defecte `18`; `0` desactiva la comprovació d'edat). Emet `AGE_BELOW_MINIMUM`.
* **Edat no calculada** — no s'ha pogut estimar l'edat de la cara (no hi ha cap cara detectable o no hi ha cap cara utilitzable per al model d'edat). Emet `AGE_NOT_DETECTED`.
* **Puntuació de prova de vida igual o inferior al llindar** — `score <= face_liveness_score_decline_threshold` (per defecte `30`); una puntuació `null` compta com a `0`. Emet `LOW_LIVENESS_SCORE`. Se suprimeix quan s'activa `NO_FACE_DETECTED` (tots dos s'exclouen mútuament).
* **No s'ha detectat cap cara** — el model de prova de vida no ha trobat cap cara. Emet `NO_FACE_DETECTED`.
* **Atac de presentació** — el model de prova de vida ha detectat una pantalla, una foto impresa, una màscara o una altra suplantació. Emet `LIVENESS_FACE_ATTACK`.

Als fluxos de treball, les comprovacions d'edat comparen l'edat estimada truncada (anys enters) amb els llindars configurats:

* **Amb alternativa de verificació d'identitat activada** (`enable_id_verification_fallback`, activada per defecte): una edat per sota de `borderline_minimum_age_threshold` (per defecte `18`) emet `AGE_BELOW_MINIMUM`; les edats a la franja límit (fins a `borderline_maximum_age_threshold`) passen a la verificació del document en lloc d'emetre una advertència, i mai s'emet `AGE_NOT_DETECTED` (una edat no detectada també es redirigeix cap a la verificació del document).
* **Amb l'alternativa desactivada**: si no hi ha cap edat estimada, s'emet `AGE_NOT_DETECTED`, i una edat per sota de `minimum_age_threshold` (per defecte `18`) emet `AGE_BELOW_MINIMUM`.

## Riscos configurables

Els riscos següents et permeten ajustar els llindars o l'acció segons la configuració del flux de treball:

| Configuració | Codi de risc | Opcions configurables |
| - | - | - |
| Llindars d'edat | `AGE_BELOW_MINIMUM` | Independent: `age_estimation_decline_threshold` (per defecte `18`, `0` el desactiva). Fluxos de treball: `minimum_age_threshold` / `borderline_minimum_age_threshold` (per defecte `18`) més l'alternativa de verificació d'identitat per a edats límit. |
| Puntuació baixa de prova de vida | `LOW_LIVENESS_SCORE` | **Llindar de denegació** (per defecte `30` → `error` + denegació) i **Llindar de revisió** (per defecte `60` → `warning` + revisió) independents aplicats a la puntuació de prova de vida. |
| Possible cara duplicada | `POSSIBLE_DUPLICATED_FACE` | Acció en cas de detecció: `DECLINE` / `REVIEW` / `NO_ACTION` (per defecte `NO_ACTION`). Només en sessions de fluxos de treball. |
| Múltiples cares | `MULTIPLE_FACES_DETECTED` | Acció en cas de detecció: `DECLINE` / `REVIEW` / `NO_ACTION` (per defecte `NO_ACTION`). Només en prova de vida passiva de fluxos de treball. |

Les sessions de fluxos de treball també comproven la cara amb les teves llistes: `FACE_IN_BLOCKLIST` sempre denega automàticament (`error`), mentre que `POSSIBLE_FACE_IN_BLOCKLIST` passa la sessió a `In Review`.

## Advertències generades

| Tag | Severitat (`log_type`) | Descripció |
| - | - | - |
| `AGE_BELOW_MINIMUM` | `error` — rebuig automàtic | L'edat estimada està per sota del llindar actiu (independent `age_estimation_decline_threshold`; flux de treball `minimum_age_threshold` / `borderline_minimum_age_threshold`; tots per defecte `18`). `additional_data` és sempre `null`. |
| `AGE_NOT_DETECTED` | `error` — rebuig automàtic | No s'ha pogut estimar l'edat de cap rostre. L'API independent sempre la genera quan l'edat és `null`; en fluxos de treball només quan l'alternativa de verificació d'identitat està desactivada. |
| `LOW_LIVENESS_SCORE` | `error` en o per sota del llindar de rebuig; `warning` en o per sota del llindar de revisió | La puntuació de prova de vida està en o per sota del llindar configurat (el valor per defecte del rebuig per a l'API independent i el flux de treball és `30`; el valor per defecte de revisió del flux de treball és `60`), la qual cosa indica un possible ús d'una foto estàtica, una pantalla o un vídeo. No es genera quan s'activa `NO_FACE_DETECTED`. |
| `NO_FACE_DETECTED` | `error` — rebuig automàtic | No s'ha detectat cap rostre a la imatge enviada. Demana de nou a l'usuari que centri la càmera amb una il·luminació adequada. |
| `LIVENESS_FACE_ATTACK` | `error` — rebuig automàtic | El model de prova de vida ha marcat un atac de presentació (reproducció en pantalla, foto impresa, màscara, deepfake). |
| `MULTIPLE_FACES_DETECTED` | Segons l'acció configurada (per defecte `information`, cap acció) | S'ha trobat més d'un rostre a la imatge; el rostre més gran determina el resultat. Només en la prova de vida passiva dels fluxos de treball; l'API independent no la genera. |
| `FACE_IN_BLOCKLIST` | `error` — rebuig automàtic | El rostre detectat coincideix amb una entrada de la teva llista de bloqueig facial gestionada mitjançant l'[API de llistes](https://docs.didit.me/ca/management-api/lists/overview.md). Només en sessions de flux de treball. |
| `POSSIBLE_DUPLICATED_FACE` | Segons l'acció configurada (per defecte `information`, cap acció) | El rostre detectat és significativament similar a un rostre aprovat prèviament en una altra sessió (s'exclouen les coincidències que comparteixen les mateixes `vendor_data`). Només en sessions de flux de treball. |

## Exemple

```json theme={null}
{
  "warnings": [
    {
      "risk": "LOW_LIVENESS_SCORE",
      "feature": "LIVENESS",
      "additional_data": null,
      "log_type": "error",
      "short_description": "Low liveness score",
      "long_description": "The liveness check resulted in a low score, indicating potential use of non-live facial representations or poor-quality biometric data."
    },
    {
      "risk": "AGE_BELOW_MINIMUM",
      "feature": "LIVENESS",
      "additional_data": null,
      "log_type": "error",
      "short_description": "Age below minimum",
      "long_description": "The age of the face is below the minimum age threshold for the application."
    }
  ]
}
```

Als payloads de decisió del flux de treball (`liveness_checks[].warnings[]`), cada advertència també inclou un `node_id` que identifica el node del flux de treball que la va generar.

## Tipus d'advertència

A cada risc se li assigna una severitat en funció de la configuració de la teva aplicació. Les severitats es divideixen en tres categories:

## Contingut relacionat

* [Visió general de l'estimació d'edat](https://docs.didit.me/ca/core-technology/age-estimation/overview.md) — comportament de la funcionalitat, preus i lògica de decisió.
* [Informe de l'estimació d'edat](https://docs.didit.me/ca/core-technology/age-estimation/report-age-estimation.md) — format complet de la resposta tant per a l'API independent com per al valor integrat al flux de treball.
* [Referència de l'API independent](https://docs.didit.me/ca/standalone-apis/age-estimation.md) — sol·licitud i resposta de `POST /v3/age-estimation/`.
* [Prova de vida passiva](https://docs.didit.me/ca/core-technology/liveness/overview.md) — el model compartit de prova de vida utilitzat a les respostes d'estimació d'edat.
* [Models de dades — estimació d'edat](https://docs.didit.me/ca/reference/data-models.md#estimació-d’edat) — esquema canònic camp per camp.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.