API für die virtuelle Anprobe für PHP-Anwendungen – Vollständiger Integrationsleitfaden

Warum TryOnCloud mit Custom PHP verwenden

• Funktioniert mit jedem PHP-Framework oder jeder benutzerdefinierten Plattform
• Volle Kontrolle über die Benutzeroberfläche – gestalten Sie das Anprobeerlebnis ganz im Stil Ihrer Marke
• Asynchrone API – Auftrag übermitteln und Ergebnis abfragen, keine Blockierung
• Webhook-Unterstützung – Empfang der Ergebnisse über einen Callback statt durch Abfrage
• Beispielcode für Laravel und Symfony enthalten

So richten Sie TryOnCloud auf Custom PHP ein

Geschätzte Einrichtungszeit: 2–3 hours. Schwierigkeit: Mittel.

1. 1

   Holen Sie sich Ihren API-Schlüssel

   Melden Sie sich bei Ihrem TryOnCloud-Dashboard an, gehen Sie zu „API-Schlüssel“ und generieren Sie einen neuen Schlüssel. Kopieren Sie ihn – Sie werden ihn bei jeder API-Anfrage benötigen.

2. 2

   Einen Anprobeauftrag einreichen

   Senden Sie eine Anfrage an https://www.tryoncloud.com/api/tryon mit der URL des Kleidungsstückbildes und der URL des Kundenfotos. Die API gibt sofort eine Auftrags-ID zurück.

3. 3

   Umfrage durchführen oder das Ergebnis abrufen

   Rufen Sie entweder alle 3 Sekunden die URL `GET /api/result/{job_id}` ab oder geben Sie im POST-Body eine `webhook_url` an, um das Ergebnis nach Abschluss der Verarbeitung automatisch zu erhalten (15–20 Sekunden).

4. 4

   Das Ergebnisbild anzeigen

   Das Ergebnis ist eine URL, die auf das generierte Anprobe-Bild verweist. Zeigen Sie es in einem Modal, einer Lightbox oder direkt auf Ihrer Produktseite an.

5. 5

   Fehler elegant behandeln

   Status prüfen: Fehler in der Antwort. Häufige Fehler: nicht unterstütztes Bildformat, Bild zu klein (<400px) oder Kleidungsstück nicht erkannt. Eine benutzerfreundliche Fallback-Meldung anzeigen.

Code-Beispiel

PHP: Try-on-Auftrag übermitteln und Ergebnis abfragen

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

Wissenswert

• ⓘKeine vorgefertigte Benutzeroberfläche – Sie erstellen die Schaltfläche und die Ergebnisanzeige selbst
• ⓘDer Server muss ausgehende HTTPS-Verbindungen zu api.tryoncloud.com zulassen
• ⓘFür HTTP-Anfragen ist PHP cURL oder Guzzle erforderlich

Häufig gestellte Fragen

Weitere Integrationen