Obtenir la politique d'âge

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

Renvoie la politique d'âge de l'environnement (une ressource par environnement ; pas de surcharge par application). Si la politique n'a jamais été écrite, les valeurs par défaut sont renvoyées (mode: off, min_age: 16, table des pays vide) avec ETag: "0" et updated_at: null. L'en-tête de réponse ETag porte la version à envoyer comme If-Match lors du PUT. Utilise les permissions des paramètres d'identité, car la politique d'âge en fait partie.

Requête

Cette opération ne prend aucun paramètre de chemin, de requête ni de corps. L'environnement provient de l'authentification.

Réponse

200 OK avec la politique et l'en-tête 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"
}

Erreurs

HTTP code Quand
401 unauthenticated L'authentification est manquante, invalide ou révoquée.
403 insufficient_permissions L'authentification manque la permission requise.
429 rate_limited La limite de débit a été dépassée ; réessayez après la période Retry-After.
503 service_unavailable Une dépendance est temporairement indisponible ; réessayez après la période Retry-After.

Exemple

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