> ## 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.

# Interfaz de API

> Autentícate con una clave de API y envía mensajes SMS a través de la API de YCloud.

## 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**](https://www.ycloud.com/console/#/app/developers/apikey), y luego envíala en el encabezado de solicitud `X-API-Key`.

<Warning>
  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.
</Warning>

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl --request POST 'https://api.ycloud.com/v2/sms' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "to": "+16315551234",
    "text": "Your verification code is 123456."
  }'
```

Si prefieres usar un SDK, consulta los lenguajes disponibles y las instrucciones de instalación en [YCloud Developers](https://github.com/ycloud-developers).

## Explorar el endpoint

Abre [Enviar un SMS](/api-reference/sms/send-an-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](/es/api-reference/guides/messaging/send-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](/es/api-reference/guides/api-fundamentals/handle-errors) para ver el formato de respuesta y la guía de reintentos.


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