Skip to main content

Subpaquetes

Submódulos

Contenido del módulo

SDK de Python XDK. Un SDK de Python para la X API que ofrece acceso conveniente a los endpoints de la X API con seguridad de tipos y soporte de autenticación.

class xdk.Client

Cliente para interactuar con la X API.

Parámetros

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

__init__

Inicializa el cliente de la X API.

Parámetros

str
default:"'https://api.x.com'"
La URL base de la X API (por defecto https://api.x.com).
str or None
default:"None"
El bearer token para la X API (autenticación app-only).
str or None
default:"None"
El access token de OAuth2 para contexto de usuario (puede usarse directamente como bearer token).
str or None
default:"None"
El client ID para la X API (requerido para el flujo OAuth2 PKCE).
str or None
default:"None"
El client secret para la X API.
str or None
default:"None"
La URI de redirección para la autorización OAuth2.
Dict[str, Any] or None
default:"None"
Un diccionario de token OAuth2 existente (si está disponible). Si se proporciona, se extraerá access_token.
str or List[str] or None
default:"None"
Cadena separada por espacios o lista de cadenas para los scopes de autorización OAuth2.
str
default:"'https://x.com/i'"
La URL base para la autorización OAuth2 (por defecto https://x.com/i).
OAuth1
Instancia de OAuth1 para la autenticación OAuth 1.0a.

exchange_code

Intercambia el código de autorización por tokens (coincide con la API de TypeScript).

Parámetros

Any
El código de autorización del callback.
Any
default:"None"
Verificador de código opcional (usa el verificador almacenado si no se proporciona).

fetch_token

Obtiene el token usando la URL de respuesta de autorización (método heredado).

Parámetros

Any
La URL de callback completa recibida después de la autorización.

get_authorization_url

Obtiene la URL de autorización para el flujo OAuth2 PKCE.

Parámetros

Any
default:"None"
Parámetro de estado opcional por seguridad.

is_token_expired

Verifica si el token OAuth2 ha expirado.

refresh_token

Renueva el token OAuth2.

class xdk.Cursor

[ResponseType]

Parámetros

PaginatableMethod

__init__

Inicializa el cursor.

Parámetros

PaginatableMethod
El método de la API a llamar por cada página (debe admitir paginación)

items

Itera sobre elementos individuales de respuestas paginadas.

Parámetros

int or None
default:"None"
Número máximo de elementos a devolver (None para ilimitado)

Devuelve

IteratorAny

pages

Itera sobre páginas de respuestas.

Parámetros

int or None
default:"None"
Número máximo de páginas a devolver (None para ilimitado)

Devuelve

IteratorResponseType

class xdk.StreamConfig

Configuración para conexiones de streaming con comportamiento de reintentos.

Parámetros

int
default:"10"
float
default:"1.0"
float
default:"64.0"
float
default:"2.0"
bool
default:"True"
float or None
default:"None"
int
default:"1024"
Callable[[], None] or None
default:"None"
Callable[[Exception or None], None] or None
default:"None"
Callable[[int, float], None] or None
default:"None"
Callable[[[StreamError

__init__

Parámetros

int
default:"10"
float
default:"1.0"
float
default:"64.0"
float
default:"2.0"
bool
default:"True"
float or None
default:"None"
int
default:"1024"
Callable[[], None] or None
default:"None"
Callable[[Exception or None], None] or None
default:"None"
Callable[[int, float], None] or None
default:"None"
Callable[[[StreamError

on_error : Callable[[[StreamError]

exception xdk.StreamError

Excepción lanzada para errores de streaming con clasificación.

Parámetros

str
StreamErrorType

__init__

Parámetros

str
StreamErrorType

class xdk.StreamErrorType

Clasificación de errores de streaming para decisiones de reintento.

Parámetros

Any

class xdk.StreamState

Estado interno de una conexión de streaming.

Parámetros

int
default:"0"
float
default:"1.0"
bool
default:"False"
int
default:"0"
StreamError

__init__

Parámetros

int
default:"0"
float
default:"1.0"
bool
default:"False"
int
default:"0"
StreamError

last_error : [StreamError]

xdk.cursor

Crea un cursor con inferencia y validación de tipos adecuadas. Esta función factory ayuda con la inferencia de tipos para que obtengas sugerencias de tipo adecuadas para el tipo de respuesta, y valida que el método admita paginación tanto en análisis estático como en tiempo de ejecución.

Parámetros

PaginatableMethod
El método de la API a envolver (debe admitir paginación)