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

# Comenzando con Alvys

> Comience con Alvys Public API: cree credenciales de cliente, solicite un token de acceso OAuth y realice su primera llamada API autenticada.

Esta página le ayudará a empezar con Alvys. ¡Estarás listo y funcionando en un santiamén!

<Note>
  **A partir de junio de 2025, Alvys** actualizó la forma en que emitimos tokens de acceso, brindando **seguridad mejorada** y un **modelo de permisos más detallado**. El flujo principal OAuth 2.0 sigue siendo el mismo, pero el punto final de solicitud de token ha cambiado. El método heredado basado en `/authentication/{tenant_id}/token` quedará obsoleto pronto.
</Note>

<br />

### Crear aplicación de cliente

Para comenzar, cree una nueva aplicación desde la página de administración Alvys. Esto le permitirá generar un `client_id` y un `client_secret`.

* `client_id`: el identificador único asignado a esta aplicación o persona que llama.
* `client_secret`: un token confidencial que también proporciona Alvys al registrar la aplicación.

***

### Obtener un token de acceso

Una vez que haya creado sus credenciales, las usará para recuperar un token de portador. Luego, este token se pasa en el encabezado `Authorization` de cada solicitud de API.

#### ✅ Requisitos previos

Antes de solicitar un token de acceso, asegúrese de tener lo siguiente:

* **Client ID** y **Client Secret** (desde el Portal de administración)
* La **Audiencia API**: `https://api.alvys.com/public/`
* El **`grant_type`** correcto: `client_credentials`

### URL del token (actual)

```
https://auth.alvys.com/oauth/token

```

### Cuerpo de solicitud

```json theme={null}
{
  "client_id": "YOUR_CLIENT_ID",
  "client_secret": "YOUR_CLIENT_SECRET",
  "audience": "https://api.alvys.com/public/",
  "grant_type": "client_credentials"
}

```

Para obtener información detallada, visite nuestra página [Autenticación](/docs/authentication-1).