# Crear enlace de conexión remota al teléfono en la nube

Crea un enlace temporal de acceso por navegador al teléfono en la nube (solo Open API).
- **Requisitos**: el teléfono debe pertenecer al equipo, ser accesible para el miembro que llama, estar encendido y no estar ocupado por otro miembro. La API no lo enciende automáticamente.
- **Efecto**: cada llamada crea un enlace nuevo sin solicitar credenciales de conexión ni modificar la conexión actual. Abra `data.url` en un navegador o genere un código QR con la URL completa.
- **Validez**: exactamente 5 minutos desde la creación. Las visitas repetidas no consumen ni amplían el enlace. Tras caducar, vuelva a llamar a la API. No se devuelve `expiredTime`; este plazo no indica la validez de las credenciales de conexión.
- **Conexión**: cada visita correcta solicita nuevas credenciales y redirige a la página de control remoto; puede afectar a una conexión anterior. Una visita fallida puede reintentarse durante la validez restante. Crear el enlace no garantiza que la conexión posterior funcione.
- **Protección**: mantenga confidencial la URL completa. La respuesta incluye `Cache-Control: no-store`. Use la URL devuelta tal cual; el servidor elige el dominio y los parámetros de conexión.

Errores de negocio documentados: `33300`, `33301`, `99002`. Consulte [Error Codes](../Getting%20Started/error-codes.md) para el significado de cada código. Cualquier operación puede devolver además los códigos comunes.

Endpoint: POST /cloudphone/link
Version: 2026-09-05
Security: Authorization

## Security:

  - `Authorization` (unknown)
    http bearer JWT

## Request fields (application/json):

  - `id` (string, required)
    ID del teléfono en la nube de MoreLogin.

  - `lang` (string)
    Idioma de la página, por ejemplo `zh-CN` o `en-US`. Si se omite o está vacío, se usa el idioma de la solicitud; los valores no admitidos usan el predeterminado configurado. El idioma se incluye en la URL; puede cambiar el parámetro de consulta `lang` para cambiar el idioma de la página.

## Response 200:

  - `200` (unknown)
    Correcto. `data.url` es el enlace temporal de acceso por navegador, válido durante 5 minutos.

## Response 200 fields (application/json):

  - `code` (integer, required)
    Example: 0

  - `msg` (string | null, required)
    Example: null

  - `data` (object, required)

  - `data.url` (string, required)
    URL temporal de acceso por navegador. Trate la URL completa como una credencial sensible.
    Example: https://gateway.example.com/app/cloudphone/qrcodeUrl?token=0123456789abcdef0123456789abcdef&lang=en-US

  - `requestId` (string)

## Response 200 headers (application/json):

  - `Cache-Control` (string)
    No almacene esta respuesta en caché.
    Enum: "no-store"