Ottieni la configurazione dell'ambiente

GET /fapi/v1/environment · chiamato dall'host di accesso dell'ambiente

Restituisce la configurazione pubblica di cui una pagina di accesso ha bisogno prima di aprire una transazione: i primi fattori che una nuova transazione dell'applicazione offrirà, la modalità di registrazione, le lingue abilitate e, quando vengono offerte le passkey, il rp_id della passkey. La risposta non contiene dati personali, non legge alcun cookie e non apre alcuna transazione.

Richiesta

Intestazioni:

Intestazione	Obbligatorio	Descrizione
`Idp-Client`	sì	Identificatore SDK, `<pacchetto>/<versione> (<runtime>/<versione>)`.

Parametri di query:

Parametro	Obbligatorio	Descrizione
`client_id`	sì	Il `client_id` dell'applicazione.

Risposta

200 OK:

Campo	Descrizione
`schema_version`	`1`.
`first_factors`	I metodi che una nuova transazione offre, in quest'ordine: `password`, `passkey`, `email_otp`, `magic_link`. Vuoto quando la policy non consente alcun metodo.
`sign_up`	Modalità di registrazione: `open`, `invite_only` o `closed`.
`locales`	`enabled` (lingue abilitate) e `default` (lingua predefinita).
`passkey`	Solo quando l'accesso con passkey è offerto: `rp_id`.

La risposta contiene Cache-Control: max-age=60; una modifica della policy è visibile entro un minuto.

Errori

Stato	Codice	Quando
400	`malformed_request`	`Idp-Client` è mancante.
403	`environment_suspended`	L'ambiente è sospeso.
403	`headless_not_allowed`	L'applicazione non è first party.
404	`not_found`	L'host non appartiene ad alcun ambiente.
422	`validation_failed`	`client_id` è mancante, troppo lungo o sconosciuto (`/client_id`).

Esempio

curl "https://example.keenauth.app/fapi/v1/environment?client_id=app_01j9zq3k5m7n8p9r0s1t2v3w4x" \
  -H "Idp-Client: my-app/1.0.0 (node/22.0.0)"

{
  "schema_version": 1,
  "first_factors": ["password", "passkey", "email_otp"],
  "sign_up": "open",
  "locales": {"enabled": ["tr", "en"], "default": "tr"},
  "passkey": {"rp_id": "example.keenauth.app"}
}