API di prova virtuale per applicazioni PHP — Guida completa all'integrazione

Perché usare TryOnCloud con Custom PHP

• Funziona con qualsiasi framework PHP o piattaforma personalizzata
• Pieno controllo sull'interfaccia utente: crea un'esperienza di prova su misura per il tuo marchio
• API asincrona: invio del processo e interrogazione del risultato, senza blocco
• Supporto dei webhook: ricevi il risultato tramite callback anziché tramite polling
• Sono inclusi esempi di codice per Laravel e Symfony

Come configurare TryOnCloud su Custom PHP

Tempo di configurazione stimato: 2–3 hours. Difficoltà: Intermedio.

1. 1

   Ottieni la tua chiave API

   Accedi alla tua dashboard di TryOnCloud, vai alla sezione "Chiavi API" e genera una nuova chiave. Copiala: ti servirà per ogni richiesta API.

2. 2

   Invia una richiesta di prova

   Invia un'e-mail all'indirizzo https://www.tryoncloud.com/api/tryon indicando l'URL dell'immagine del capo e l'URL della foto del cliente. L'API restituisce immediatamente un ID dell'incarico.

3. 3

   Votare o visualizzare il risultato

   È possibile inviare una richiesta GET a /api/result/{job_id} ogni 3 secondi oppure specificare un webhook_url nel corpo della richiesta POST per ricevere automaticamente il risultato al termine dell'elaborazione (15–20 secondi).

4. 4

   Visualizza l'immagine risultante

   Il risultato è un URL che rimanda all'immagine di prova generata. Visualizzala in una finestra modale, in una lightbox o direttamente nella pagina del prodotto.

5. 5

   Gestire gli errori in modo corretto

   Verifica dello stato: errore nella risposta. Errori comuni: formato immagine non supportato, immagine troppo piccola (<400 px) o capo non rilevato. Visualizza un messaggio di avviso intuitivo.

Esempio di codice

PHP: Inviare un'operazione di simulazione e attendere il risultato

<?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;
}

Cose da sapere

• ⓘNessuna interfaccia utente predefinita: sei tu a creare il pulsante dell'interfaccia utente e la visualizzazione dei risultati
• ⓘIl server deve consentire il traffico HTTPS in uscita verso api.tryoncloud.com
• ⓘPer le richieste HTTP è necessario PHP cURL o Guzzle

Domande frequenti

Altre integrazioni