[Visualizar] Atualizar senha de usuário

Atualiza a senha para os usuários especificados.

Ponto de Extremidade da API

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

Escopos

Requer os seguintes escopos:

• PM.User
• PM.User.Write

Cabeçalhos de solicitação.

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

Observação: para obter o {access_token}, certifique-se de se autenticar por meio de um dos métodos descritos aqui.

Parâmetros do caminho

Parâmetro do caminho	Tipo de dados	Description
userId (obrigatório)	String	A ID do usuário para o qual você deseja atualizar a senha.

Corpo da Solicitação

O corpo da solicitação contém a ID da organização à qual você deseja adicionar o usuário e, opcionalmente, os grupos que você deseja atribuir para adicionar seu usuário.

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

Resposta

200 OK

O usuário é criado na organização indicada e recebe uma ID.

400 Bad Request

O defeito não pôde ser criado.

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

Exemplo de solicitação

Digamos que você reuniu todas as informações necessárias para criar a chamada de API.

• Seu {baseURL} é: https://{yourDomain}/{organizationName}/{tenantName}/
• Seu {access_token} é: 1234 (para considerações de comprimento).
• O {userId} é: har-3107

A chamada deve ter a seguinte aparência (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"
}'

Aqui está a resposta de uma chamada bem-sucedida:

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