Skip to main content
이 모듈은 X API와 상호작용하기 위한 주요 Client 클래스를 제공합니다. 모든 하위 클라이언트를 조정하고 인증, 세션 관리, OAuth2 PKCE 흐름을 처리합니다. 모든 기능은 OpenAPI 명세에서 생성됩니다.

Client

Class 기반 클래스: object | None = None) X API와 상호작용하기 위한 클라이언트입니다.

생성자

__init__

X API 클라이언트를 초기화합니다.

매개변수

str
default:"'https://api.x.com'"
X API의 기본 URL입니다(기본값은 https://api.x.com).
str or None
default:"None"
X API의 Bearer Token입니다(앱 전용 인증).
str or None
default:"None"
사용자 컨텍스트를 위한 OAuth 2.0 액세스 토큰입니다(Bearer Token으로 직접 사용 가능).
str or None
default:"None"
X API의 client ID입니다(OAuth 2.0 PKCE 흐름에 필요).
str or None
default:"None"
X API의 client secret입니다.
str or None
default:"None"
OAuth 2.0 인증을 위한 redirect URI입니다.
Dict[str, Any] or None
default:"None"
기존 OAuth 2.0 토큰 딕셔너리입니다(가능한 경우). 제공되면 access_token이 추출됩니다.
str or List[str] or None
default:"None"
OAuth 2.0 인증 스코프를 위한 공백으로 구분된 문자열 또는 문자열 목록입니다.
str
default:"'https://x.com/i'"
OAuth 2.0 인증을 위한 기본 URL입니다(기본값은 https://x.com/i).
OAuth1
OAuth 1.0a 인증을 위한 OAuth1 인스턴스입니다.

매개변수

str
default:"'https://api.x.com'"
str or None
default:"None"
str or None
default:"None"
str or None
default:"None"
str or None
default:"None"
str or None
default:"None"
Dict[str, Any] or None
default:"None"
str or List[str] or None
default:"None"
str
default:"'https://x.com/i'"
OAuth1

exchange_code

인증 코드를 토큰으로 교환합니다(TypeScript API와 일치).

매개변수

Any
콜백에서 받은 인증 코드입니다.
Any
default:"None"
선택적 code verifier입니다(제공되지 않으면 저장된 verifier를 사용).

fetch_token

인증 응답 URL을 사용하여 토큰을 가져옵니다(레거시 메서드).

매개변수

Any
인증 후 수신된 전체 콜백 URL입니다.

get_authorization_url

OAuth 2.0 PKCE 흐름을 위한 인증 URL을 가져옵니다.

매개변수

Any
default:"None"
보안을 위한 선택적 state 매개변수입니다.

is_token_expired

OAuth 2.0 토큰이 만료되었는지 확인합니다.

refresh_token

OAuth 2.0 토큰을 갱신합니다.