메인 콘텐츠로 건너뛰기
이 모듈은 X API와 상호작용하기 위한 기본 Client 클래스를 제공합니다. 모든 하위 클라이언트를 통합하고 인증, 세션 관리, OAuth2 PKCE 플로우를 처리합니다. 모든 기능은 OpenAPI 명세를 기반으로 생성됩니다.

​
Client

클래스 베이스 클래스: object | None = None) X API와 상호 작용하기 위한 Client 클래스입니다.

​
생성자

​
__init__

X API Client를 초기화합니다.

​
Parameters

​
path.base_url
str
기본값:"'https://api.x.com'"
X API의 기본 URL입니다 (기본값: https://api.x.com).
​
path.bearer_token
str or None
기본값:"None"
X API용 Bearer 토큰입니다 (앱 전용 인증).
​
path.access_token
str or None
기본값:"None"
사용자 컨텍스트용 OAuth2 액세스 토큰입니다 (Bearer 토큰으로 직접 사용할 수 있습니다).
​
path.client_id
str or None
기본값:"None"
X API용 client ID입니다 (OAuth2 PKCE 플로우에 필요).
​
path.client_secret
str or None
기본값:"None"
X API용 client secret입니다.
​
path.redirect_uri
str or None
기본값:"None"
OAuth2 인가를 위한 redirect URI입니다.
​
path.token
Dict[str, Any] or None
기본값:"None"
기존 OAuth2 토큰 딕셔너리입니다 (있는 경우). 제공되면 access_token이 추출됩니다.
​
path.scope
str or List[str] or None
기본값:"None"
OAuth2 인가 스코프를 위한 공백으로 구분된 문자열 또는 문자열 리스트입니다.
​
path.authorization_base_url
str
기본값:"'https://x.com/i'"
OAuth2 인가용 기본 URL입니다 (기본값: https://x.com/i).
​
path.auth
OAuth1
OAuth1.0a 인증을 위한 OAuth1 인스턴스입니다.

​
매개변수

​
path.base_url
str
기본값:"'https://api.x.com'"
​
path.bearer_token
str or None
기본값:"None"
​
path.access_token
str or None
기본값:"None"
​
path.client_id
str or None
기본값:"None"
​
path.client_secret
str or None
기본값:"None"
​
path.redirect_uri
str or None
기본값:"None"
​
path.token
Dict[str, Any] or None
기본값:"None"
​
path.scope
str or List[str] or None
기본값:"None"
​
path.authorization_base_url
str
기본값:"'https://x.com/i'"
​
path.auth
OAuth1

​
exchange_code

인증 코드를 토큰으로 교환합니다(시그니처는 TypeScript API와 동일).

​
매개변수

​
path.code
Any
콜백에서 전달된 authorization code입니다.
​
path.code_verifier
Any
기본값:"None"
선택적 code verifier입니다(제공하지 않으면 저장된 verifier를 사용합니다).

​
fetch_token

인가 응답 URL을 사용해 토큰을 가져오는 레거시 메서드입니다.

​
매개변수

​
path.authorization_response
Any
인가 후 수신한 전체 콜백 URL입니다.

​
get_authorization_url

OAuth 2.0 PKCE 플로우용 인가 URL을 반환합니다.

​
매개변수

​
path.state
Any
기본값:"None"
보안 강화를 위한 선택적 state 매개변수입니다.

​
is_token_expired

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

​
refresh_token

OAuth2 토큰을 갱신합니다.