Crear token para restablecer la contraseña

Versión 4.0.23.2

Crea un token para restablecer la contraseña.

Esto creará un token de restablecimiento de contraseña aleatorio seguro a nivel criptográfico para el usuario. Si el usuario ya tiene un token de restablecimiento de contraseña, se invalidará el anterior y se creará uno nuevo. El token se expresa como la "password_reset_url" del objeto de la credencial de correo electrónico/contraseña del usuario. Se toma un parámetro opcional de "vence" para indicar si el token nuevo debe ser próximo a vencerse. Los tokens vencidos suelen usarse para el restablecimiento de contraseñas de autoservicio en el caso de usuarios existentes. Por lo general, los correos electrónicos de invitación para usuarios nuevos no están configurados para vencer. El período de vencimiento siempre es de 60 minutos cuando la opción de vencimiento está habilitada. Se puede llamar a este método con un cuerpo vacío.

Solicitud

POST /users/{user_id}/credentials_email/password_reset
Tipo de datos
Descripción
Solicitud
HTTPRequest
ruta
Ruta de HTTP
Expandir la definición HTTPPath...
user_id
string
ID del usuario
verá la consulta cuando se guarde
HTTPQuery
Expandir definición de HTTPQuery...
fecha de vencimiento
booleano
El token está por vencer.
campos
string
Campos solicitados.

Respuesta

200: credencial de correo electrónico/contraseña

Tipo de datos
Descripción
que pueden
objeto
Operaciones que el usuario actual puede realizar en este objeto
creado_en
string
Marca de tiempo para la creación de esta credencial
correo electrónico
string
Dirección de correo electrónico utilizada para el acceso del usuario
forzar_contraseña_restablecer_acceso_siguiente
booleano
Forzar al usuario a cambiar su contraseña la próxima vez que acceda
user_id
string
ID único del usuario
está_inhabilitado
booleano
¿Se inhabilitó esta credencial?
se accedió
string
Marca de tiempo del acceso más reciente con credencial
URL_restablecimiento_de_contraseña
string
URL con un token secreto de uso único que el usuario puede usar para restablecer la contraseña
URL_configuración_cuenta
string
URL con un token secreto de uso único que el usuario puede utilizar para configurar la cuenta
tipo
string
Nombre corto del tipo de este tipo de credencial
url
string
Vínculo para obtener este elemento
URL_usuario
string
Vínculo para obtener este usuario

400: Bad Request

Tipo de datos
Descripción
(objeto)
mensaje,
string
Detalles del error
url_documentación
string
Vínculo a la documentación

403: Permiso denegado

Tipo de datos
Descripción
(objeto)
mensaje,
string
Detalles del error
url_documentación
string
Vínculo a la documentación

404: No encontrado

Tipo de datos
Descripción
(objeto)
mensaje,
string
Detalles del error
url_documentación
string
Vínculo a la documentación