API de experimentação virtual para aplicações PHP — Guia completo de integração

Por que usar TryOnCloud com Custom PHP

• Funciona com qualquer framework PHP ou plataforma personalizada
• Controlo total sobre a interface do utilizador — crie uma experiência de experimentação à medida da sua marca
• API assíncrona — enviar tarefa e consultar o resultado, sem bloqueio
• Suporte a webhooks — receba o resultado através de um callback em vez de fazer polling
• Inclui código de exemplo para Laravel e Symfony

Como configurar TryOnCloud em Custom PHP

Tempo estimado de configuração: 2–3 hours. Dificuldade: Intermédio.

1. 1

   Obtenha a sua chave API

   Inicie sessão no seu painel do TryOnCloud, aceda à secção «Chaves API» e gere uma nova chave. Copie-a — irá utilizá-la em todas as solicitações à API.

2. 2

   Enviar um trabalho de teste

   Envie um e-mail para https://www.tryoncloud.com/api/tryon com o URL da imagem da peça de roupa e o URL da foto do cliente. A API devolve imediatamente um ID de tarefa.

3. 3

   Votar ou ver o resultado

   Pode consultar GET /api/result/{job_id} a cada 3 segundos ou indicar um webhook_url no corpo da sua solicitação POST para receber o resultado automaticamente assim que o processamento estiver concluído (15–20 segundos).

4. 4

   Mostrar a imagem resultante

   O resultado é um URL que aponta para a imagem de visualização gerada. Exiba-a num modal, numa lightbox ou diretamente na página do produto.

5. 5

   Lidar com os erros de forma adequada

   Verificar o estado: ocorreu um erro na resposta do resultado. Erros comuns: formato de imagem não suportado, imagem demasiado pequena (<400 px) ou peça de roupa não detetada. Apresentar uma mensagem alternativa amigável.

Exemplo de código

PHP: Enviar tarefa de simulação e consultar o 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;
}

O que deve saber

• ⓘNão há interface de utilizador pré-definida — é o utilizador que cria o botão do front-end e a apresentação dos resultados
• ⓘO servidor deve permitir tráfego HTTPS de saída para api.tryoncloud.com
• ⓘÉ necessário o PHP cURL ou o Guzzle para as solicitações HTTP

Perguntas frequentes

Outras integrações