Ottieni la policy sull'età

GET /v1/age-policy · permesso identity-settings:read

Restituisce la policy sull'età dell'ambiente (una risorsa per ambiente; nessuna sostituzione per applicazione). Se la policy non è mai stata scritta, vengono restituiti i valori predefiniti (mode: off, min_age: 16, tabella dei paesi vuota) con ETag: "0" e updated_at: null. L'header di risposta ETag contiene la versione da inviare come If-Match nel PUT. Usa i permessi delle impostazioni di identità, di cui la policy sull'età fa parte.

Richiesta

Questa operazione non accetta campi di percorso, query o body. L'ambiente deriva dalla credenziale.

Risposta

200 OK con la policy e l'header ETag.

{
  "mode": "attestation",
  "min_age": 16,
  "country_min_age": {"DE": 16, "FR": 15, "IT": 14},
  "country_source": "ip",
  "under_age_action": "block",
  "parental_consent_below": null,
  "pending_consent_action": "block_sign_in",
  "store_birthdate": false,
  "applies_to": "self_signup",
  "updated_at": "2026-10-05T09:30:00.123456Z"
}

Errori

HTTP	code	Quando
401	`unauthenticated`	La credenziale è mancante, non valida o revocata.
403	`insufficient_permissions`	La credenziale non ha il permesso richiesto.
429	`rate_limited`	Il limite di velocità è stato superato; riprova dopo il periodo `Retry-After`.
503	`service_unavailable`	Una dipendenza è temporaneamente non disponibile; riprova dopo il periodo `Retry-After`.

Esempio

curl https://api.eu.keenauth.com/v1/age-policy \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"