Configura tu propia clave de API de X

​

Paso 1: Crea tu cuenta de X Developer

1

Inicia sesión en la Developer Console

Ve a console.x.com e inicia sesión con tu cuenta de X. Consulta la guía de introducción de X si necesitas ayuda.

2

Completa la incorporación

Completa la incorporación de desarrollador y acepta el Developer Agreement y las políticas.

3

Accede a la consola

Ya estás en la X Developer Console.

​

Paso 2: Crear una app

1

Navega a Apps

En la Developer Console, navega a Apps.

2

Crear la app

En el App dashboard, haz clic en Create App (consulta la documentación de configuración de App de X para más detalles). Introduce un nombre de app (típicamente el nombre de tu marca). Este nombre aparecerá en la pantalla de autorización de OAuth cuando los usuarios conecten su cuenta de X.

3

Seleccionar entorno

Selecciona el entorno Production en el desplegable.

4

Cierra la ventana emergente de credenciales inicial

X generará varias credenciales. Ignora estas credenciales y cierra esta ventana.

​

Paso 3: Configurar los permisos de la app

1

Abre la configuración de tu app

En “Apps”, localiza la nueva app (actualiza la página si no aparece) y luego haz clic en ella para ver sus detalles.En User authentication settings, haz clic en Set up.

2

Establecer permisos de la app

En App permissions, selecciona Read and write and Direct message. Esto es necesario para el soporte completo de funciones, incluidas las publicaciones y los DMs.

3

Establecer el tipo de app

En Type of App, selecciona Web App, Automated App or Bot. Esta es la elección correcta para integraciones del lado del servidor como Ayrshare.

4

Establece las URLs de callback y del sitio web

En App info:

• Callback URL: Añade ambas de las siguientes URLs de callback:
  • https://profile.ayrshare.com/social-accounts
  • https://app.ayrshare.com/social-accounts
• Website URL: https://app.ayrshare.com

No omitas este paso. Estas URLs de callback son necesarias para el flujo de vinculación OAuth. Cuando tus usuarios finales autorizan la conexión a X, X los redirige a una de estas URLs para completar el proceso de vinculación. Si faltan, el flujo de OAuth fallará con un error 403 Callback URL not approved.

5

Guarda tu configuración

Haz clic en Save. Puedes ignorar la ventana emergente de OAuth 2.0, ya que solo usarás 2 de las claves de OAuth 1.0 (API Key y API Secret).

Importante: establece los permisos antes de vincular. Los permisos que elijas aquí determinan lo que tu app puede hacer. Si cambias los permisos después de vincular tu cuenta de X vía OAuth, tendrás que volver a vincularla para que el nuevo Access Token herede los permisos actualizados.

1. API Key (también conocida como Consumer Key, el identificador de la app de X)
2. API Secret (también conocida como Consumer Secret)

​

Paso 4: Comprar créditos de API de X

1

Navega a facturación

En la Developer Console, haz clic en Billing → Credits en la barra lateral izquierda.

2

Comprar créditos

Compra créditos (el mínimo es $5, suficiente para cientos de llamadas a la API). Cada llamada a la API es una fracción de centavo, por lo que el costo debería ser mínimo para la mayoría de los usuarios.

3

Habilita la recarga automática

Puedes habilitar la auto-recharge para evitar interrupciones del servicio y gestionar tu spend cap estableciendo un monto máximo que puedes gastar en tu ciclo de facturación.

​

Paso 5: Actualizar tus llamadas a la API de Ayrshare

1. API Key (también conocida como Consumer Key, el identificador de la app de X)
2. API Secret (también conocida como Consumer Secret)

​

Referencia de headers

​

Ejemplos de código

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"]},
)

​

Migrar perfiles existentes (Business y Enterprise)

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

​

Verifica tu configuración

​

Cómo funciona el precio de la API de X

​

Beneficios de usar tu propia clave de API de X

• Experiencia OAuth con marca: Los usuarios ven el nombre y la marca de tu app cuando autorizan el acceso a X.
• Límites de tasa dedicados: Tu uso de la API se rige por los límites de tu propia cuenta de X Developer, separados de otros usuarios de Ayrshare. Puedes monitorear tu uso en la X Developer Console y revisar la documentación de rate limits de la API de X.
• Control de credenciales: Tu API Key y Secret permanecen en tu propia cuenta de X Developer. Ayrshare no almacena tus claves secretas.
• Portabilidad: Como los usuarios se autentican con tu X App, tu integración permanece totalmente bajo tu control.
• Visibilidad del uso: Tu panel de X Developer muestra las solicitudes a la API, los rate limits y el uso de créditos.

​

Seguridad

• Ayrshare no almacena tu API Key ni tu API Secret.
• Para las mejores prácticas de seguridad general, consulta la guía de seguridad de autenticación de X.

​

Preguntas frecuentes

​

Solución de problemas

​

¿Necesitas ayuda?