RESTFUL API Doc - 사인인/로그인 등

https://sir.kr/so_app/1914에 이어서 

접미는 /api/v1 식으로 합니다.  v1은 버전 v1.1 또는 v2식으로.

단 서브도메인이 가능하다면 api.도메인.com/v1으로 접속도 가능합니다.

1. Registration 

POST /users. or /members

[code]

{
  "user":{                     /* g5_member */
    "username": "test",        /* mb_id */
    "email": "test@test.com",  /* mb_email */
    "password": "test1234",    /* mb_password */
    "confirm_password": "test1234",
    "firstname": "테스트",     /* mb_name */
    "lastname": "",
    "nickname": "테스트"       /* mb_nick */
  }
}

[/code]

2. Login

POST /users/login

[code]

{
  "user":{                     /* g5_member */
    "username": "test",        /* mb_id */
    "password": "test1234",    /* mb_password */
  }
}

[/code]

3. Logout

POST /users/logout

[code]

{
  "user":{                     /* g5_member */
    "username": "test",        /* mb_id */
    "password": "test1234",    /* mb_password */
  }
}

[/code]

4. Update User: 인증 필요(토큰 필요)

[code]

{
  "user":{                        /* g5_member */
    "username": "test",           /* mb_id */
    "cellphone": "test@test.com", /* mb_hp */
    "birthdate": "2020/12/20",    /* mb_birth */
    "homepage": "www.sir.kr",     /* mb_homepage */
    "gender": "남",               /* mb_sex */
    "memo": "",                   /* mb_memo */
    "nickname": "테스트"          /* mb_nick */
  }
}

[/code]

REST API를 원하시는 분들의 의견을 듣고 싶습니다.

보통은 필드 네임으로 넘어 오는 것이 이해하기도 편하긴 한데,  위와 같이 범용성을 감안하면 어떨지요?