> ## Documentation Index
> Fetch the complete documentation index at: https://generaltranslation.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Obtén acceso

> Regístrate para obtener acceso a la API y obtén tus credenciales

export const Button = ({href, children}) => {
  return <div className="not-prose group">
    <a href={href}>
      <button className="flex items-center space-x-2.5 py-1 px-4 bg-primary-dark dark:bg-white text-white dark:text-gray-950 rounded-full group-hover:opacity-[0.9] font-medium">
        <span>
          {children}
        </span>
        <svg width="3" height="24" viewBox="0 -9 3 24" class="h-6 rotate-0 overflow-visible"><path d="M0 0L3 3L0 6" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round"></path></svg>
      </button>
    </a>
  </div>;
};

Comienza a usar la X API en tres pasos: regístrate, crea una App y guarda tus credenciales.

<Button href="https://console.x.com">Regístrate ahora</Button>

***

<div id="step-1-create-a-developer-account">
  ## Paso 1: Crea una cuenta de desarrollador
</div>

<Steps>
  <Step title="Ve a la Consola de desarrollador">
    Visita [console.x.com](https://console.x.com) e inicia sesión con tu cuenta de X.
  </Step>

  <Step title="Acepta el Acuerdo de desarrollador">
    Lee y acepta el Acuerdo y la Política para desarrolladores.
  </Step>

  <Step title="Completa tu perfil">
    Proporciona información básica sobre cómo utilizarás la API.
  </Step>
</Steps>

***

<div id="step-2-create-an-app">
  ## Paso 2: Crea una app
</div>

Después de registrarte, crea una app para obtener tus credenciales de la API:

<Steps>
  <Step title="Haz clic en 'New App'">
    Desde el panel principal de la Consola de desarrollador, crea una nueva app.
  </Step>

  <Step title="Introduce los detalles de la app">
    Indica el nombre, la descripción y el caso de uso de tu app.
  </Step>

  <Step title="Genera credenciales">
    La consola generará tus claves y tokens de API.
  </Step>
</Steps>

***

<div id="step-3-save-your-credentials">
  ## Paso 3: Guarda tus credenciales
</div>

Recibirás varias credenciales según tus necesidades de autenticación:

| Credencial                | Propósito                                                                        |
| :------------------------ | :------------------------------------------------------------------------------- |
| **API Key & Secret**      | Identificar tu App. Se usan para generar tokens y firmar solicitudes OAuth 1.0a. |
| **Bearer Token**          | Autenticación de App únicamente para leer datos públicos.                        |
| **Access Token & Secret** | Realizar solicitudes en nombre de tu propia cuenta (OAuth 1.0a).                 |
| **Client ID & Secret**    | Autenticación OAuth 2.0 para solicitudes en contexto de usuario.                 |

<Warning>
  **Guárdalas de inmediato.** Las credenciales solo se muestran una vez. Almacénalas en un gestor de contraseñas o una bóveda segura. Si las pierdes, tendrás que regenerarlas (lo que invalida las anteriores).
</Warning>

***

<div id="which-credentials-do-you-need">
  ## ¿Qué credenciales necesitas?
</div>

<Tabs>
  <Tab title="Lectura de datos públicos">
    Usa el **Bearer Token** para un acceso sencillo y de solo lectura a datos públicos.

    ```bash theme={null}
    curl "https://api.x.com/2/users/by/username/xdevelopers" \
      -H "Authorization: Bearer $BEARER_TOKEN"
    ```

    Ideal para: buscar Publicaciones, consultar usuarios, leer tendencias.
  </Tab>

  <Tab title="Actuar como un usuario">
    Usa **OAuth 2.0** (recomendado) o **OAuth 1.0a** para actuar en nombre de los usuarios.

    OAuth 2.0 ofrece ámbitos de permisos granulares: solicita solo los permisos que necesitas.

    Ideal para: publicar, indicar "Me gusta", seguir, acceder a mensajes directos (MD).

    [Guía de OAuth 2.0 →](/es/resources/fundamentals/authentication/oauth-2-0/overview)
  </Tab>

  <Tab title="Actuar como tú mismo">
    Usa tu **Access Token y Secret** para hacer solicitudes como tu propia cuenta.

    Estos tokens representan la cuenta que es propietaria de la App.

    Ideal para: pruebas, bots personales y tu propia automatización.
  </Tab>
</Tabs>

***

<div id="credential-security-best-practices">
  ## Mejores prácticas de seguridad de credenciales
</div>

<CardGroup cols={2}>
  <Card title="Usa variables de entorno" icon="terminal">
    Nunca incluyas credenciales directamente en tu código fuente.
  </Card>

  <Card title="No hagas commits en Git" icon="code-branch">
    Añade los archivos de credenciales a `.gitignore`.
  </Card>

  <Card title="Rota las credenciales con regularidad" icon="arrows-rotate">
    Regenera las credenciales periódicamente como medida de seguridad.
  </Card>

  <Card title="Usa scopes mínimos" icon="shield-check">
    Solicita solo los permisos de OAuth que tu App necesita.
  </Card>
</CardGroup>

***

<div id="next-steps">
  ## Próximos pasos
</div>

<CardGroup cols={2}>
  <Card title="Realiza tu primera solicitud" icon="rocket" href="/es/x-api/getting-started/make-your-first-request">
    Realiza una llamada a la API con tus nuevas credenciales.
  </Card>

  <Card title="Aprende sobre autenticación" icon="key" href="/es/resources/fundamentals/authentication/overview">
    Conoce OAuth 1.0a y OAuth 2.0.
  </Card>
</CardGroup>
