Change Password
This method sends a password reset email to a player. use gateway.[msdomain]
Request (PUT)
/gateway/admission/{version}/player/{brand_id}/change/password
Parameters:
{
"old_password": "string",
"new_password": "string"
}| Name | In | Type | Required | Description |
|---|---|---|---|---|
| version | path | string | true | The API version to use. |
| brand_id | path | int | true | The ID of the casino. If a brand_id is not provided, all message formats will be fetched from default storage. |
| x-auth-token | header | string | true | Player login session. |
| old_password | body | string | true | player old password for verification. |
| new_password | body | string | true | player new password. |
Response
Status 202
{
"message_format": "password_replaced"
}Status 303
{
"“message_format”": "“tnc_approval_required”"
}Status 400
{
"errMsg": "invalid input - invalid brand id"
}If you receive a 422 error code for an Unprocessable Entity error, the client should not use the Message Format method to send a request to the server, but use its internal logic to present the message for one or more fields that didn’t pass the validation.
When a 422 validation error occurs, the response returns an array of one or more error codes detailing the fields that have validation errors. Multiple error messages are issued in the same validation form. The site should handle these validation errors and present a validation message to the player.
This will not call the message format.
The following table explains validation code behavior:
| Field | Error Code | Description |
|---|---|---|
| password | password_short | The password is too short. It must have at least 8 characters, including a combination of digits and letters. It should also contain at least 4 different characters. |
| password | password_long | Password cannot exceed 15 characters. |
| password | password_match_user_name | Password must be different from the email and username. |
| password | password_same_letters | Password has too many repeating characters. It must have at least 8 characters, including a combination of digits and letters. It should also contain at least 4 different characters. |
| password | password_mix_characters | The password must have a combination of letters and digits. |
| password | wrong_old_password | The verification password entered is not valid. |
{
"message_format": "wrong_old_password"
}Status 500
{
"result": "internal server error"
}Response Parameters:
| Name | Description |
|---|---|
| message_format | Message format to be displayed taken from Message Format. |