API d'essayage virtuel pour applications PHP — Guide d'intégration complet

Pourquoi utiliser TryOnCloud avec Custom PHP

• Fonctionne avec n'importe quel framework PHP ou plateforme personnalisée
• Un contrôle total sur l'interface utilisateur : créez une expérience d'essayage à l'image de votre marque
• API asynchrone — envoi d'une tâche et interrogation des résultats, sans blocage
• Prise en charge des webhooks — recevez le résultat via un rappel au lieu d'un interrogateur
• Exemples de code Laravel et Symfony inclus

Comment configurer TryOnCloud sur Custom PHP

Temps d'installation estimé : 2–3 hours. Difficulté : Intermédiaire.

1. 1

   Obtenez votre clé API

   Connectez-vous à votre tableau de bord TryOnCloud, rendez-vous dans la section « Clés API » et générez une nouvelle clé. Copiez-la : vous en aurez besoin pour chaque requête API.

2. 2

   Soumettre une demande d'essai

   Envoyez un message à l'adresse https://www.tryoncloud.com/api/tryon en indiquant l'URL de l'image du vêtement et celle de la photo du client. L'API renvoie immédiatement un identifiant de tâche.

3. 3

   Voter ou consulter les résultats

   Vous pouvez soit interroger l'API GET /api/result/{job_id} toutes les 3 secondes, soit indiquer une URL de webhook dans le corps de votre requête POST pour recevoir automatiquement le résultat une fois le traitement terminé (15 à 20 secondes).

4. 4

   Afficher l'image finale

   Vous obtenez ainsi une URL menant à l'image d'essayage générée. Affichez-la dans une fenêtre modale, une lightbox ou directement sur la page de votre produit.

5. 5

   Gérer les erreurs avec souplesse

   Vérifier l'état : erreur dans la réponse. Erreurs courantes : format d'image non pris en charge, image trop petite (<400 px) ou vêtement non détecté. Afficher un message de secours convivial.

Exemple de code

PHP : Envoyer une tâche d'essai et interroger le résultat

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

Ce qu'il faut savoir

• ⓘPas d'interface utilisateur prédéfinie : c'est vous qui créez le bouton et l'affichage des résultats
• ⓘLe serveur doit autoriser les connexions HTTPS sortantes vers api.tryoncloud.com
• ⓘPHP cURL ou Guzzle requis pour les requêtes HTTP

Questions fréquemment posées

Autres intégrations