Photobridge

Photobridge
Schnittstellenbeschreibung
- HTTPBridge -
PIXACO
Leutragraben 1 / INTERSHOP Tower
07743 Jena
Deutschland
E-Mail:
Datum:
[email protected]
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
Foto 10x15
Foto 13x18
Foto-Poster
Foto-Poster
Foto-Poster
Foto-Poster
Foto 11x17
20x30
30x45
40x60
50x75
1
2
3
4
5
6
7
8
Foto-Tasse
Foto-Basecap
Foto-Puzzle
Foto-MousePad
Foto-Teddy
Foto-Bierkrug
Foto-Kissen
Foto-Grillschürze
Foto-Zaubertasse
Fotopuzzle 30x45
Foto-T-Shirt (S)
Foto-T-Shirt (M)
Foto-T-Shirt (L)
Foto-T-Shirt (XL)
Foto-T-Shirt (XXL)
Foto-Sweat-Shirt (S)
Foto-Sweat-Shirt (M)
Foto-Sweat-Shirt (L)
Foto-Sweat-Shirt (XL)
Foto-Sweat-Shirt (XXL)
100
101
102
103
104
105
109
110
115
116
120
121
122
123
124
130
131
132
133
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
Beschreibung
Typ
: erlaubt/verbietet das Hochladen von Bilddateien
: Flag
allowupload=[true|false]
Beispiel:
<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 -