Configurer votre propre API Key X

​

Étape 1 : créer votre compte X Developer

1

Se connecter à la Developer Console

Rendez-vous sur console.x.com et connectez-vous avec votre compte X. Consultez le guide de démarrage de X si vous avez besoin d’aide.

2

Terminer l'onboarding

Terminez l’onboarding développeur et acceptez le Developer Agreement et les politiques.

3

Accéder à la console

Vous êtes maintenant dans la X Developer Console.

​

Étape 2 : créer une App

1

Accéder à Apps

Dans la Developer Console, allez dans Apps.

2

Créer l'application

Dans le tableau de bord App, cliquez sur Create App (consultez la documentation de configuration des apps de X pour plus de détails). Saisissez un nom d’application (typiquement le nom de votre marque). Ce nom apparaîtra dans l’écran d’autorisation OAuth lorsque les utilisateurs connectent leur compte X.

3

Sélectionner l'environnement

Sélectionnez l’environnement Production dans le menu déroulant.

4

Fermer la fenêtre initiale des identifiants

X générera plusieurs identifiants. Ignorez ces identifiants et fermez cette fenêtre.

​

Étape 3 : configurer les autorisations de l’App

1

Ouvrir les paramètres de votre app

Sous « Apps », localisez la nouvelle application (rafraîchissez la page si elle n’apparaît pas), puis cliquez dessus pour afficher ses détails.Sous User authentication settings, cliquez sur Set up.

2

Définir les autorisations de l'app

Sous App permissions, sélectionnez Read and write and Direct message. Cela est requis pour la prise en charge complète des fonctionnalités, y compris la publication et les DM.

3

Définir le type d'app

Sous Type of App, sélectionnez Web App, Automated App or Bot. C’est le bon choix pour les intégrations côté serveur comme Ayrshare.

4

Définir les URL de callback et du site web

Sous App info :

• Callback URL : ajoutez les deux URL de callback suivantes :
  • https://profile.ayrshare.com/social-accounts
  • https://app.ayrshare.com/social-accounts
• Website URL : https://app.ayrshare.com

Ne sautez pas cette étape. Ces URL de callback sont nécessaires pour le flux de connexion OAuth. Lorsque vos utilisateurs finaux autorisent la connexion X, X les redirige vers l’une de ces URL pour terminer le processus de connexion. Si elles manquent, le flux OAuth échouera avec une erreur 403 Callback URL not approved.

5

Enregistrer vos paramètres

Cliquez sur Save. Vous pouvez ignorer la fenêtre contextuelle OAuth 2.0, car vous n’utiliserez que 2 des clés OAuth 1.0 (API Key et API Secret).

Important : définissez les autorisations avant la connexion. Les autorisations choisies ici déterminent ce que votre application peut faire. Si vous modifiez les autorisations après avoir connecté votre compte X via OAuth, vous devrez le reconnecter afin que le nouveau Access Token hérite des autorisations mises à jour.

1. API Key (également appelée Consumer Key, l’identifiant de l’application X)
2. API Secret (également appelé Consumer Secret)

​

Étape 4 : acheter des crédits d’API X

1

Accéder à la facturation

Dans la Developer Console, cliquez sur Billing → Credits dans la barre latérale de gauche.

2

Acheter des crédits

Achetez des crédits (le minimum est de $5, ce qui suffit pour des centaines d’appels API). Chaque appel API coûte une fraction de centime, donc le coût devrait être minime pour la plupart des utilisateurs.

3

Activer la recharge automatique

Vous pouvez activer la recharge automatique pour éviter les interruptions de service et gérer votre plafond de dépense en définissant un montant maximum que vous pouvez dépenser dans votre cycle de facturation.

​

Étape 5 : mettre à jour vos appels à l’API Ayrshare

1. API Key (également appelée Consumer Key, l’identifiant de l’application X)
2. API Secret (également appelé Consumer Secret)

​

Référence des en-têtes

​

Exemples de code

curl -X POST https://api.ayrshare.com/api/post \
  -H "Authorization: Bearer YOUR_AYRSHARE_API_KEY" \
  -H "X-Twitter-OAuth1-Api-Key: your_api_key" \
  -H "X-Twitter-OAuth1-Api-Secret: your_api_secret" \
  -H "Content-Type: application/json" \
  -d '{"post": "Hello from my own X App!", "platforms": ["twitter"]}'

const response = await fetch("https://api.ayrshare.com/api/post", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_AYRSHARE_API_KEY",
    "Content-Type": "application/json",
    "X-Twitter-OAuth1-Api-Key": process.env.X_API_KEY,
    "X-Twitter-OAuth1-Api-Secret": process.env.X_API_SECRET,
  },
  body: JSON.stringify({
    post: "Hello from my own X App!",
    platforms: ["twitter"],
  }),
});

import os
import requests

headers = {
    "Authorization": "Bearer YOUR_AYRSHARE_API_KEY",
    "Content-Type": "application/json",
    "X-Twitter-OAuth1-Api-Key": os.environ["X_API_KEY"],
    "X-Twitter-OAuth1-Api-Secret": os.environ["X_API_SECRET"],
}

response = requests.post(
    "https://api.ayrshare.com/api/post",
    headers=headers,
    json={"post": "Hello from my own X App!", "platforms": ["twitter"]},
)

​

Migrer les profils existants (Business & Enterprise)

{
  "domain": "your-domain",
  "profileKey": "...",
  "privateKey": "...",
  "twitterApiKey": "YOUR_X_CONSUMER_KEY",
  "twitterApiSecret": "YOUR_X_CONSUMER_SECRET"
}

​

Vérifier votre configuration

​

Comment fonctionne la tarification de l’API X

​

Avantages de l’utilisation de votre propre API Key X

• Expérience OAuth de marque : les utilisateurs voient le nom et l’image de marque de votre application lorsqu’ils autorisent l’accès à X.
• Limites de débit dédiées : votre utilisation de l’API est régie par les limites de votre propre compte X Developer, distinctes des autres utilisateurs d’Ayrshare. Vous pouvez surveiller votre utilisation dans la X Developer Console et consulter la documentation sur les limites de débit de l’API X.
• Contrôle des identifiants : votre API Key et votre Secret restent dans votre propre compte X Developer. Ayrshare ne stocke pas vos clés secrètes.
• Portabilité : comme les utilisateurs s’authentifient avec votre X App, votre intégration reste entièrement sous votre contrôle.
• Visibilité de l’utilisation : votre tableau de bord X Developer affiche les requêtes API, les limites de débit et l’utilisation des crédits.

​

Sécurité

• Votre API Key et votre API Secret ne sont pas stockés par Ayrshare.
• Pour les bonnes pratiques générales de sécurité, consultez le guide de sécurité d’authentification de X.

​

FAQ

​

Dépannage

​

Besoin d’aide ?