Skip to main content
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

1

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.
No confirmes claves de API en el control de versiones. Consulta Autenticación para ver directrices de producción.
2

Consulta tu saldo

Obtén el saldo de tu cuenta.

​
Respuesta

Una solicitud exitosa devuelve HTTP 200 con tu saldo actual.
Si la API devuelve 401 o 403, comprueba el nombre del encabezado y la clave de API. Consulta Gestión de errores antes de añadir reintentos.
Una respuesta de saldo exitosa confirma que tu URL base y tu clave de API funcionan juntas.

​
Próximos pasos

Enviar un mensaje de WhatsApp

Envía plantillas, texto y mensajes multimedia.

Configurar webhooks

Recibe actualizaciones de entrega y mensajes entrantes.

Gestionar errores de la API

Lee respuestas de error y diseña reintentos seguros.

Referencia de la API de Balance

Inspecciona el esquema de respuesta completo y prueba el endpoint.