Hub/docs/serverAPI/users

 

users

Description

  • 동시에 여러 사용자들의 프로필 조회한다.


Parameters

  • uid_list: required 조회할 UID목록 (string)
{
    "uid_list":[
        "1234567",
        "1234568"
    ]
}
  • 단, 게스트 사용자일때는 다음과 같은 파라미터를 전송
    • guest_uid 와 hub deviceId (did)
{
    "guest_uid":"90000000123",
    "did":"1234567",
    "uid_list":[
        "1234567",
        "1234568"
    ]
}


출력 JSON

  • user_list : 조회된 사용자 목록 (objects array)
  • 각 object 내 property
    • uid : 허브 UID (string)
    • id : 로그인 ID (string)
    • name : 사용자가 입력한 이름 또는 facebook name (string, 설정 안되었으면 null)
    • picture : 프로필 이미지 URL (string)
    • country : 국가 코드 (string)
    • birthday : 생년월일(string, 설정 안되었으면 null)
    • comment : 사용자가 입력한 한 마디 (string, 설정 안되었으면 null)
  • is_test_account : 테스트 계정 여부 (1일 경우 테스트 계정, 0인 경우 일반 계정)
{
    "type":"users",
    "error_code":0,
    "user_list":[
        {
            "uid":"1234567",
            "id":"dbjeas",
            "name":"Tom",
            "picture":"http://image.com2us.com/.....png",
            "country":"US",
            "comment":null,
            "is_test_account":0
        },
        {
            "uid":"1234568",
            "id":"leellbs",
            "name":"Alex",
            "picture":"http://image.com2us.com/....jpg",
            "country":"US",
            "comment":"everything has a beginning has an end",
            "is_test_account":0
        }
    ]
}


에러 메시지

  • 조회된 사용자가 한 명도 없을 때
{
    "type":"users",
    "error_code":0,
    "user_list":[]
}
  • uid_list 파라미터가 배열이 아니거나, 비어 있을 경우
{
     "type":"users",
     "error_code":1201,
     "reason":"Request has invalid format."
}


Related Method