Basic Feature

클라이언트 (Client)

class Client(loop: AbstractEventLoop | None = None, authorization_key: str | None = None, session_key: str | None = None)

치지직(네이버 스트리밍 서비스) 기능을 제공하기 위한 객체를 제공합니다.

async autocomplete(keyword: str) → list[str]

Get a auto-completed keyword.

매개변수:

keyword (str) – 검색할 단어입니다.

반환:

자동 완성된 단어입니다.

반환 형식:

list[str]

async close()

치지직과 연결을 종료합니다.

property is_closed: bool

치지직 연결을 종료한 유/무를 불러옵니다.

async live_detail(channel_id: str) → LiveDetail | None

채널의 실시간 방송 정보(live detail)를 불러오는 함수입니다.

매개변수:

channel_id (str) – 채널의 ID 값입니다.

반환:

자세한 정보가 담긴 실시간 방송(LiveDetail)를 불러옵니다.스트리머가 오랫동안 방송하지 않으면 `None`을 응답받을 수 있습니다.

반환 형식:

Optional[LiveDetail]

async live_status(channel_id: str) → LiveStatus | None

채널의 실시간 방송 상태(live status)를 불러옵니다.

매개변수:

channel_id (str) – 채널의 ID 값입니다.

반환:

실시간 방송 상태(LiveStatus)를 불러옵니다.스트리머가 오랫동안 방송하지 않으면 `None`을 응답받을 수 있습니다.

반환 형식:

Optional[LiveStatus]

login(authorization_key: str, session_key: str)

네이버 로그인을 합니다. 일부 기능을 이용하려면 로그인이 필요합니다.

매개변수:

  • authorization_key (str) – HTTP 전송되는 쿠키 중의 NID_AUT 값을 의미합니다.

  • session_key (str) – HTTP 전송되는 쿠키 중의 NID_SES 값을 의미합니다.

async search_channel(keyword: str) → list[Channel]

키워드를 이용하여 채널을 검색합니다.

매개변수:

keyword (str) – 검색할 채널 입니다.

반환:

검색된 채널을 반환받습니다.

반환 형식:

list[Channel]

async search_live(keyword: str) → list[Live]

키워드를 이용하여 실시간 방송을 검색합니다.

매개변수:

keyword (str) – 검색할 실시간 방송입니다.

반환:

검색된 실시간 방송 정보를 반환받습니다.

반환 형식:

list[Video]

async search_video(keyword: str) → list[Video]

키워드를 이용하여 영상을 검색합니다.

매개변수:

keyword (str) – 검색할 영상입니다.

반환:

검색된 영상 정보를 반환받습니다.

반환 형식:

list[Video]

async user() → User

내 정보를 불러옵니다. 이 기능을 사용하려면 로그인이 필요합니다.

반환:

로그인된 나의 정보입니다.

반환 형식:

User

Channel

class PartialChannel
id: str
image: str | None
name: str
personal_data: ChannelPersonalData | None
verified_mark: bool
class Channel

기반 클래스: PartialChannel

description: str
follower: int
open_live: bool
class ChannelPersonalData
private_user_block: bool

User

class User
has_profile: bool
logged_in: bool | None
nickname: str | None
official_noti_agree: bool
official_noti_agree_updated_date: Annotated[datetime | None, BeforeValidator(func=special_date_parsing_validator)]
penalties: list[Any] | None
profile_image_url: str | None
user_id_hash: str | None
verified_mark: bool

Video

class Video
adult: bool
category_type: str | None
channel: PartialChannel | None
channel_id: str
duration: int
id: str | None
number: int
publish_date: Annotated[datetime, BeforeValidator(func=special_date_parsing_validator)]
read_count: int
thumbnail_image_url: str | None
title: str
type: str
video_category: str | None
video_category_value: str

Exceptions

exception LoginRequired

이 기능을 이용하기 위해서는 로그인이 필요합니다. Client.login 함수를 이용하여 로그인해주세요.

exception HTTPException

치지직 호출 중에 HTTP 예외가 발생하였습니다.

exception NotFound

조회된 결과가 없습니다.