Obtener una clave de API
YCloud autentica las solicitudes del lado del servidor con claves de API. Crea o consulta una clave de API en Panel de control > Desarrolladores > Claves de API, y luego envíala en el encabezado de solicitud X-API-Key.
Mantén las claves de API en tu servidor. Nunca las subas a un repositorio ni las expongas en el código del navegador o de una aplicación móvil.
Explorar el endpoint
Abre Enviar un SMS para ver los parámetros completos de la solicitud, el esquema de respuesta y el generador interactivo de solicitudes. Para consultar el flujo de trabajo de integración integral y las consideraciones de entrega, consulta Enviar un SMS.
Manejar la respuesta
Una respuesta 2xx significa que YCloud aceptó la solicitud. No significa necesariamente que el SMS haya llegado al destinatario. Guarda el ID del mensaje devuelto y correlaciónalo con los resultados de consulta o los eventos de webhook para rastrear la entrega.
Manejar errores
Las respuestas de error incluyen tres campos:
code es el identificador de error estable y legible por máquina.message explica el error a los desarrolladores.requestId ayuda al soporte de YCloud a solucionar problemas en una solicitud.
Usa el identificador de error estable en la lógica de tu aplicación. No intentes hacer coincidir la explicación orientada al desarrollador. Consulta Manejar errores para ver el formato de respuesta y la guía de reintentos.
