API de prueba virtual para aplicaciones PHP: guía completa de integración

Por qué usar TryOnCloud con Custom PHP

• Funciona con cualquier marco de trabajo de PHP o plataforma personalizada
• Control total sobre la interfaz de usuario: crea una experiencia de prueba que se adapte a tu marca
• API asíncrona: envía el trabajo y consulta el resultado, sin bloqueos
• Compatibilidad con webhooks: recibe el resultado mediante una llamada de retorno en lugar de mediante sondeo
• Se incluye código de ejemplo para Laravel y Symfony

Cómo configurar TryOnCloud en Custom PHP

Tiempo estimado de configuración: 2–3 hours. Dificultad: Intermedio.

1. 1

   Consigue tu clave API

   Inicia sesión en tu panel de control de TryOnCloud, ve a «Claves API» y genera una nueva clave. Cópiala: la necesitarás en todas las solicitudes de API.

2. 2

   Enviar una solicitud de prueba

   Envía un correo electrónico a https://www.tryoncloud.com/api/tryon con la URL de la imagen de la prenda y la URL de la foto del cliente. La API te proporcionará un ID de trabajo de inmediato.

3. 3

   Votar o ver el resultado

   Realiza una consulta GET a /api/result/{job_id} cada 3 segundos, o bien incluye una URL de webhook en el cuerpo de tu solicitud POST para recibir el resultado automáticamente una vez finalizado el procesamiento (entre 15 y 20 segundos).

4. 4

   Mostrar la imagen resultante

   El resultado es una URL que apunta a la imagen de prueba generada. Muéstrala en una ventana modal, en una galería de imágenes o directamente en la página del producto.

5. 5

   Gestionar los errores con elegancia

   Comprueba el estado: error en la respuesta del resultado. Errores habituales: formato de imagen no compatible, imagen demasiado pequeña (<400 píxeles) o prenda no detectada. Muestra un mensaje de error amable.

Ejemplo de código

PHP: Enviar una tarea de prueba y consultar el resultado

<?php
function submitTryOn(string $garmentUrl, string $personUrl): ?string {
    $apiKey = getenv('TRYONCLOUD_API_KEY');

    // Step 1: Submit job
    $ch = curl_init('https://www.tryoncloud.com/api/tryon');
    curl_setopt_array($ch, [
        CURLOPT_POST => true,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HTTPHEADER => [
            'Content-Type: application/json',
            'X-API-Key: ' . $apiKey,
        ],
        CURLOPT_POSTFIELDS => json_encode([
            'garment_image_url' => $garmentUrl,
            'person_image_url'  => $personUrl,
        ]),
    ]);
    $response = json_decode(curl_exec($ch), true);
    curl_close($ch);

    $jobId = $response['job_id'] ?? null;
    if (!$jobId) return null;

    // Step 2: Poll for result (max 30s)
    for ($i = 0; $i < 10; $i++) {
        sleep(3);
        $ch = curl_init("https://www.tryoncloud.com/api/result/{$jobId}");
        curl_setopt_array($ch, [
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_HTTPHEADER => ['X-API-Key: ' . $apiKey],
        ]);
        $result = json_decode(curl_exec($ch), true);
        curl_close($ch);

        if (($result['status'] ?? '') === 'complete') {
            return $result['result_url'];
        }
    }
    return null;
}

Cosas que debes saber

• ⓘNo hay una interfaz de usuario predefinida: tú mismo creas el botón de la interfaz y la visualización del resultado
• ⓘEl servidor debe permitir el tráfico HTTPS saliente hacia api.tryoncloud.com
• ⓘSe requiere PHP cURL o Guzzle para las solicitudes HTTP

Preguntas frecuentes

Otras integraciones