logo

사용자 Profile API

SMTOWN 회원의 정보를 제공합니다.

변경사항
  • 기존 가입일자(regDate)의 날짜 포멧이 변경되었습니다. (2015-09-04T10:11:51.000+0000 => 2015-09-04T10:11:51.000Z) (2022-05-31)
  • 회원 정보 호출 URL에서 다른 추가 정보가 파생될 수 있도록 URL을 조정하였습니다. (2022-05-31)
  • 버전 endpoint 제공 : v1/me, v1.1/me, 기존 api 주소 /me 도 사용 가능. (2022-07-13)
  • /api/v1/me : 회원코드가 포함되지 않습니다. (2022-07-13)
  • /api/v1.1/me : 회원코드 및 QR 이미지 정보가 포함되어 있습니다. (2022-07-13)

https://openapi.smtown.com/api/v1/me

GET https://openapi.smtown.com/api/v1/me
Authorization: Bearer 2a324609ec94f18d614d4bc425de754
파라메타 필수여부 설명
Authorization Header 필수 인증 섹션에서 받은 Bearer token 입니다.
성공 응답
HTTP/1.1 200
Content-Type: application/json;charset=UTF-8
{
    "userNo": 123456789,
    "userId": "my-id@email.com",
    "userName": "my-name",
    "status": 1,
    "regDate": "2015-09-04T10:11:51.000Z"
}
파라메타 타입 설명
userNo Long 사용자 고유 번호
userId String 사용자 ID
사용자 아이디는 변경 가능하므로 Key로 사용하지 마시기 바랍니다.
userName String 사용자 이름
status Byte 사용자 현재 상태
1=이메일인증회원, 2=정지회원, 3=일반회원, 4=탈퇴대기회원, 5=휴면회원
regDate String 가입 일자 (yyyy-MM-ddTHH:mm:ss.SSSXXX => 2022-05-27T02:55:50.000Z)

https://openapi.smtown.com/api/v1.1/me

GET https://openapi.smtown.com/api/v1.1/me
Authorization: Bearer 2a324609ec94f18d614d4bc425de754
파라메타 필수여부 설명
Authorization Header 필수 인증 섹션에서 받은 Bearer token 입니다.
성공 응답
HTTP/1.1 200
Content-Type: application/json;charset=UTF-8
{
    "userNo": 123456789,
    "userId": "my-id@email.com",
    "userName": "my-name",
    "status": 1,
    "regDate": "2015-09-04T10:11:51.000Z",
    "qrCode": {
        "code": "ABCDEFGEF",
        "image": {
            "url": "https://my-qr-code-image.png",
            "width": 600,
            "height": 600
        }
    }
}
파라메타 타입 설명
userNo Long 사용자 고유 번호
userId String 사용자 ID
사용자 아이디는 변경 가능하므로 Key로 사용하지 마시기 바랍니다.
userName String 사용자 이름
status Byte 사용자 현재 상태
1=이메일인증회원, 2=정지회원, 3=일반회원, 4=탈퇴대기회원, 5=휴면회원
regDate String 가입 일자 (yyyy-MM-ddTHH:mm:ss.SSSXXX => 2022-05-27T02:55:50.000Z)
qrCode Object QR CODE 정보
ㄴ code String QR CODE 코드
ㄴ image Object QR CODE 이미지 정보
ㄴ url String 이미지 URL
ㄴ width Integer 이미지 가로
ㄴ height Integer 이미지 세로
실패 응답
HTTP/1.1 401
Content-Type: application/json;charset=UTF-8
{
    "path": "http://openapi.smtown.com/api/me",
    "error": "Invalid Token",
    "message": "2a324609ec94f==invalid token value==",
    "timestamp": "2022-04-23T23:16:03.114Z",
    "status": 401
}
샘플 - 사용자 Profile 요청