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

# Inicio rápido

> Autentícate con YCloud y realiza tu primera solicitud de API.

En este inicio rápido, llamarás a la API de Balance para confirmar que tu URL base y tu clave de API estén configuradas correctamente.

## Antes de comenzar

Necesitas:

* Una cuenta de YCloud
* Una clave de API de YCloud
* `curl` u otro cliente HTTP

## Cómo funciona

Cada solicitud de API en el servidor utiliza la URL base `https://api.ycloud.com/v2` y envía tu clave en el encabezado `X-API-Key`. Este ejemplo consulta el saldo de la cuenta porque no crea ni envía nada.

## Solicitud

<Steps>
  <Step title="Guarda tu clave de API">
    Exporta la clave en tu sesión actual de terminal. Reemplaza el marcador de posición con tu clave real.

    ```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
    export YCLOUD_API_KEY="YOUR_API_KEY"
    ```

    No confirmes claves de API en el control de versiones. Consulta [Autenticación](/es/api-reference/guides/api-fundamentals/authentication) para ver directrices de producción.
  </Step>

  <Step title="Consulta tu saldo">
    Obtén el saldo de tu cuenta.

    ```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
    curl https://api.ycloud.com/v2/balance \
      --header "X-API-Key: $YCLOUD_API_KEY" \
      --header "Accept: application/json"
    ```
  </Step>
</Steps>

## Respuesta

Una solicitud exitosa devuelve HTTP `200` con tu saldo actual.

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "amount": 10.5,
  "currency": "USD"
}
```

| Campo | Descripción |
| - | - |
| `amount` | Saldo disponible en la cuenta. |
| `currency` | Moneda ISO utilizada por la cuenta. |

Si la API devuelve `401` o `403`, comprueba el nombre del encabezado y la clave de API. Consulta [Gestión de errores](/es/api-reference/guides/api-fundamentals/handle-errors) antes de añadir reintentos.

<Tip>Una respuesta de saldo exitosa confirma que tu URL base y tu clave de API funcionan juntas.</Tip>

## Próximos pasos

<CardGroup cols={2}>
  <Card title="Enviar un mensaje de WhatsApp" icon="whatsapp" href="/es/api-reference/guides/whatsapp-platform/send-whatsapp-message">
    Envía plantillas, texto y mensajes multimedia.
  </Card>

  <Card title="Configurar webhooks" icon="webhook" href="/es/api-reference/guides/api-fundamentals/configure-webhooks">
    Recibe actualizaciones de entrega y mensajes entrantes.
  </Card>

  <Card title="Gestionar errores de la API" icon="triangle-exclamation" href="/es/api-reference/guides/api-fundamentals/handle-errors">
    Lee respuestas de error y diseña reintentos seguros.
  </Card>

  <Card title="Referencia de la API de Balance" icon="code" href="/api-reference/balance/retrieve-balance">
    Inspecciona el esquema de respuesta completo y prueba el endpoint.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.