Photobridge Schnittstellenbeschreibung - HTTPBridge - PIXACO Leutragraben 1 / INTERSHOP Tower 07743 Jena Deutschland E-Mail: photobridge@pixaco.com Datum: 05.09.2005
Einführung Die HTTPBridge stellt als Bestandteil der PIXACO Photobridge eine Schnittstelle zur Verfügung, um externen Plattformen mit Bildbeständen, die für die digitale Fotoausbelichtung geeignet sind, den Zugang zum PIXACO System zu ermöglichen. Der HTTPridge Service kann über folgende URL erreicht werden: http[s]://[pixaco Host]/services/httpbridge.aspx http://www.pixaco.de/services/httpbridge.aspx Die Kommunikation mit dem PIXACO System erfolgt ausschließlich über den Aufruf des entsprechenden HTTPBridge Service Dokumentes via HTTP GET. Die Anbindung der HTTPBridge erfordert keine besonderen Programmierkenntnisse und eignet sich gleichermaßen für einfache statische Webseiten als auch für dynamische Webanwendungen oder Portale. Einzige Voraussetzung ist die Bereitstellung der für die Fotoerstellung benötigten Originalbilddateien auf einem Webserver. Eine aktuelle Version dieser Dokumentation sowie eine Beispielseite finden Sie hier: http://images.pixaco.com/photobridge/httpbridge-de.pdf http://images.pixaco.com/photobridge/httpbridge-beispiel.html Referenz 1. Session Mapping Modes Um eine PIXACO Session und den dazugehörigen Warenkorb eindeutig zu identifizieren, bietet die HTTPBridge zwei Möglichkeiten. Die Useridentifizierung kann sowohl über Cookies als auch über eine eindeutige SessionID des externen Systems (Remote-SessionID) erfolgen. Sollte durch den Nutzer die Verwendung von Cookies untersagt worden sein, ist eine eindeutige Identifizierung ausschließlich über die Remote-SessionID möglich. smm=[cookie rsession] smm=cookie smm=rsession&rsid=5lk76j5asdl1j32 2. Bridge Commands Jede Aktion wird über ein entsprechendes Kommando mit jeweils individuellen Parametern beschrieben. cmd=[command] Folgende Kommandos werden aktuell zur Verfügung gestellt. addimage Das Kommando addimage ermöglicht die Übertragung eines oder mehrerer Bilder in den PIXACO Warenkorb. Der Parameter productid ist optional und gibt an, welches Fotoformat bzw. welcher Foto-Geschenkartikel hinzugefügt werden soll. Die Produktkennung wird auf alle übertragenen Bilder angewendet. - 2 -
Beispiel für die Übertragung eines Bildes in den PIXACO-Warenkorb Als Beispiel für den eigenen Webserver benutzen wir die Domain: http://www.mein-server.de Der Pfad zum Bilderverzeichnis, im diesem Beispiel "Bilder", auf dem eigenen Webserver: http://www.mein-server.de/bilder/ Der Pfad zu einem Bild in diesem Bilderverzeichnis lautet für die Datei Bild1.jpg : http://www.mein-server.de/bilder/bild1.jpg Das Kommando zur Übertragung in den PIXACO-Warenkorb wird mittels Klick auf einen Link ausgelöst. Der Link muss dazu folgendermaßen aufgebaut sein: <a href="http://www.pixaco.de/services/httpbridge.aspx?smm=cookie& cmd=addimage&url0=http://www.mein-server.de/bilder/bild1.jpg"> Bild in den PIXACO-Warenkorb legen</a> Lediglich der fett gedruckte Teil muss selbst eingefügt warden. Um einen optisch ansprechenderen Effekt zu erzielen, kann das ganze auch in einem extra Fenster geschehen. Auch hier kann der restliche Teil kopiert warden und nur an der fett markierten Stelle müssen Sie Änderungen vornehmen. <a href="#" onclick="javascript:window.open ('http://www.pixaco.de/services/httpbridge.aspx?smm=cookie&cmd= addimage&url0=http://www.mein-server.de/bilder/bild1.jpg, 'popup','width=310,height=250, menubar=no,status=no, scrollbars=no,resizable=yes,left=50,top=50');">bild in den PIXACO-Warenkorb legen</a> Diesem Link können weitere Commands hinzugefügt werden, um ihn mit weiteren Funktionalitäten zu versehen. Beispiele für diese Links finden Sie auf der folgenden Seite. - 3 -
Mögliche Produktkennungen (Hinweis: Das Produktspektrum der verschiedenen PIXACO Plattformen kann variieren, saisonale Änderungen vorbehalten) Foto 9x13 1 Foto-Tasse 100 Foto 10x15 2 Foto-Basecap 101 Foto 13x18 3 Foto-Puzzle 102 Foto-Poster 20x30 4 Foto-MousePad 103 Foto-Poster 30x45 5 Foto-Teddy 104 Foto-Poster 40x60 6 Foto-Bierkrug 105 Foto-Poster 50x75 7 Foto-Kissen 109 Foto 11x17 8 Foto-Grillschürze 110 Foto-Zaubertasse 115 Fotopuzzle 30x45 116 Foto-T-Shirt (S) 120 Foto-T-Shirt (M) 121 Foto-T-Shirt (L) 122 Foto-T-Shirt (XL) 123 Foto-T-Shirt (XXL) 124 Foto-Sweat-Shirt (S) 130 Foto-Sweat-Shirt (M) 131 Foto-Sweat-Shirt (L) 132 Foto-Sweat-Shirt (XL) 133 Foto-Sweat-Shirt (XXL) 134 cmd=addimage&url[0..n]=[url]&productid=[productid] cmd=addimage&url0=http://images.domain.com/image1.jpg&productid =7 Javascript-Beispiel zum Starten der Übertragung. Die Popup-Fenstergröße sollte idealerweise 310x250 Pixel betragen. <a href="#" onclick="javascript:window.open ('http://www.pixaco.de/services/httpbridge.aspx?smm=cookie& cmd=addimage&url0= http://images.pixaco.com/httpbridge/pic1.jpg&productid=3', 'popup','width=310,height=250,menubar=no,status=no, scrollbars=no,resizable=yes,left=50,top=50');"> Foto 13x18 zum PIXACO Warenkorb hinzufügen</a> redirect Das Kommando redirect erlaubt den direkten Einsprung auf eine bestimmte Seite des PIXACO Systems. cmd=redirect&to=[upload basket order] cmd=redirect&to=basket Beispiel: <a href="http://www.pixaco.de/services/httpbridge.aspx? smm=cookie&cmd=redirect&to=order" target="_blank"> PIXACO Bestellung abschließen</a> - 4 -
3. Personalisierung Die PIXACO HTTPBridge erlaubt Ihnen auf einfache Weise, eigene Personalisierungen an der bestehenden Website vorzunehmen. Die Übergabe von Logodateien oder Texten kann auf Wunsch in verschieden Sprachen erfolgen, sofern der entsprechende PIXACO-Host mehrere Sprachen unterstützt. Als Beispiele seinen an dieser Stelle PIXACO Schweiz und PIXACO Belgien genannt. Außerdem besteht die Möglichkeit, bestimmte Funktionalitäten innerhalb des PIXACO-Systems zu steuern. servicename Beschreibung Typ : alternativer Dienstname : Text servicename=mein Fotoservice -oderservicename_de=mein Fotoservice servicename_en=my Photo Service navigationlogourl Beschreibung Typ Größe : alternatives Dienstlogo für den Navigationbereich : Bild-Url ohne http:// : 170x60 Bildpunkte navigationlogourl=www.mydomain.com/mylogo_de.gif -odernavigationlogourl_de=www.mydomain.com/mylogo_de.gif navigationlogourl_en=www.mydomain.com/mylogo_en.gif welcomelogourl Beschreibung Typ Größe : alternatives Dienstlogo für die Startseite : Bild-Url ohne http:// : 370x160 Bildpunkte welcomelogourl=www.mydomain.com/mylogo_de.gif -oderwelcomelogourl_de=www.mydomain.com/mylogo_de.gif welcomelogourl_en=www.mydomain.com/mylogo_en.gif allowupload Beispiel: Beschreibung : erlaubt/verbietet das Hochladen von Bilddateien Typ : Flag allowupload=[true false] <a href="http://www.pixaco.de/services/httpbridge.aspx?smm=cookie& cmd=redirect&to=order&servicename=mein Fotoservice& navigationlogourl=www.pixaco.de/images/welcome/big_image.jpg& allowupload=false" target="_blank">pixaco Bestellung abschließen</a> - 5 -
Provisionierung Affiliateprogramme Die Einbindung der HTTPBridge in Affiliate-Programme ermöglicht die einfache und transparente Ausschüttung der Provision für vermittelte PIXACO-Bestellungen. zanox (DE,AT,CH,UK,ES,NL,FR) Melden Sie sich kostenlos unter www.zanox.de an und bewerben Sie sich bei unserem Partnerprogramm PIXACO für das entsprechende Land. Sie werden umgehend als Programmteilnehmer freigeschaltet. Innerhalb der von uns zur Verfügung gestellten Werbemittel wählen Sie bitte den Deeplink: PIXACO Photobridge und nutzen den bereitgestellten Quellcode analog der folgenden Beipiele. Javascript-Popup Beispiel: <a href="#" onclick="javascript:window.open( 'http://ad.zanox.com/ppc/?xxx& ULP=[[&smm=cookie&cmd=addimage&url0= http://images.pixaco.com/httpbridge/pic1.jpg&productid=7]]', 'popup','width=310,height=250,menubar=no,status=no, scrollbars=no,resizable=yes,left=50,top=50');"> Foto-Poster 50x75 zum PIXACO Warenkorb hinzufügen</a> Link-Beispiel: <a href="http://ad.zanox.com/ppc/?xxx& ULP=[[&smm=cookie&cmd=redirect&to=basket]]" target="_blank">zum PIXACO Warenkorb</a> adbutler (DE) Melden Sie sich kostenlos unter www.adbutler.de an und bewerben Sie sich bei unserem Partnerprogramm PIXACO. Sie werden umgehend als Programmteilnehmer freigeschaltet. Innerhalb der von uns zur Verfügung gestellten Werbemittel wählen Sie bitte den Textlink: PIXACO Photobridge und nutzen den bereitgestellten Quellcode analog der folgenden Beipiele. Javascript-Popup Beispiel: <a href="#" onclick="javascript:window.open( 'http://james.adbutler.de/click.php?pid=xxx&tid=xxx& bid=xxx&smm=cookie&cmd=addimage&url0= http://images.pixaco.com/httpbridge/pic1.jpg&productid=6', 'popup','width=310,height=250,menubar=no,status=no, scrollbars=no,resizable=yes,left=50,top=50');"> Foto-Poster 40x60 zum PIXACO Warenkorb hinzufügen</a> Link-Beipiel: <a href="http://james.adbutler.de/click.php?pid=xxx&tid=xxx& bid=xxx&smm=cookie&cmd=redirect&to=basket" target="_blank">zum PIXACO Warenkorb</a> affilinet (DE) Melden Sie sich kostenlos unter www.affilinet.de an und bewerben Sie sich bei unserem Partnerprogramm PIXACO. Sie werden umgehend als Programmteilnehmer freigeschaltet. Innerhalb der von uns zur Verfügung gestellten Werbemittel wählen Sie bitte den Deeplink: PIXACO Photobridge und nutzen den bereitgestellten Quellcode analog der folgenden Beipiele. Hinweis: Sie müssen zwingend den Parameter prd=yes den HTTPBridge Parametern voranstellen! - 6 -
Javascript-Popup Beispiel: <a href="#" onclick="javascript:window.open( 'http://partners.webmasterplan.com/click.asp?ref=xxx& site=xxx&type=text&tnb=6&prd=yes&smm=cookie&cmd=addimage& url0=http://images.pixaco.com/httpbridge/pic1.jpg&productid=5', 'popup','width=310,height=250,menubar=no,status=no, scrollbars=no,resizable=yes,left=50,top=50');"> Foto-Poster 30x45 zum PIXACO Warenkorb hinzufügen</a> Link-Beipiel: <a href="http://partners.webmasterplan.com/click.asp?ref=xxx& site=xxx&type=text&tnb=6&prd=yes&smm=cookie&cmd=redirect& to=basket" target="_blank">zum PIXACO Warenkorb</a> - 7 -
Screenshots Partnerseite mit eingebauten PIXACO HTTPBridge Links - 8 -
Bild wird übertragen Übertragung erfolgreich / Übersicht - 9 -
PIXACO Warenkorb - 10 -