Passer au contenu principal
Cet exemple illustre comment rechercher rapidement des Publications avec le XDK en utilisant une authentification par Jeton Bearer.

Étape 1 : Installez le SDK

pip install xdk

Étape 2 : Obtenir votre Jeton Bearer

  1. Connectez-vous à la Console de développement X.
  2. Créez une App ou sélectionnez-en une.
  3. Dans « Keys and Tokens », générez un Jeton Bearer (authentification App uniquement).

Étape 3 : Écrire et exécuter votre premier script

Créez un fichier quickstart.py :
# Import the client
from xdk import Client
# Replace with your actual Bearer Token
client = Client(bearer_token="YOUR_BEARER_TOKEN_HERE")
# Fetch recent Posts mentioning "api"
# search_recent returns an Iterator, so iterate over it
for page in client.posts.search_recent(query="api", max_results=10):
    if page.data and len(page.data) > 0:
        # Accéder à la première Publication - les modèles Pydantic prennent en charge l'accès par attribut et par dictionnaire
        first_post = page.data[0]
        post_text = first_post.text if hasattr(first_post, 'text') else first_post.get('text', '')
        print(f"Latest Post: {post_text}")
        break
    else:
        print("No Posts found.")
        break
Exécutez-la :
python quickstart.py
Résultat attendu:
Dernière Publication : Mises à jour passionnantes sur le SDK Python XDK !
Dépannage : Si vous rencontrez une erreur 401, vérifiez à nouveau votre Jeton Bearer. En cas de dépassement des limites de taux (429), attendez puis réessayez.

Prochaines étapes

  • Explorez Authentication pour comprendre comment utiliser l’authentification par Jeton Bearer (app-only), OAuth 2.0 avec PKCE (contexte utilisateur) et OAuth 1.0a (contexte utilisateur hérité).
  • Découvrez la Pagination pour les cas d’usage où vous souhaitez récupérer un grand nombre de résultats sans avoir à gérer plusieurs appels API.
  • Plongez dans la section Streaming pour apprendre à travailler avec des données en temps réel. Pour des exemples de code détaillés utilisant le XDK pour Python, consultez notre dépôt GitHub d’exemples de code.