API für die virtuelle Anprobe für PHP-Anwendungen – Vollständiger Integrationsleitfaden
Integrieren Sie die API für virtuelles Anprobieren von TryOnCloud in jede beliebige PHP-Anwendung – maßgeschneiderte E-Commerce-Plattformen, Laravel-Shops, Symfony-Anwendungen oder ältere PHP-Backends. Die Integration erfolgt über einfache REST-API-Aufrufe mit API-Schlüssel-Authentifizierung. Es ist kein SDK erforderlich.
Verfahren
REST API — direct HTTP calls from PHP
Autor
Developer API key (tk_dev_v1_) in the X-API-KEY header
Sprache
PHP (vanilla, Laravel, Symfony, CodeIgniter)
Am besten geeignet für
Custom-built ecommerce platforms of any size
Warum TryOnCloud mit Custom PHP nutzen?
- 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 dem Custom PHP ein
Geschätzte Aufbauzeit: About 1 hour. Schwierigkeitsgrad: Anfänger.
- 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
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
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 (7 Sekunden).
- 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
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
$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":"..."}
}Wissenswertes
- ⓘ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
Bietet TryOnCloud ein PHP-SDK an?
Noch nicht – ein Composer-Paket ist in Planung. Derzeit ist die REST-API so übersichtlich, dass ein vollständiges SDK nicht erforderlich ist. Die obigen Code-Beispiele decken die gesamte Integration ab.
Kann ich statt cURL den HTTP-Client von Laravel verwenden?
Ja. Verwenden Sie Http::withHeaders(['X-API-Key' => config('services.tryoncloud.key')])->post('https://www.tryoncloud.com/api/tryon', [...]).
Wie verarbeite ich das Ergebnis der Anprobe in einem Laravel-Queue-Job?
Verwenden Sie die Option „webhook_url“ – übergeben Sie die URL Ihrer Laravel-Webhook-Route in der API-Anfrage. TryOnCloud sendet das Ergebnis nach Abschluss der Verarbeitung per POST an Ihren Endpunkt, sodass kein Polling erforderlich ist.
Sind Sie bereit, die virtuelle Anprobe in Ihren Custom PHP-Shop zu integrieren?
Schließen Sie sich Hunderten von Modehändlern an, die mit TryOnCloud die Rücklaufquote senken und die Konversionsrate steigern. Starten Sie kostenlos, keine Kreditkarte erforderlich.
Kostenlos loslegen