Change Member Mobile Phone

Changes a user's login mobile number.

Request parameters

Required: phone (old mobile number), new_phone (new mobile number)
See the field definitions for each field's format, allowed values, and business meaning.

Business notes

Replaces the user's current login mobile number phone with new_phone.

Risk warning

The login mobile number is a critical identity and login credential; changing it affects the user's sign-in and SMS notifications. Confirm both the old and new numbers before calling.

Result

On success, the login mobile number is changed. The resulting state is defined by the 200 response.

POSThttps://b-api.lbkrs.com/v1/whaleapi/member/change_mobile

Authorization

AuthorizationstringheaderRequired

Send the Broker ACCESS_TOKEN as Authorization: Bearer <token>.

Permission

account.approve_edit_member

The Broker ACCESS_TOKEN must be granted the permission above, or the call will be rejected.

Request body application/json

phoneobjectrequired

phone

Child attributes

country_codeintegerrequired

country_code

mobilestringrequired

mobile

new_phoneobjectrequired

new_phone

Child attributes

country_codeintegerrequired

country_code

mobilestringrequired

mobile

Responses

HTTP 200Success

codestring

messagestring

message

HTTP 400Bad request. Check the business error code in code and the error details in message.

Standard response envelopecodemessagedata

dataobjectdata structure

No nested fields

HTTP 401The user is not authenticated, or the login session has expired.

Standard response envelopecodemessagedata

dataobjectdata structure

No nested fields

HTTP 403The current account is not authorized to use this feature. Grant the required permission to the account in User Permission.

Standard response envelopecodemessagedata

dataobjectdata structure

No nested fields

HTTP 408The request timed out. Check the business error code in code and the error details in message.

Standard response envelopecodemessagedata

dataobjectdata structure

No nested fields

Request

curl --request POST \
  --url 'https://b-api.lbkrs.com/v1/whaleapi/member/change_mobile' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json'
  --data '{
  "phone": {
    "country_code": "HK",
    "mobile": "+85290000000"
  },
  "new_phone": {
    "country_code": "HK",
    "mobile": "+85290000000"
  }
}'

Response

{
  "code": "1",
  "message": "审核通过"
}