[Vista previa] Actualizar la contraseña de un usuario

Actualiza la contraseña de los usuarios especificados.

Punto final de API

POST https://{yourDomain}/identity/api/User/{userId}/changepassword

Ámbitos

Necesita los siguientes ámbitos:

• PM.User
• PM.User.Write

Solicitar encabezados.

--header 'Authorization: Bearer {access_token}'\
--header 'Content-Type: application/json'

Nota: para obtener el {access_token}, asegúrate de autenticar a través de uno de los métodos descritos aquí.

Parámetros de ruta

Parámetros de ruta	Tipo de datos	Descripción
userId (obligatorio)	Cadena	El ID del usuario cuya contraseña quieres actualizar.

Solicitar cuerpo

El cuerpo de la solicitud contiene el ID de la organización a la que quieres añadir al usuario y, de manera opcional, los grupos a los que quieres añadirlo.

{
  "oldPassword": "string",
  "newPassword": "string"
}

Respuesta

200 OK

Se creará el usuario en la organización indicada y recibirá un ID.

400 Bad Request

No se pudo crear el usuario.

{
    "errors": {
        "bypassBasicAuthRestriction": [
            "Unexpected character encountered while parsing value: h. Path 'bypassBasicAuthRestriction', line 17, position 35.",
            "Unexpected character encountered while parsing value: a. Path 'bypassBasicAuthRestriction', line 17, position 35."
        ]
    },
    "type": "https://tools.ietf.org/html/rfc7231#section-6.5.1",
    "title": "One or more validation errors occurred.",
    "status": 400,
    "traceId": "00-aec3de9099a9934e9c31e26c19f5e0dd-8c0d3d5f476c7742-00"
}

Solicitud de ejemplo

Supongamos que has recopilado toda la información necesaria para crear la llamada a la API.

• Tu {baseURL} es: https://{yourDomain}/{organizationName}/{tenantName}/
• Tu {access_token} es: 1234 (para consideraciones de longitud)
• El {userId} es: har-3107

La llamada debe ser similar a lo que mostramos a continuación (cURL):

curl --location --request POST 'https://{yourDomain}/{organizationName}/{tenantName}/identity_/api/User/har-3107/changepassword' \
--header 'Authorization: Bearer 1234' \
--header 'Content-Type: application/json'
--data-raw '{
  "oldPassword": "al0h0m0ra-account",
  "newPassword": "patr0nu5"
}'

Esta es la respuesta para una llamada exitosa:

{
    "succeeded": true,
    "errors": []
}