logo

OAuth 기본 정보
인증
리소스 API
Token 관리

사용자 가입 팬클럽 - 단일조회

SMTOWN 회원이 가입한 특정 팬클럽(code) 정보를 제공합니다.
fanclub scope가 필요합니다.

변경사항
  • 버전 endpoint 제공 : v1/me/fanclubs/{code} , 기존 me/fanclubs/{code} 도 사용 가능 (2022-07-13)
GET https://openapi.smtown.com/api/v1/me/fanclubs/{code}
Authorization: Bearer 2a324609ec94f18d614d4bc425de754
파라메타 필수여부 설명
Authorization Header 필수 인증 섹션에서 받은 Bearer token 입니다.
{code} 필수-Proxy 문자열로 제공 된 팬클럽 고유코드
예) https://openapi.smtown.com/api/me/fanclubs/boa
팬클럽 코드 (abc순) 아티스트 팬클럽 이름
aespaaespaMY
boa BoA Jumping BoA
exo EXO EXO-L
girlsgeneration GIRLS' GENERATION S♡NE
got GOT GOT
kangta KANGTA Club K.I.T
nct127 NCT 127 NCTzen 127
nctdream NCT Dream NCTzen DREAM
redvelvet Red Velvet ReVeluv
shinee SHINee SHINee WORLD
superjunior SUPER JUNIOR E.L.F.
superm SuperM SuperM SUPPORTERS
tvxq TVXQ! Cassiopeia
wayv WayV WayZenNi
성공 응답
HTTP/1.1 200
Content-Type: application/json;charset=UTF-8
{
    "code": "boa",
    "name": "Jumping BoA",
    "grade": 1,
    "year": 1,
    "periodFrom": "2019-01-24T12:23:34.000Z",
    "periodTo": "2025-05-12T06:12:11.000Z",
    "issuedAt": "2018-07-30T08:06:32.000Z",
    "updatedAt": "2022-07-01T12:18:23.000Z"
}
파라메타 타입 설명
code String 팬클럽 고유 코드 (영문으로 된 코드)
name String 팬클럽 이름
grade Integer 팬클럽 가입 등급 (1=Ace, 2=Basic, 3=Artist)
year Integer ACE 회원의 유효 년 (1년=1, 2년=2, ...), 무료 회원일 경우 0. 참고용으로 사용바라며 periodFrom, periodTo으로 판단하시기 바랍니다.
periodFrom String ACE 회원의 유료 시작 일시, 무료일 경우 null
periodTo String ACE 회원의 유료 종료 일시, 무료일 경우 null
issuedAt String 팬클럽 가입 일자 (yyyy-MM-ddTHH:mm:ss.SSSXXX => 2022-05-27T02:55:50.000Z)
updatedAt String 정보 수정 일자 (yyyy-MM-ddTHH:mm:ss.SSSXXX => 2022-05-27T02:55:50.000Z)
실패 응답 - 토큰 Invalid
HTTP/1.1 401
Content-Type: application/json;charset=UTF-8
{
    "path": "https://openapi.smtown.com/api/me/fanclubs",
    "error": "Invalid Token",
    "message": "2a324609ec94f==invalid token value==",
    "timestamp": "2022-04-23T23:16:03.114Z",
    "status": 401
}
실패 응답 - 사용자가 허용하지 않음
HTTP/1.1 401
Content-Type: application/json;charset=UTF-8
{
    "path": "http://localhost:8084/api/me/fanclubs",
    "error": "Access Denied",
    "message": "Insufficient scope for this resource",
    "timestamp": "2022-06-22T20:19:55.653+0000",
    "status": 403
}
실패 응답 - 해당 정보가 없음 : 팬클럽에 가입되어 있지 않음.
HTTP/1.1 401
Content-Type: application/json;charset=UTF-8
{
    "timestamp": "2022-07-04T16:36:34.240+0000",
    "status": 400,
    "error": "Bad Request",
    "message": "User does not have such a fanclub. code(boa)",
    "path": "/api/me/fanclubs/boa"
}