Die Altersrichtlinie abrufen

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

Gibt die Altersrichtlinie der Umgebung zurück (eine Ressource pro Umgebung; keine Überschreibung pro Anwendung). Wurde die Richtlinie nie geschrieben, werden die Tabellenstandards (mode: off, min_age: 16, leere Ländertabelle) mit ETag: "0" und updated_at: null zurückgegeben. Der ETag-Antwortheader enthält die Version, die bei PUT als If-Match zu senden ist. Verwendet die Berechtigungen der Identitätseinstellungen, da die Altersrichtlinie zu ihnen gehört.

Anfrage

Diese Operation nimmt keine Pfad-, Query- oder Body-Felder. Die Umgebung stammt aus den Anmeldedaten.

Antwort

200 OK mit der Richtlinie und dem ETag-Header.

{
  "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"
}

Fehler

HTTP	Code	Wann
401	`unauthenticated`	Die Anmeldedaten fehlen, sind ungültig oder wurden widerrufen.
403	`insufficient_permissions`	Die Anmeldedaten haben nicht die erforderliche Berechtigung.
429	`rate_limited`	Die Rate-Grenze wurde überschritten; Wiederhole nach dem `Retry-After`-Zeitraum.
503	`service_unavailable`	Eine Abhängigkeit ist vorübergehend nicht verfügbar; Wiederhole nach dem `Retry-After`-Zeitraum.

Beispiel

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