API de experimentação virtual para aplicações PHP — Guia completo de integração
Integre a API de experimentação virtual da TryOnCloud em qualquer aplicação PHP — plataformas de comércio eletrónico personalizadas, lojas Laravel, aplicações Symfony ou back-ends PHP legados. Utiliza chamadas simples à API REST com autenticação por chave API. Não é necessário nenhum SDK.
Método
REST API — direct HTTP calls from PHP
Autentificação
Developer API key (tk_dev_v1_) in the X-API-KEY header
Idioma
PHP (vanilla, Laravel, Symfony, CodeIgniter)
Ideal para
Custom-built ecommerce platforms of any size
Por que utilizar o TryOnCloud com o 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 o TryOnCloud no Custom PHP
Tempo estimado de montagem: About 1 hour. Dificuldade: Principiante.
- 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
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
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 (7 segundos).
- 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
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
$apiKey = getenv('TRYONCLOUD_API_KEY'); // tk_dev_v1_...
$ch = curl_init('https://www.tryoncloud.com/api/v1/generate');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['X-API-KEY: ' . $apiKey],
CURLOPT_POSTFIELDS => [
'garment_image' => new CURLFile('garment.jpg'),
'person_image' => new CURLFile('model.jpg'),
],
CURLOPT_TIMEOUT => 120,
]);
$body = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($status === 200) {
file_put_contents('result.png', $body); // the body IS the PNG
} else {
echo $body; // {"error":"...","code":"..."}
}O que é preciso 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
O TryOnCloud disponibiliza um SDK para PHP?
Ainda não — um pacote do Composer está previsto para o futuro. Por enquanto, a API REST é suficientemente simples para que não seja necessário um SDK completo. Os exemplos de código acima abrangem toda a integração.
Posso usar o cliente HTTP do Laravel em vez do cURL?
Sim. Utilize Http::withHeaders(['X-API-Key' => config('services.tryoncloud.key')])->post('https://www.tryoncloud.com/api/tryon', [...]).
Como devo lidar com o resultado da simulação numa tarefa da fila do Laravel?
Utilize a opção webhook_url — indique o URL da rota do webhook do Laravel na solicitação da API. O TryOnCloud enviará o resultado para o seu endpoint via POST assim que o processamento estiver concluído, eliminando a necessidade de fazer sondagens.
Está pronto para adicionar a funcionalidade de experimentação virtual à sua loja Custom PHP?
Junte-se a centenas de lojas de moda que estão a reduzir as devoluções e a aumentar as conversões com o TryOnCloud. Comece gratuitamente, não é necessário cartão de crédito.
Comece gratuitamente