{"swagger":"2.0","info":{"description":"A-Match API 문서","version":"1.0.0","title":"A-Match API"},"paths":{"/account/v1/advertisers/signin":{"post":{"tags":["1.1 계정 - 광고주 관련"],"summary":"광고주 로그인","parameters":[{"in":"body","name":"body","schema":{"properties":{"email":{"type":"string","description":"광고주 이메일"},"password":{"type":"string","description":"광고주 비밀번호"}}}}],"responses":{"200":{"description":"로그인 성공\n세션에 아래의 값을 저장합니다.\n```\nsession :\n  userType: 'A'\n  userId: advertiser.id\n  userPhoto: < 광고주 이미지 URL >\n  usrr: advertiser\n  check: < 당일 출석체크 여부 >\n  attendance: < 현재 사용자 포인트 >\n  attendanceDate: < 오늘자 출석 정보 >,\n  attendanceCount:\n    monthCount: < 월간 출석 일수 | 0 >\n    todayCount: < 오늘 출석 일수 | 0 >\n    totalCount: < 전체 출석 일수 | 0 >\n```\n","schema":{"properties":{"advertiser":{"$ref":"#/definitions/Advertiser"}}}},"400":{"description":"로그인 실패\n```\nerror: InvalidPassword = 비밀번호가 일치하지 않음\n```\n","schema":{"$ref":"#/definitions/Error"}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/account/v1/advertisers/signup":{"post":{"tags":["1.1 계정 - 광고주 관련"],"summary":"광고주 회원가입","parameters":[{"in":"body","name":"body","schema":{"properties":{"mobileVerificationCodeId":{"type":"number","description":"모바일 인증코드 식별자"},"authCode":{"type":"string","description":"모바일 인증코드"},"email":{"type":"string","description":"이메일"},"nickname":{"type":"string","description":"닉네임"},"password":{"type":"string","description":"비밀번호"},"companyCategory":{"type":"string","description":"회사 카테고리"},"companyType":{"type":"string","description":"회사 유형"},"companyName":{"type":"string","description":"회사 이름"},"companyContactName":{"type":"string","description":"회사 담당자 이름"},"companyContactPhoto":{"type":"string","description":"회사 담당자 연락처"},"registrationPath":{"type":"string","description":"가입 경로"},"usePrivacyToMarketing":{"type":"boolean","description":"마케팅 동의 여부"}}}}],"responses":{"200":{"description":"회원가입 성공\n","schema":{"properties":{"data":{"$ref":"#/definitions/Advertiser"}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/account/v1/advertisers/is-email-available":{"post":{"tags":["1.1 계정 - 광고주 관련"],"summary":"광고주 이메일 사용 가능여부 검사","parameters":[{"in":"body","name":"body","schema":{"properties":{"email":{"type":"number","description":"이메일"}}}}],"responses":{"200":{"description":"이메일 사용 여부 조회\n","schema":{"properties":{"data":{"type":"boolean","description":"이메일 사용 가능 여부"}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/account/v1/advertisers/is-nickname-available":{"post":{"tags":["1.1 계정 - 광고주 관련"],"summary":"광고주 닉네임 사용 가능여부 검사","parameters":[{"in":"body","name":"body","schema":{"properties":{"nickname":{"type":"string","description":"닉네임"}}}}],"responses":{"200":{"description":"닉네임 사용 여부 조회\n","schema":{"properties":{"data":{"type":"boolean","description":"닉네임 사용 가능 여부"}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/account/v1/advertisers/total-count":{"post":{"tags":["1.1 계정 - 광고주 관련"],"summary":"총 광고주의 수","responses":{"200":{"description":"총 광고주의 수 조회\n","schema":{"properties":{"data":{"type":"number","description":"총 광고주의 수"}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/account/v1/advertisers/get-profile":{"post":{"tags":["1.1 계정 - 광고주 관련"],"summary":"현재 로그인한 광고주의 정보 조회","responses":{"200":{"description":"조회 성공\n","schema":{"properties":{"advertiser":{"$ref":"#/definitions/Advertiser"}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/account/v1/advertisers/profile-picture":{"post":{"tags":["1.1 계정 - 광고주 관련"],"summary":"현재 로그인한 광고주의 사진 추가","consumes":["multipart/form-data"],"parameters":[{"in":"formData","name":"newphoto","type":"file","required":true}],"responses":{"200":{"description":"사진 추가 성공\n","schema":{"properties":{"advertiser":{"$ref":"#/definitions/Advertiser"}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}},"delete":{"tags":["1.1 계정 - 광고주 관련"],"summary":"현재 로그인한 광고주의 사진 초기화","responses":{"200":{"description":"사진 삭제 성공\n","schema":{"properties":{"advertiser":{"$ref":"#/definitions/Advertiser"}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/account/v1/advertisers/update-profile":{"post":{"tags":["1.1 계정 - 광고주 관련"],"summary":"현재 로그인한 광고주의 프로필 업데이트","consumes":["multipart/form-data"],"parameters":[{"in":"formData","name":"companyLicense","description":"사업자 등록증","type":"file"},{"in":"formData","name":"email","type":"number","description":"이메일"},{"in":"formData","name":"newpassword","type":"string","description":"새 비밀번호"},{"in":"formData","name":"nickname","type":"string","description":"닉네임"},{"in":"formData","name":"companyType","type":"string","description":"회사 유형"},{"in":"formData","name":"companyName","type":"string","description":"회사 이름"},{"in":"formData","name":"companyCategory","type":"string","description":"회사 카테고리"},{"in":"formData","name":"companyContactName","type":"string","description":"회사 담당자 이름"},{"in":"formData","name":"companyContactPhone","type":"string","description":"회사 담당자 전화번호"},{"in":"formData","name":"registrationPath","type":"string","description":"가입경로"}],"responses":{"200":{"description":"업데이트 성공\n","schema":{"properties":{"advertiser":{"$ref":"#/definitions/Advertiser"}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/account/v1/advertisers/update-password":{"post":{"tags":["1.1 계정 - 광고주 관련"],"summary":"현재 로그인한 광고주의 비밀번호 업데이트","parameters":[{"in":"body","name":"body","schema":{"properties":{"token":{"type":"string","description":"비밀번호 변경 토큰"},"password":{"type":"string","description":"새 비밀번호"}}}}],"responses":{"200":{"description":"비밀번호 변경 성공\n","schema":{"properties":{"result":{"type":"boolean","description":"변경 성공 여부"}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/account/v1/attendance":{"post":{"tags":["1.2 계정 - 출석 관련"],"summary":"현재 로그인한 사용자가 출석체크 수행","responses":{"200":{"description":"출석 체크 성공\n"},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/account/v1/session":{"get":{"tags":["1.3. 계정 - 메인 관련"],"summary":"현재 로그인한 사용자의 세션 조회 (별도의 apikey 보안)","responses":{"200":{"description":"세션 조회 성공\n","schema":{"allOf":[{"$ref":"#/definitions/UserAttendance"},{"type":"object","properties":{"userType":{"type":"string","description":"사용자 타입(광고주=A, 유저/크리에이터=U)"},"userId":{"type":"number","description":"사용자 식별자"},"userPhoto":{"type":"string","description":"프로필 이미지 주소"},"user":{"$ref":"#/definitions/Advertiser"}}}]}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/account/v1/signout":{"post":{"tags":["1.3. 계정 - 메인 관련"],"summary":"현재 로그인한 사용자가 로그아웃 수행","responses":{"200":{"description":"로그아웃 성공\n"},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/account/v1/interest":{"post":{"tags":["1.4. 계정 - 관심 관련"],"summary":"현재 로그인한 사용자에 관심 추가","parameters":[{"in":"body","name":"body","schema":{"properties":{"interestTYpe":{"type":"string","description":"관심 유형"},"targetId":{"type":"number","description":"대상 식별자"}}}}],"responses":{"200":{"description":"관심 추가 성공\n","schema":{"properties":{"ret":{"$ref":"#/definitions/Interest"}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/account/v1/interest/{targetId}":{"delete":{"tags":["1.4. 계정 - 관심 관련"],"summary":"현재 로그인한 사용자의 관심 삭제","parameters":[{"in":"path","name":"targetId","description":"관심 식별자","type":"string","required":true}],"responses":{"200":{"description":"관심 삭제 성공\n"},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/account/v1/interest/search":{"get":{"tags":["1.4. 계정 - 관심 관련"],"summary":"현재 로그인한 사용자의 관심 검색","parameters":[{"in":"query","name":"targetId","description":"관심 식별자","type":"number"}],"responses":{"200":{"description":"관심 검색 성공\n","schema":{"properties":{"ret":{"$ref":"#/definitions/Interest"}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/account/v1/me/status":{"get":{"tags":["1.5. 계정 - 내 정보 관련"],"summary":"현재 로그인한 사용자의 정보, 출석정보, 채널정보 조회","responses":{"200":{"description":"내 정보 조회 성공\n","schema":{"properties":{"attendanceInfo":{"$ref":"#/definitions/UserAttendance"},"me":{"type":"object","description":"로그인 사용자 정보 조회(광고주 or 사용자)"},"channel":{"$ref":"#/definitions/Channel"}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/account/v1/me":{"get":{"tags":["1.5. 계정 - 내 정보 관련"],"summary":"현재 로그인한 사용자의 정보 조회","responses":{"200":{"description":"내 정보 조회 성공\n","schema":{"properties":{"userId":{"type":"number","description":"사용자 식발져"},"userType":{"type":"string","description":"사용자 타입"},"user":{"type":"object","description":"사용자 정보(광고주 or 사용자)"}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/account/v1/me/interest-channels":{"get":{"tags":["1.5. 계정 - 내 정보 관련"],"summary":"현재 로그인한 사용자의 관심 채널 목록 조회","responses":{"200":{"description":"관심 채널 목록 조회 성공\n","schema":{"properties":{"channels":{"type":"array","items":{"$ref":"#/definitions/Channel"}}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/account/v1/mobile-verification-codes/send-sms":{"post":{"tags":["1.6. 계정 - 인증 코드 관련"],"summary":"인증 코드 발송","parameters":[{"in":"body","name":"body","required":true,"schema":{"type":"object","properties":{"phoneNumber":{"type":"string","description":"전화번호"},"userType":{"type":"string","description":"사용자 타입 (있을 시, 사용자 타입으로 및 전화번호 체크)"}}}}],"responses":{"200":{"description":"sms 발송 성곤\n","schema":{"properties":{"id":{"type":"number","description":"인증 코드 식별자"},"authCode":{"type":"string","description":"인증 코드 식별자"}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/account/v1/mobile-verification-codes/verify-code":{"post":{"tags":["1.6. 계정 - 인증 코드 관련"],"summary":"인증 코드 검증","parameters":[{"in":"body","name":"body","required":true,"schema":{"type":"object","properties":{"id":{"type":"number","description":"인증 코드 식별자"},"authCode":{"type":"string","description":"인증 코드 식별자"},"findAdvertiserEmail":{"type":"boolean","description":"광고주 이메일 조회 여부"},"makeResetToken":{"type":"boolean","description":"비밀번호 초기화 토큰 생성 여부"}}}}],"responses":{"200":{"description":"검증 성공\n","schema":{"properties":{"result":{"type":"boolean","description":"처리 여부"},"mobileVerificationCode":{"type":"object","description":"모바일 인증코드 정보"},"email":{"type":"string","description":"광고주 이메일 주소"},"resetToken":{"type":"string","description":"리셋 토큰"}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/account/v1/point-history":{"post":{"tags":["1.7. 계정 - 포인트 관련"],"summary":"현재 로그인한 사용자의 포인트 목록 조회","responses":{"200":{"description":"포인트 히스토리 목록 조회 성공\n","schema":{"properties":{"pointList":{"$ref":"#/definitions/PointHistory"}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/account/v1/users/signup":{"post":{"tags":["1.8. 계정 - 유저 관련"],"summary":"일반 회원/크리에이터 회원가입","consumes":["multipart/form-data"],"produces":["application/json"],"parameters":[{"in":"formData","name":"mobileVerificationCodeId","description":"모바일 인증 코드 식별자","type":"number"},{"in":"formData","name":"authCode","description":"모바일 인증 코드","type":"string"},{"in":"formData","name":"isCreator","description":"크리에이터 여부","type":"boolean"},{"in":"formData","name":"email","description":"이메일","type":"string"},{"in":"formData","name":"accountId","description":"사용자 아이디","type":"string"},{"in":"formData","name":"nickname","description":"닉네임","type":"string"},{"in":"formData","name":"password","description":"비밀번호","type":"string"},{"in":"formData","name":"favoriteGenre","description":"관심 장르","type":"string"},{"in":"formData","name":"name","description":"이름","type":"string"},{"in":"formData","name":"gender","description":"성별","type":"string"},{"in":"formData","name":"phone","description":"전화번호","type":"string"},{"in":"formData","name":"registrationPath","description":"가입경로","type":"string"},{"in":"formData","name":"usePrivacyToMarketing","description":"마케팅 사용여부","type":"string"},{"in":"formData","name":"accountType","description":"계정 타입 (P=개인사업자, B=법인사업자)","type":"string"},{"in":"formData","name":"businessLicense","description":"사업자등록증","type":"file"},{"in":"formData","name":"preferredGenre","description":"선호장르","type":"string"},{"in":"formData","name":"mcnCompanyName","description":"MCN 회사이름 (MCN 회사가 있는 경우)","type":"string"}],"responses":{"200":{"description":"성공","schema":{"$ref":"#/definitions/Advertiser"}},"400":{"description":"클라이언트 오류\n\n- error = DataNotFound, 모바일 인증코드를 찾을 수 없음. (name = MobileVerificationCode)\n- error = AlreadyConsumed, 인증 코드가 이미 소모됨\n- error = ExpiredAuthCode, 인증 코드가 만료됨\n- error = InvalidAuthCode, 인증 코드가 일치하지 않음\n","schema":{"$ref":"#/definitions/Error"}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/account/v1/users/is-account-id-available":{"post":{"tags":["1.8. 계정 - 유저 관련"],"summary":"일반 회원/크리에이터 아이디 사용 가능 여부 (deprecated)","consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"body","name":"body","required":true,"schema":{"type":"object","properties":{"accountId":{"type":"string"}}}}],"responses":{"200":{"description":"성공\n\n- data = true, 사용 가능한 이메일\n- data = false, 사용 불가능한 이메일\n","schema":{"properties":{"data":{"type":"boolean"}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/account/v1/users/is-email-available":{"post":{"tags":["1.8. 계정 - 유저 관련"],"summary":"일반 회원/크리에이터 이메일 사용 가능 여부","consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"body","name":"body","required":true,"schema":{"type":"object","properties":{"email":{"type":"string"}}}}],"responses":{"200":{"description":"성공\n\n- data = true, 사용 가능한 이메일\n- data = false, 사용 불가능한 이메일\n","schema":{"properties":{"data":{"type":"boolean"}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/account/v1/users/is-nickname-available":{"post":{"tags":["1.8. 계정 - 유저 관련"],"summary":"일반 회원/크리에이터 닉네임 사용 가능 여부","consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"body","name":"body","required":true,"schema":{"type":"object","properties":{"nickname":{"type":"string"}}}}],"responses":{"200":{"description":"성공\n\n- data = true, 사용 가능한 닉네임\n- data = false, 사용 불가능한 닉네임\n","schema":{"properties":{"data":{"type":"boolean"}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/account/v1/users/total-creator-count":{"get":{"tags":["1.8. 계정 - 유저 관련"],"summary":"크리에이터 총 인원수","produces":["application/json"],"responses":{"200":{"description":"성공\n\n- data, 전체 광고주 수\n","schema":{"properties":{"data":{"type":"number"}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/account/v1/users/{id}/attendances":{"get":{"tags":["1.8. 계정 - 유저 관련"],"summary":"현재 로그인한 사용자 또는 일반 회원/크리에이터 출석 목록 조회","parameters":[{"in":"path","name":"id","description":"일반회원/크리에이터 아이디 또는 me","type":"string","required":true}],"responses":{"200":{"description":"출석 성공\n","schema":{"properties":{"attendances":{"type":"array","items":{"$ref":"#/definitions/AttendanceDate"}}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/account/v1/users/get-profile":{"get":{"tags":["1.8. 계정 - 유저 관련"],"summary":"현재 로그인한 일반 회원/크리에이터 정보 조회","responses":{"200":{"description":"유저 정보 조회 성공\n","schema":{"properties":{"user":{"$ref":"#/definitions/User"}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/account/v1/users/profile-picture":{"post":{"tags":["1.8. 계정 - 유저 관련"],"summary":"현재 로그인한 일반 회원/크리에이터 사진 추가","consumes":["multipart/form-data"],"parameters":[{"in":"formData","name":"newphoto","type":"file","required":true}],"responses":{"200":{"description":"유저 프로필 이미지 업데이트 성공\n","schema":{"properties":{"user":{"$ref":"#/definitions/User"}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}},"delete":{"tags":["1.8. 계정 - 유저 관련"],"summary":"현재 로그인한 일반 회원/크리에이터 사진 초기화","responses":{"200":{"description":"유저 프로필 이미지 초기화 성공\n","schema":{"properties":{"user":{"$ref":"#/definitions/User"}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/account/v1/users/update-profile":{"post":{"tags":["1.8. 계정 - 유저 관련"],"summary":"현재 로그인한 일반 회원/크리에이터 프로필 업데이트","consumes":["multipart/form-data"],"parameters":[{"in":"formData","name":"name","description":"이름","type":"string"},{"in":"formData","name":"gender","description":"성별","type":"string"},{"in":"formData","name":"phone","description":"전화번호","type":"string"},{"in":"formData","name":"registrationPath","description":"가입경로","type":"string"},{"in":"formData","name":"businessLicense","description":"사업자 등록증","type":"file"},{"in":"formData","name":"favoriteGenre","description":"선호 장르(유저)","type":"string"},{"in":"formData","name":"usePrivacyToMarketing","description":"마케팅 동의 여부","type":"string"},{"in":"formData","name":"preferredGenre","description":"선호 장르(크리에이터)","type":"string"},{"in":"formData","name":"accountType","description":"계정 타입","type":"string"},{"in":"formData","name":"age","description":"나이","type":"string"},{"in":"formData","name":"expectedRevenue","description":"기대 수익","type":"string"},{"in":"formData","name":"mcnCompanyName","description":"mcn 회사 이름","type":"string"}],"responses":{"200":{"description":"유저 프로필 업데이트 성공\n","schema":{"properties":{"user":{"$ref":"#/definitions/User"}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/analysis/v1/creators-per-ranking":{"get":{"tags":["2.1. 분석 - 메인 관련"],"summary":"랭킹별 채널 목록 조회","parameters":[{"in":"query","name":"page","description":"페이지 (default=1)","type":"number"},{"in":"query","name":"pageSize","description":"페이지 사이즈 (default=5)","type":"number"}],"responses":{"200":{"description":"분석 채널 목록 조회 성공\n","schema":{"properties":{"channels":{"type":"array","items":{"$ref":"#/definitions/AnalysisChannel"}}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/analysis/v1/recommended-channels":{"get":{"tags":["2.1. 분석 - 메인 관련"],"summary":"추천 채널 목록 조회","parameters":[{"in":"query","name":"page","description":"페이지 (default=1)","type":"number"},{"in":"query","name":"pageSize","description":"페이지 사이즈 (default=5)","type":"number"}],"responses":{"200":{"description":"분석 채널 목록 조회 성공\n","schema":{"properties":{"channels":{"type":"array","items":{"$ref":"#/definitions/AnalysisChannel"}}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/analysis/v1/realtime-hot-keywords":{"get":{"tags":["2.1. 분석 - 메인 관련"],"summary":"실시간 급 상승 검색어 목록 조회","responses":{"200":{"description":"분석 채널 목록 조회 성공\n","schema":{"properties":{"keywords":{"type":"array","items":{"properties":{"name":{"type":"string","description":"키워드 이름"},"group":{"type":"number","description":"키워드 그룹"}}}}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/analysis/v1/keyword-categories":{"get":{"tags":["2.2. 분석 - 키워드 카테고리 관련"],"summary":"키워드 카테고리 목록 조회","responses":{"200":{"description":"분석 채널 목록 조회 성공\n","schema":{"properties":{"keywordCategories":{"type":"array","items":{"properties":{"id":{"type":"string","description":"키워드 그룹 식별자"},"name":{"type":"string","description":"키워드 그룹 이름"}}}}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/analysis/v1/keywords":{"get":{"tags":["2.3. 분석 - 키워드 관련"],"summary":"키워드 목록 조회","responses":{"200":{"description":"분석 채널 목록 조회 성공\n","schema":{"properties":{"keywords":{"type":"array","items":{"properties":{"category":{"type":"string","description":"키워드 카테고리"},"keyword":{"type":"string","description":"키워드 이름"},"count":{"type":"string","description":"키워드 개수"},"type":{"type":"string","description":"키워드 타입"},"channelCount":{"type":"string","description":"키워드 채널 개수"},"channelIds":{"type":"string","description":"키워드 채널 아이디 목록 (,로 구분)"}}}}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/analysis/v1/search-keywords":{"post":{"tags":["2.4. 분석 - 검색 키워드 관련"],"summary":"검색 키워드 업데이트","parameters":[{"in":"body","name":"body","schema":{"properties":{"keyword":{"type":"string","description":"키워드"}}}}],"responses":{"200":{"description":"검색 키워드 저장 성공\n"},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/analysis/v1/search-keywords/top-10":{"get":{"tags":["2.4. 분석 - 검색 키워드 관련"],"summary":"상위 10개 검색 키워드 목록 조회","responses":{"200":{"description":"상위 10개 검색 키워드 목록 조회 성공\n","schema":{"properties":{"searchKeywords":{"type":"array","items":{"properties":{"name":{"type":"string","description":"키워드 이름"}}}}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/oauth/v1/kakao":{"post":{"tags":["3.1. 인증 - OAuth 관련"],"summary":"카카오 로그인 (로그인 웹페이지 표시 -> 콜백으로 리다이렉트)","responses":{"200":{"description":"성공"}}}},"/oauth/v1/kakao-callback":{"get":{"tags":["3.1. 인증 - OAuth 관련"],"summary":"카카오 로그인 성공 시 콜백","responses":{"301":{"description":"콜백 성공 페이지로 리다이렉트\n세션에 아래의 값을 저장합니다.\n```\nsession :\n  userType: 'U'\n  userId: advertiser.id\n  userPhoto: < 유저 이미지 URL >\n  usrr: advertiser\n  check: < 당일 출석체크 여부 >\n  attendance: < 현재 사용자 포인트 >\n  attendanceDate: < 오늘자 출석 정보 >,\n  attendanceCount:\n    monthCount: < 월간 출석 일수 | 0 >\n    todayCount: < 오늘 출석 일수 | 0 >\n    totalCount: < 전체 출석 일수 | 0 >\n```\n"},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/oauth/v1/facebook":{"post":{"tags":["3.1. 인증 - OAuth 관련"],"summary":"페이스북 로그인 (로그인 웹페이지 표시 -> 콜백으로 리다이렉트)","responses":{"200":{"description":"성공"}}}},"/oauth/v1/facebook-callback":{"get":{"tags":["3.1. 인증 - OAuth 관련"],"summary":"페이스북 로그인 성공 시 콜백","responses":{"301":{"description":"콜백 성공 페이지로 리다이렉트\n세션에 아래의 값을 저장합니다.\n```\nsession :\n  userType: 'U'\n  userId: advertiser.id\n  userPhoto: < 유저 이미지 URL >\n  usrr: advertiser\n  check: < 당일 출석체크 여부 >\n  attendance: < 현재 사용자 포인트 >\n  attendanceDate: < 오늘자 출석 정보 >,\n  attendanceCount:\n    monthCount: < 월간 출석 일수 | 0 >\n    todayCount: < 오늘 출석 일수 | 0 >\n    totalCount: < 전체 출석 일수 | 0 >\n```\n"},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/oauth/v1/naver":{"post":{"tags":["3.1. 인증 - OAuth 관련"],"summary":"네이버 로그인 (로그인 웹페이지 표시 -> 콜백으로 리다이렉트)","responses":{"200":{"description":"성공"}}}},"/oauth/v1/naver-callback":{"get":{"tags":["3.1. 인증 - OAuth 관련"],"summary":"네이버 로그인 성공시 콜백","responses":{"301":{"description":"콜백 성공 페이지로 리다이렉트\n세션에 아래의 값을 저장합니다.\n```\nsession :\n  userType: 'U'\n  userId: advertiser.id\n  userPhoto: < 유저 이미지 URL >\n  usrr: advertiser\n  check: < 당일 출석체크 여부 >\n  attendance: < 현재 사용자 포인트 >\n  attendanceDate: < 오늘자 출석 정보 >,\n  attendanceCount:\n    monthCount: < 월간 출석 일수 | 0 >\n    todayCount: < 오늘 출석 일수 | 0 >\n    totalCount: < 전체 출석 일수 | 0 >\n```\n"},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/oauth/v1/google":{"post":{"tags":["3.1. 인증 - OAuth 관련"],"summary":"구글 로그인 (로그인 웹페이지 표시 -> 콜백으로 리다이렉트)","responses":{"200":{"description":"성공"}}}},"/oauth/v1/google-callback":{"get":{"tags":["3.1. 인증 - OAuth 관련"],"summary":"구글 로그인 성공시 콜백","responses":{"301":{"description":"콜백 성공 페이지로 리다이렉트"},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/business/v1/campaign-suggests":{"post":{"tags":["4.1. 비즈니스 - 캠페인 제안 관련"],"summary":"로그인한 사용자가 일반 회원/크리에이터에게 캠페인 제안","parameters":[{"in":"body","name":"body","schema":{"properties":{"channelId":{"type":"number","description":"채널 식별자"},"message":{"type":"string","description":"제안 메시지"}}}}],"responses":{"200":{"description":"제안 성공","schema":{"properties":{"campaignSuggest":{"$ref":"#/definitions/CampaignSuggest"}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/community/v1/articles":{"post":{"tags":["5.1. 커뮤니티 - 게시물 관련"],"summary":"게시물 작성","parameters":[{"in":"body","name":"body","schema":{"properties":{"communityId":{"type":"number"},"articleTitle":{"type":"string"},"articleHeader":{"type":"string"},"content":{"type":"string"}}}}],"responses":{"200":{"description":"게시물 작성 성공","schema":{"properties":{"article":{"$ref":"#/definitions/Article"},"articleContent":{"$ref":"#/definitions/ArticleContent"}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}},"get":{"tags":["5.1. 커뮤니티 - 게시물 관련"],"summary":"게시물 목록 조회","parameters":[{"name":"community","in":"query","type":"string","description":"커뮤니티 식별자"},{"name":"isGlobalNotice","in":"query","type":"string","description":"글로벌 공지사항 여부"},{"name":"articleHeader","in":"query","type":"string","description":"게시물 말머리"},{"name":"searchFields","in":"query","type":"string","description":"검색 유형"},{"name":"keyword","in":"query","type":"string","description":"검색 키워드"},{"name":"page","in":"query","type":"string","description":"페이지 번호"},{"name":"pageSize","in":"query","type":"string","description":"페이지 크기"},{"name":"sortMethod","in":"query","type":"string","description":"정렬 방법"}],"responses":{"200":{"description":"게시물 작성 성공","schema":{"properties":{"articles":{"type":"array","items":{"$ref":"#/definitions/Article"}},"totalArticleCount":{"type":"number"}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/community/v1/articles/{id}":{"get":{"tags":["5.1. 커뮤니티 - 게시물 관련"],"summary":"게시물 작성","parameters":[{"in":"path","name":"id","description":"게시물 식별자","type":"string","required":true},{"in":"body","name":"body","schema":{"properties":{"communityId":{"type":"number"},"articleTitle":{"type":"string"},"articleHeader":{"type":"string"},"content":{"type":"string"}}}}],"responses":{"200":{"description":"게시물 작성 성공","schema":{"properties":{"article":{"$ref":"#/definitions/Article"},"articleContent":{"$ref":"#/definitions/ArticleContent"},"articleInteraction":{"type":"object","description":"사용자 인터랙션 정보"},"articleFavorite":{"$ref":"#/definitions/ArticleFavorite"},"prevdArticle":{"$ref":"#/definitions/Article"},"nextArticle":{"$ref":"#/definitions/Article"}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}},"delete":{"tags":["5.1. 커뮤니티 - 게시물 관련"],"summary":"게시물 삭제","parameters":[{"in":"path","name":"id","description":"게시물 식별자","type":"string","required":true}],"responses":{"200":{"description":"게시물 작성 성공","schema":{"properties":{"article":{"$ref":"#/definitions/Article"}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/community/v1/articles/{id}/view":{"post":{"tags":["5.1. 커뮤니티 - 게시물 관련"],"summary":"게시물 뷰 카운트 증가","parameters":[{"in":"path","name":"id","description":"게시물 식별자","type":"string","required":true}],"responses":{"200":{"description":"게시물 작성 성공","schema":{"properties":{"article":{"$ref":"#/definitions/Article"}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/community/v1/articles/favorite":{"post":{"tags":["5.1. 커뮤니티 - 게시물 관련"],"summary":"즐겨찾기 추가","responses":{"200":{"description":"게시물 작성 성공","schema":{"properties":{"articleFavorite":{"$ref":"#/definitions/Article"}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/community/v1/articles/{id}/comments":{"get":{"tags":["5.1. 커뮤니티 - 게시물 관련"],"summary":"코멘트 목록 조회","parameters":[{"in":"path","name":"id","description":"게시물 식별자","type":"string","required":true}],"responses":{"200":{"description":"댓글 목록 조회 성공","schema":{"properties":{"comments":{"type":"array","items":{"$ref":"#/definitions/CommunityComment"}}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/community/v1/articles/{id}/action":{"post":{"tags":["5.1. 커뮤니티 - 게시물 관련"],"summary":"게시물 좋아요/싫어요 액션 수행","parameters":[{"in":"path","name":"id","description":"게시물 식별자","type":"string","required":true},{"in":"body","name":"body","schema":{"properties":{"action":{"type":"number","description":"액션 값"}}}}],"responses":{"200":{"description":"성공"},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/community/v1/comments":{"post":{"tags":["5.2. 커뮤니티 - 코멘트 관련"],"summary":"댓글 작성","parameters":[{"in":"body","name":"body","schema":{"properties":{"communityArticleId":{"type":"number"},"commentContent":{"type":"string"},"isSecret":{"type":"string"},"paranetId":{"type":"number"}}}}],"responses":{"200":{"description":"작성 성공","schema":{"$ref":"#/definitions/CommunityComment"}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/community/v1/comments/{id}/action":{"post":{"tags":["5.2. 커뮤니티 - 코멘트 관련"],"summary":"댓글 좋아요/싫어요 액션 수행","parameters":[{"in":"path","name":"id","description":"댓글 식별자","type":"string","required":true},{"in":"body","name":"body","schema":{"properties":{"action":{"type":"number"}}}}],"responses":{"200":{"description":"댓글 작성 성공"},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/community/v1/comments/{id}":{"delete":{"tags":["5.2. 커뮤니티 - 코멘트 관련"],"summary":"댓글 삭제","parameters":[{"in":"path","name":"id","description":"댓글 식별자","type":"string","required":true}],"responses":{"200":{"description":"댓글 삭제 성공","schema":{"properties":{"comment":{"$ref":"#/definitions/CommunityComment"}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/community/v1/files":{"post":{"tags":["5.3. 커뮤니티 - 메인 관련"],"summary":"게시물에 담을 파일 임시 저장","responses":{"200":{"description":"커뮤니티 파일 업로드","schema":{"properties":{"data":{"type":"number","description":"커뮤니티 파일 식별자"}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/community/v1/files/{id}":{"post":{"tags":["5.3. 커뮤니티 - 메인 관련"],"summary":"파일 다운로드","parameters":[{"in":"path","name":"id","description":"파일 식별자","type":"string","required":true}],"responses":{"200":{"description":"커뮤니티 파일 다운로드"},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/community/v1/top-articles":{"get":{"tags":["5.3. 커뮤니티 - 메인 관련"],"summary":"상위 게시물 10개를 조회합니다.","responses":{"200":{"description":"상위 게시물 목록 조회","schema":{"properties":{"articles":{"type":"array","items":{"$ref":"#/definitions/Article"}}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/main/v1/site-user-count":{"get":{"tags":["6.1. 메인 - 메인 관련"],"summary":"사이트 전체의 사용자 정보 조회","responses":{"200":{"description":"사이트 유저 카운트 조회","schema":{"properties":{"totalAdvertiserCount":{"type":"number"},"totalCreatorCount":{"type":"number"},"totalNotCreatorCount":{"type":"number"},"totalUserCount":{"type":"number"},"totalCampaignCount":{"type":"number"}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/mypage/v1/alarm":{"post":{"tags":["7.1. 마이페이지 - 알람 관련"],"summary":"알람 생성","parameters":[{"in":"body","name":"body","schema":{"properties":{"alamrDate":{"type":"string"},"alarmType":{"type":"string"},"targetUrl":{"type":"string"},"alarmTitle":{"type":"string"},"alarmContent":{"type":"string"}}}}],"responses":{"200":{"description":"알람 생성 성공","schema":{"properties":{"alarm":{"$ref":"#/definitions/Alarm"}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}},"get":{"tags":["7.1. 마이페이지 - 알람 관련"],"summary":"알람 목록 조회","parameters":[{"name":"sortMethod","type":"string","in":"query"},{"name":"orderBy","type":"string","in":"query"}],"responses":{"200":{"description":"알람 생성 성공","schema":{"properties":{"alarms":{"type":"array","items":{"$ref":"#/definitions/Alarm"}}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/mypage/v1/alarm/{id}/read":{"post":{"tags":["7.1. 마이페이지 - 알람 관련"],"summary":"로그인한 사용자의 특정 알람 읽음 처리","parameters":[{"in":"path","name":"id","description":"알람 식별자","type":"string","required":true}],"responses":{"200":{"description":"알람 생성 성공","schema":{"properties":{"alarm":{"$ref":"#/definitions/Alarm"}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/mypage/v1/alarm/readall":{"post":{"tags":["7.1. 마이페이지 - 알람 관련"],"summary":"로그인한 사용자의 전체 알람 읽음 처리","responses":{"200":{"description":"알람 생성 성공","schema":{"properties":{"status":{"type":"number","description":"총 읽은 알림의 수"}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/mypage/v1/faq":{"get":{"tags":["7.2. 마이페이지 - FAQ 관련"],"summary":"FAQ 목록 조회","responses":{"200":{"description":"faq 목록 조회 성공","schema":{"properties":{"faqs":{"type":"array","items":{"$ref":"#/definitions/Faq"}}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/mypage/v1/mypost/article/{term}":{"get":{"tags":["7.3. 마이페이지 - 내 게시물 관련"],"summary":"로그인한 사용자의 내 게시물 목록 조회","parameters":[{"in":"path","name":"term","description":"조회 기간","type":"string","required":true}],"responses":{"200":{"description":"게시물 목록 조회 성공","schema":{"properties":{"articles":{"type":"array","items":{"$ref":"#/definitions/Article"}}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/mypage/v1/mypost/favorite/{term}":{"get":{"tags":["7.4. 마이페이지 - 내 게시물 관련"],"summary":"로그인한 사용자의 즐겨찾기 목록 조회","parameters":[{"in":"path","name":"term","description":"조회 기간","type":"string","required":true}],"responses":{"200":{"description":"게시물 목록 조회 성공","schema":{"properties":{"articles":{"type":"array","items":{"$ref":"#/definitions/Article"}}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/mypage/v1/mypost/ticket":{"post":{"tags":["7.4. 마이페이지 - 티켓 관련"],"summary":"티켓 생성","parameters":[{"in":"body","name":"body","schema":{"properties":{"ticketTitle":{"type":"string"},"ticketContent":{"type":"string"},"ticketCategory":{"type":"string"}}}}],"responses":{"200":{"description":"티켓 생성 성공","schema":{"properties":{"ticket":{"$ref":"#/definitions/Ticket"}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}},"get":{"tags":["7.4. 마이페이지 - 티켓 관련"],"summary":"티켓 목록 조회","responses":{"200":{"description":"티켓 목록 조회 성공","schema":{"properties":{"tickets":{"type":"array","items":{"$ref":"#/definitions/Ticket"}},"totalTicketCount":{"type":"number"}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/mypage/v1/mypost/ticket/{id}/view":{"post":{"tags":["7.4. 마이페이지 - 티켓 관련"],"summary":"티켓 생성","parameters":[{"in":"path","name":"id","type":"number","required":true}],"responses":{"200":{"description":"티켓 조회 성공","schema":{"properties":{"ticket":{"$ref":"#/definitions/Ticket"},"prevTicket":{"$ref":"#/definitions/Ticket"},"nextTicket":{"$ref":"#/definitions/Ticket"}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/result/v1/hot-keyword-date":{"get":{"tags":["8.1. 결과 - 메인 관련"],"summary":"일간 핫 키워드 조회","responses":{"200":{"description":"조회 성공","schema":{"properties":{"result":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"keyword":{"type":"string"},"keywordCount":{"type":"number"},"channelCount":{"type":"number"}}}}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/result/v1/hot-keyword-week":{"get":{"tags":["8.1. 결과 - 메인 관련"],"summary":"주간 핫 키워드 조회","responses":{"200":{"description":"조회 성공","schema":{"properties":{"result":{"type":"array","items":{"type":"object","properties":{"year":{"type":"number"},"week":{"type":"number"},"keyword":{"type":"string"},"keywordCount":{"type":"number"},"channelCount":{"type":"number"}}}}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/result/v1/hot-keyword-month":{"get":{"tags":["8.1. 결과 - 메인 관련"],"summary":"월간 핫 키워드 조회","responses":{"200":{"description":"조회 성공","schema":{"properties":{"result":{"type":"array","items":{"type":"object","properties":{"year":{"type":"number"},"month":{"type":"number"},"keyword":{"type":"string"},"keywordCount":{"type":"number"},"channelCount":{"type":"number"}}}}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/youtube/v1/channels":{"get":{"tags":["9.1. 유튜브 - 채널 관련"],"summary":"채널 목록 조회","parameters":[{"in":"query","name":"channelIds","description":"콤마로 구분된 채널 식별자 목록","type":"string"},{"in":"query","name":"sortBy","type":"string"},{"in":"query","name":"sortKeywords","type":"string"}],"responses":{"200":{"description":"채널 목록 조회 성공","schema":{"properties":{"channels":{"type":"array","items":{"$ref":"#/definitions/AnalysisChannel"}},"channelCount":{"type":"number"}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/youtube/v1/channels/me":{"get":{"tags":["9.1. 유튜브 - 채널 관련"],"summary":"내 채널 정보 조회","responses":{"200":{"description":"채널 조회 성공","schema":{"$ref":"#/definitions/AnalysisChannel"}},"401":{"description":"권한 없음"},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/youtube/v1/channels/{id}":{"get":{"tags":["9.1. 유튜브 - 채널 관련"],"summary":"채널 정보 조회","parameters":[{"in":"path","name":"id","description":"채널 식별자","type":"integer","required":true}],"responses":{"200":{"description":"채널 조회 성공","schema":{"$ref":"#/definitions/AnalysisChannel"}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/youtube/v1/channels/{id}/videos":{"get":{"tags":["9.1. 유튜브 - 채널 관련"],"summary":"채널 비디오 목록 조회","parameters":[{"in":"path","name":"id","description":"채널 식별자","type":"integer","required":true}],"responses":{"200":{"description":"채널 비디오 목록 조회 성공","schema":{"properties":{"videos":{"type":"array","items":{"$ref":"#/definitions/ChannelVideo"}}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/youtube/v1/channels/{id}/rate":{"get":{"tags":["9.1. 유튜브 - 채널 관련"],"summary":"채널 지수 조회","parameters":[{"in":"path","name":"id","description":"채널 식별자","type":"integer","required":true}],"responses":{"200":{"description":"채널 지수 정보 조회 성공","schema":{"properties":{"rates":{"type":"array","items":{"$ref":"#/definitions/ResultChannelRate"}},"averageRates":{"type":"array","items":{"$ref":"#/definitions/ResultChannelAverageRate"}}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/youtube/v1/channels/{id}/expected-revenue":{"get":{"tags":["9.1. 유튜브 - 채널 관련"],"summary":"채널 예상 수익 조회","parameters":[{"in":"path","name":"id","description":"채널 식별자","type":"integer","required":true}],"responses":{"200":{"description":"채널 예상 수익 조회","schema":{"properties":{"expectedRevenue":{"type":"number"}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/youtube/v1/search-channel":{"post":{"tags":["9.2. 유튜브 - 메인 관련"],"summary":"채널 검색","parameters":[{"in":"body","name":"body","schema":{"properties":{"filters":{"type":"array"},"page":{"type":"number"},"pageSize":{"type":"number"},"keyword":{"type":"string"}}}}],"responses":{"200":{"description":"채널 검색 성공","schema":{"properties":{"channels":{"type":"array","items":{"$ref":"#/definitions/AnalysisChannel"}},"channelCount":{"type":"number"}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/youtube/v1/channels-per-ranking":{"post":{"tags":["9.2. 유튜브 - 메인 관련"],"summary":"랭킹별 채널 목록 조회","responses":{"200":{"description":"채널 검색 성공","schema":{"properties":{"channels":{"type":"array","items":{"$ref":"#/definitions/AnalysisChannel"}}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/youtube/v1/recommended-channels":{"post":{"tags":["9.2. 유튜브 - 메인 관련"],"summary":"추천 채널 목록 조회","responses":{"200":{"description":"채널 검색 성공","schema":{"properties":{"channels":{"type":"array","items":{"$ref":"#/definitions/AnalysisChannel"}}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}},"/youtube/v1/top-videos":{"get":{"tags":["9.2. 유튜브 - 메인 관련"],"summary":"상위 인기 비디오 목록 조회","responses":{"200":{"description":"채널 검색 성공","schema":{"properties":{"videos":{"type":"array","items":{"$ref":"#/definitions/ChannelVideo"}}}}},"500":{"description":"서버 에러","schema":{"$ref":"#/definitions/Error"}}}}}},"definitions":{"Advertiser":{"description":"광고주","type":"object","properties":{"id":{"type":"number"},"accountId":{"type":"number"},"email":{"type":"string"},"nickname":{"type":"string"},"companyName":{"type":"string"},"companyType":{"type":"string"},"companyCategory":{"type":"string"},"companyContactName":{"type":"string"},"companyContactPhone":{"type":"string"},"companyHomepage":{"type":"string"},"companyLicense":{"type":"string"},"campaignCategory":{"type":"string"},"registrationPath":{"type":"string"},"photo":{"type":"string"},"createdDt":{"type":"string"},"updatedDt":{"type":"string"}}},"User":{"description":"유저","type":"object","properties":{"id":{"type":"number"},"socialType":{"type":"string"},"socialId":{"type":"string"},"isCreator":{"type":"string"},"nickname":{"type":"string"},"email":{"type":"string"},"password":{"type":"string"},"favoriteGenre":{"type":"string"},"name":{"type":"string"},"gender":{"type":"string"},"phone":{"type":"string"},"registrationPath":{"type":"string"},"photo":{"type":"string"},"createdDt":{"type":"string"},"updatedDt":{"type":"string"},"accountId":{"type":"string"},"usePrivacyToMarketing":{"type":"string"},"point":{"type":"string"},"status":{"type":"string"},"alarmEnabled":{"type":"string"}}},"Interest":{"description":"관심","type":"object","properties":{"id":{"type":"number"},"userType":{"type":"number"},"userId":{"type":"string"},"interestType":{"type":"string"},"targetId":{"type":"number"},"createdDt":{"type":"string"},"updatedDt":{"type":"string"}}},"UserAttendance":{"description":"관심","type":"object","properties":{"id":{"type":"number"},"check":{"type":"boolean","description":"금일 출석 여부"},"attendance":{"type":"object","description":"출석 정보","properties":{"point":{"type":"number"}}},"attendanceDate":{"type":"object","description":"금일 출석 정보"},"attendanceCount":{"type":"object","properties":{"monthCount":{"type":"number","description":"월간 출석 수"},"todayCount":{"type":"number","description":"일간 출석 수"},"totalCount":{"type":"number","description":"총 출석 수"}}}}},"Channel":{"description":"채널","type":"object","properties":{"id":{"type":"number","description":"채널 식별자"},"userId":{"type":"number","description":"사용자 식별자"},"channelId":{"type":"string","description":"채널 식별자"},"channelName":{"type":"string","description":"채널 이름"},"channelTitle":{"type":"string","description":"채널 제목"},"channelDescription":{"type":"string","description":"채널 설명"},"channelPublishedAt":{"type":"string","description":"채널 배포 일"},"channelImageUrl":{"type":"string","description":"채널 이미지 주소"},"createdDt":{"type":"string","description":"데이터 생성 일자"},"updatedDt":{"type":"string","description":"데이터 수정 일자"},"isAnalyzed":{"type":"boolean","description":"채널 분석 여부"},"category":{"type":"string","description":"채널 카테고리"},"viewCount":{"type":"string","description":"채널 조회수"},"commentCount":{"type":"string","description":"채널 댓글수"},"subscriberCount":{"type":"string","description":"채널 구독자수"},"beforeSubscriberCount":{"type":"string","description":"이전 채널 구독자수"},"hiddenSubscriberCount":{"type":"string","description":"숨겨진 구독자 수"},"ranking":{"type":"string","description":"랭킹"},"beforeRanking":{"type":"string","description":"이전 랭킹"},"categoryRanking":{"type":"string","description":"카테고리별 랭킹"},"beforeCategoryRanking":{"type":"string","description":"이전 카테고리 별 랭킹"},"subscriberRanking":{"type":"string","description":"구독자 수"},"beforeSubscriberRanking":{"type":"string","description":"이전 구독자 수"},"viewCountRanking":{"type":"string","description":"조회수 랭킹"},"beforeViewCountRanking":{"type":"string","description":"이전 조회수 별 랭킹"},"lastUpdateDate":{"type":"string","description":"최종 업데이트 일자"},"likeCount":{"type":"string","description":"좋아요 수"},"viewYn":{"type":"string","description":"화면 표시 여부"},"beforeViewCount":{"type":"string","description":"이전 조회 수"},"userType":{"type":"string","description":"사용자 타입"}}},"PointHistory":{"description":"포인트 히스토리 목록","type":"object","properties":{"id":{"type":"number","description":"포인트 히스토리 식별자"},"userType":{"type":"string","description":"사용자 타입"},"userId":{"type":"number","description":"사용자 식별자"},"reason":{"type":"string","description":"포인트 사유"},"ammount":{"type":"number","description":"포인트 양"},"transactionDt":{"type":"string","description":"트랜잭션 일자"}}},"AttendanceDate":{"description":"출석 정보","properties":{"id":{"type":"number","description":"출석 정보 식별자"},"userType":{"type":"string","description":"사용자 타입"},"userId":{"type":"number","description":"사용자 식별자"},"date":{"type":"string","description":"출석 일자"}}},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}},"AnalysisChannel":{"type":"object","description":"분석 채널정보","properties":{"id":{"type":"number","description":"채널 식별자"},"userId":{"type":"number","description":"크리에이터 식별자"},"category":{"type":"string","description":"채널 카테고리"},"name":{"type":"string","description":"채널 이름"},"image":{"type":"string","description":"채널 썸네일 주소"},"totalViewCount":{"type":"string","description":"총 조회 수"},"ranking":{"type":"string","description":"랭킹"},"beforeRanking":{"type":"string","description":"이전 랭킹"},"subscriber":{"type":"string","description":"구독자 수 (호환성)"},"beforeSubscriber":{"type":"string","description":"이전 구독자 수 (호환성)"},"subscriberCount":{"type":"string","description":"구독자 수"},"beforeSubscriberCoun":{"type":"string","description":"이전 구독자 수"},"videos":{"type":"array","items":{"$ref":"#/definitions/ChannelVideo"}}}},"CampaignSuggest":{"description":"캠페인 제안 정보","properties":{"id":{"type":"number","description":"캠페인 제안 식별자"},"advertiserId":{"type":"number","description":"광고주 식별자"},"channelId":{"type":"number","description":"채널 식별자"},"message":{"type":"string","description":"메시지"},"createdDt":{"type":"string","description":"제안 생성 일자"},"date":{"type":"string","description":"출석 일자"}}},"Article":{"description":"게시물 정보","properties":{"id":{"type":"number","description":"게시물 식별자"},"communityId":{"type":"number","description":"커뮤니티 식별자"},"isGlobalNotice":{"type":"string","description":"게시판 공지사항 여부"},"articleTitle":{"type":"string","description":"게시물 제목"},"userType":{"type":"string","description":"작성자 타입"},"userId":{"type":"number","description":"작성자 식별자"},"articleHeader":{"type":"string","description":"게시물 말머리"},"likeCount":{"type":"number","description":"좋아요 수"},"dislikeCount":{"type":"number","description":"싫어요 수"},"viewCount":{"type":"number","description":"조회수"},"isAuthenticated":{"type":"string","description":"인증 여부"},"createdDt":{"type":"string","description":"작성일자"},"updatedDt":{"type":"string","description":"수정일자"}}},"ArticleContent":{"description":"게시물 내용 정보","properties":{"communityArticleId":{"type":"number","description":"게시물 식별자"},"content":{"type":"string","description":"게시물 내용"}}},"ArticleFavorite":{"description":"게시물 즐겨찾기 정보","properties":{"id":{"type":"number","description":"게시물 식별자"},"userType":{"type":"string","description":"작성자 타입"},"userId":{"type":"number","description":"작성자 식별자"},"communityArticleId":{"type":"string","description":"게시물 식뱔자"},"createdDt":{"type":"string","description":"작성일자"},"updatedDt":{"type":"string","description":"수정일자"}}},"CommunityComment":{"description":"커뮤니티 댓글 정보","properties":{"id":{"type":"number","description":"댓글 식별자"},"content":{"type":"string","description":"댓글 내용"},"isSecret":{"type":"string","description":"비밀댓글 여부"},"userType":{"type":"string","description":"사용자 타입"},"userId":{"type":"number","description":"사용자 식별자"},"parentId":{"type":"number","description":"부모 식별자"},"likeCount":{"type":"number","description":"좋아요 수"},"dislikeCount":{"type":"number","description":"싫어요 수"},"createdAt":{"type":"string","description":"작성일자"},"updatedAt":{"type":"string","description":"수정일자"},"userName":{"type":"string","description":"작성자 이름"},"userPhoto":{"type":"string","description":"작성자 썸네일"},"action":{"type":"number","description":"댓글 액션"}}},"CommunityFile":{"description":"커뮤니티 파일","properties":{"id":{"type":"number","description":"댓글 식별자"},"fileName":{"type":"string","description":"파일 이름"},"filePath":{"type":"string","description":"파일 경로"},"fileSize":{"type":"number","description":"파일 크기"},"createdDt":{"type":"string","description":"생성 일자"}}},"Alarm":{"description":"알람","properties":{"id":{"type":"number","description":"알람 식별자"},"alarmDate":{"type":"string","description":"알람 일자"},"alarmType":{"type":"string","description":"알람 타입"},"userType":{"type":"string","description":"사용자 타입"},"userId":{"type":"string","description":"사용자 식별자"},"targetUrl":{"type":"string","description":"알람 링크"},"isRead":{"type":"string","description":"읽음 여부"},"alarmTitle":{"type":"string","description":"알람 제목"},"alarmContent":{"type":"string","description":"알람 내용"},"createdDt":{"type":"string","description":"생성 일자"},"updatedDt":{"type":"string","description":"수정 일자"}}},"Faq":{"description":"FAQ","properties":{"id":{"type":"number","description":"알람 식별자"},"userType":{"type":"string","description":"사용자 타입"},"faqCategory":{"type":"string","description":"FAQ 카테고리"},"faqQuestion":{"type":"string","description":"FAQ 질문"},"faqAnswer":{"type":"string","description":"FAQ 답변"},"createdDt":{"type":"string","description":"생성 일자"},"updatedDt":{"type":"string","description":"수정 일자"}}},"Ticket":{"description":"티켓","properties":{"id":{"type":"number","description":"티켓 식별자"},"ticketStatus":{"type":"boolean","description":"티켓 상태"},"ticketCategory":{"type":"string","description":"티켓 카테고리"},"ticketTitle":{"type":"string","description":"티켓 제목"},"ticketContent":{"type":"string","description":"티켓 내용"},"userType":{"type":"string","description":"사용자 타입"},"userId":{"type":"number","description":"사용자 식별자"},"phoneNumber":{"type":"string","description":"핸드폰 번호"},"email":{"type":"string","description":"이메일"},"ticketReply":{"type":"string","description":"티켓 답변"},"ticketAttachedUrl":{"type":"string","description":"티켓 첨부 주소"},"createdDt":{"type":"string","description":"생성일자"},"updatedDt":{"type":"string","description":"수정일자"},"ticketReplyUserId":{"type":"string","description":"티켓 답변 사용자 식별자"},"ticketReplyDt":{"type":"string","description":"티켓 답변 일자"}}},"ChannelVideo":{"description":"채널 비디오","properties":{"channelId":{"type":"number","description":"채널 식별자"},"videoId":{"type":"string","description":"비디오"},"title":{"type":"string","description":"비디오 제목 (호환성)"},"image":{"type":"string","description":"비디오 썸네일 주소"},"viewCount":{"type":"string","description":"조회수"},"uploadDay":{"type":"string","description":"업로드 일자"},"videoTitle":{"type":"string","description":"비디오 제목"}}},"ResultChannelRate":{"description":"채널 지수 정보","properties":{"channelId":{"type":"number"},"date":{"type":"string"},"viewRate":{"type":"number"},"viewCount":{"type":"number"},"positiveRate":{"type":"number"},"likeRate":{"type":"number"},"joinRate":{"type":"number"},"subscriberRate":{"type":"number"},"uploadRate":{"type":"number"},"videoRate":{"type":"number"},"amatchRate":{"type":"number"},"variantRate":{"type":"number"}}},"ResultChannelAverageRate":{"description":"채널 지수 평균 정보","properties":{"date":{"type":"string"},"viewRate":{"type":"number"},"viewCount":{"type":"number"},"positiveRate":{"type":"number"},"likeRate":{"type":"number"},"joinRate":{"type":"number"},"subscriberRate":{"type":"number"},"uploadRate":{"type":"number"},"videoRate":{"type":"number"},"amatchRate":{"type":"number"},"variantRate":{"type":"number"}}}},"host":"virtserver.swaggerhub.com","basePath":"/epcompanykorea/A-Match/1.0.0","schemes":["https","http"]}