Fotokunst-API
Mit der Fotokunst-API kannst du deine Fotos in Kombination mit Bilderrahmen aus dem Luxad verkaufen. Ein Link je Foto genügt. Registriere dich hier, um gleich starten zu können.
Voraussetzung für die Fotokunst-API ist eine schnelle Registrierung oder ein eingereichtes Anmeldeformular (.pdf)
Mit der Registrierung oder dem Formular bekommst du deine Künstler-ID/API-ID (aid
)
Fotokunst verkaufen
Auf deiner Webseite präsentierst du deine Fotokunst und entscheidest, welche Werke du in Bilderrahmen von Luxad verkaufen möchtest.
Zu jedem Foto, welches du verkaufen möchtest, setzt du einfach einen Link zu folgender URL
www.luxad.de/onlineshop/fotokunstvorschau/
und übergibst der Schnittstelle einfach folgende Parameter:
- api API-Version (erforderlich)
- aid Deine Künstler-Id (erforderlich)
- pi Die eindeutige Photo-ID/Artikelnummer (erforderlich)
- iu Die Vorschaubild-URL (erforderlich)
- pu Die URL der Webseite mit dem Foto (erforderlich)
- it Bildtitel, sofern "pi" zu kryptisch
- f Das Fotoformat erzwingen (rectangle, panorama, square)
- ml Maximale Kantenlänge in cm
Klartext:
https://www.luxad.de/onlineshop/fotokunstvorschau/?api={API-Version}&aid={Deine Künstler-ID}&pi={Artikelnummer}&iu={URL zum Vorschaubild}&pu={Rücksprung-URL zu deiner Foto-Detailansicht}&it={Titel des Fotos}
Tools: Linkgenerator
Automatische Foto+Rahmen-Vorschau
Mit diesem API-Aufruf kannst du von der API einen Rahmen um ein Foto legen lassen. Diese Foto+Rahmen-Kombination kannst du einfach als <img src...>
setzen und so in einer Detailansicht als Teaser laufen lassen.
WICHTIG: Nur in einer Detailansicht verwenden. Nur 1 API-Aufruf pro Seite gleichzeitig!
Die Ausgabe ist immer 550 Pixel breit und beliebig hoch. Bitte mit CSS oder hart in HTML skalieren.
www.luxad.de/api/1.0/teaser/
und übergibst der Schnittstelle einfach folgende Parameter:
- aid Deine Künstler-Id (erforderlich)
- iu Die Vorschaubild-URL (erforderlich)
- f Das Fotoformat (rectangle, panorama, square)
Klartext:
<img src="https://www.luxad.de/api/{API-Version}/teaser/?aid={Deine Künstler-ID}&iu={Die URL vom Vorschaubild}">
Beispiel:
<img src="https://www.luxad.de/api/1.0/teaser/?aid=demo&iu=https://www.luxad.de/img/bilderrahmen-kapstadt.jpg">
Zulässige Domains
Zur Sicherheit: Trage hier die Webseiten ein, auf denen du deine Fotos zeigst und verkaufen möchtest. Das kann deine Homepage, Facebook, Pinterest, dein Blog, Flickr oder auch die Fotocommunity sein. Das verhindert u.a., dass der Link einfach verschickt werden kann. So stellst du sicher, dass der Verkauf nur von autorisierten Stellen aus begonnen werden kann.
Manueller Aufruf / 1. Schritt: /domains/?aid=demo
Du bekommst eine E-Mail mit dem Sicherheitscode und Links zum Bearbeiten.
Automatisierter Aufruf
https://www.luxad.de/api/1.0/domains/?aid=demo + Parameter
Parameter:
- d Sicherheitscode (erforderlich)
- u Zugelassene URLs. (URL1;URL2;URLn) (erforderlich)
Klartext:
https://www.luxad.de/api/{API-Version}/domains/?aid={Deine Künstler-ID}&d={Der Sicherheitscode aus der E-Mail}&u={URL1;URL2}
URLs der Vorschaugrafiken
Zur Sicherheit: Trage hier die URLs ein, unter denen du deine Vorschaugrafiken gespeichert hast. Damit kannst du z.B. verhindern, dass jemand deine Künstler-ID verwendet.
Manueller Aufruf / 1. Schritt: /thumbnails/?aid=demo
Du bekommst eine E-Mail mit dem Sicherheitscode und Links zum Bearbeiten.
Automatisierter Aufruf
https://www.luxad.de/api/1.0/thumbnails/?aid=demo + Parameter
Parameter:
- d Sicherheitscode (erforderlich)
- u Zugelassene URLs. (URL1;URL2;URLn) (erforderlich)
Klartext:
https://www.luxad.de/api/{API-Version}/thumbnails/?aid={Deine Künstler-ID}&d={Der Sicherheitscode aus der E-Mail}&u={URL1;URL2}
Preiseinstellungen
Du kannst deine Verkaufspreise anpassen und so z.B. auf Events wie Weihnachten reagieren.
Manueller Aufruf / 1. Schritt: /pricing/?aid=demo
Du bekommst eine E-Mail mit dem Sicherheitscode und einer Anleitung zum Ändern der Preise.
ACHTUNG: Aus Sicherheitsgründen wird ein spezieller Sicherheitscode generiert nach einer Änderung gelöscht.
Automatisierter Aufruf
https://www.luxad.de/api/1.0/pricing/?aid=demo + Parameter
Parameter:
- s Sicherheitscode (erforderlich)
- f Quadratzentimenterpreis in Eurocent * 10 (0,045 Euro = 45) (erforderlich)
- p Grundpreis in vollen Euro (erforderlich)
Klartext:
https://www.luxad.de/api/{API-Version}/pricing/?aid={Deine Künstler-ID}&s={Der Sicherheitscode aus der E-Mail}&f={Quadratzentimeterpreis in Eurocent * 10}&p={Fotogrundpreis in vollen Euro}
Beispiel:
https://www.luxad.de/api/1.0/pricing/?aid=demo&s=1234567890123456789&f=25&p=10
Urlaub/Abwesenheit
Falls du mal keinen Zugriff auf deine E-Mails oder deine Fotos hast, dann kannst du einen "Urlaub" eintragen. Kunden sehen dann, dass die Bestellung erst nach deinem Urlaub bearbeitet werden kann.
Manueller Aufruf / 1. Schritt: /vacation/?aid=demo
Du bekommst eine E-Mail mit dem Sicherheitscode und Links zum Einstellen der Urlaubsdauer.
Automatisierter Aufruf
https://www.luxad.de/api/1.0/vacation/?aid=demo + Parameter
Parameter:
- s Sicherheitscode (erforderlich)
- do Urlaubszeit in Tagen, z.B. 10 (erforderlich)
Klartext:
https://www.luxad.de/api/{API-Version}/vacation/?aid={Deine Künstler-ID}&s={Der Sicherheitscode aus der E-Mail}&do={Urlaubsdauer in Tagen ab heute}
Beispiel:
https://www.luxad.de/api/1.0/vacation/?aid=demo&s=1234567890123456789&do=10
Statistik
Ja, die API kann auch Zahlen liefern und zeigt dir deine erfolgreichsten Fotos.
Manueller Aufruf: /stats/?aid=demo
Klartext:
https://www.luxad.de/api/{API-Version}/stats/?aid={Deine Künstler-ID}
Beispiel:
https://www.luxad.de/api/1.0/stats/?aid=demo
Linkgenerator
Mit diesem Formular kannst du deine Daten eintragen und einen Link erzeugen lassen.
Formular
PHP-Script für dynamische Webseiten
Dieses Stück PHP-Code kannst du einfach kopieren, packst es unter deine Bildausgabe und füllst die Platzhalter mit deinen PHP-Variablen oder passenden Werten aus der Datenbank.
// Nach jedem Bild
$luxad_api = "1.0"; // API Version
$luxad["aid"] = "demo"; // Deine Künstler-ID
$luxad["pi"] = urlencode("Artikelnummer oder Dateiname");
$luxad["it"] = urlencode("Bildtitel");
$luxad["iu"] = urlencode("Link zur Vorschaugrafik (http://...)");
$luxad["pu"] = urlencode("Link zur Detailansicht mit dem Bild (http://...)");
// Optionale Parameter, die gefüllt werden können
# $luxad["ac"] = urlencode("Dein Kommentar zum Bild");
# $luxad["f"] = "Format" // r = Rechteck, s = Quadrat 1:1, p = Panorama 1:2
# $luxad["ml"] = "max. Seitenlänge" // Zahl in cm
// Link generieren
$luxad_link = "https://www.luxad.de/onlineshop/fotokunst/?api=$luxad_api";
while (list($key,$val) = each($luxad)) {
$luxad_link .= "&".$key."=".utf8_encode($val);
}
echo "<a href=\"$luxad_link\">Mit Bilderrahmen aus recyceltem Holz bestellen</a>";
Rückmeldungen der API
Wenn du (oder deine Anwendung) die API verwendest, dann antwortet die API grundsätzlich mit Meldungen.
OKDer Aufruf bzw. die Aktion war erfolgreich.
Ggf. wird eine Nachricht angehängt, z.B. "OK - check mail"
Der Aufruf bzw. die Aktion war NICHT erfolgreich.
Ggf. wird ein Fehlercode angehängt, z.B. "NOK - F01"
F01 - die Künstler-Id ist nicht korrekt oder inaktiv
F02 - der Aufruf erfolgt von einer nicht gelisteten Webseite
F03 - die Vorschaugrafik liegt auf einer nicht gelisteten URL