Move-in Review

Last Updated on : 2023-06-21 07:13:12download

Confirm information such as the community ID, resident ID, and resident type, and review the move-in process of the relationship between a resident and a house.

API address

PUT: /v1.0/iot-02/community/room-user/{room_user_id}/move-in

Request parameter

Parameter nameTypeINRequiredDescription
room_user_idStringquerytrueThe ID of the relationship between a resident and a house.

Description of body

Parameter nameTypeINRequiredDescription
block_idString trueThe ID of a community.
householder_idString trueThe ID of a resident.
room_user_typeString trueThe type of resident.
  • HOUSEHOLDER: owner.
  • FAMILY: family member.
  • TENANT: tenant.
  • FRIEND: friend.
  • RELATIVES: relative
  • COLLEAGUE: colleague.
  • DECORATOR: decorator.
  • BABYSITTER: babysitter.
  • OTHER: others.
tree_idString trueThe value of treeId for a specified house.
room_user_stageInteger trueThe review tag.
  • 0: pending.
  • 10: rejected.
  • 20: approved (moved in).
  • 30: moved out.
audit_reasonString trueThe review opinions.
expire_dateString falseThe validity period. An empty value indicates that it is permanently valid.

Return parameter

Parameter nameTypeDescription
resultHighwayRoomUserOperateResponse

Description of result

Parameter nameTypeDescription
room_user_idStringThe ID of the relationship between a resident and a house.
successBooleanIndicates whether the operation is successful.
operationStringError cause.
  • Failed to create a resident.
  • Failed to edit a resident.
  • The system has automatically updated the resident information.
  • The resident already exists and is bound to the same house.
  • The mobile phone number already exists.
  • Cannot be added repeatedly.

Request example

PUT: /v1.0/iot-02/community/room-user/136767399153950xxxx/move-in
{
  "block_id": "138258104436502xxxx",
  "room_user_type": "FAMILY",
  "householder_id": "138258104436502xxxx",
  "expire_date": 1621587021161,
  "tree_id": "138258404436502xxxx",
  "room_user_stage": 20,
  "audit_reason": "Agree"
}

Return example

true

Error code

For more information, see error code.