Fotokunst-API-Aufrufe
/onlineshop/fotokunst/
Fotokunst verkaufen per Link

/api/1.0/teaser
On-the-fly-Teaser-Grafik für deine Webseite

/api/1.0/domains
Sicherheit: Lege fest, von welchen Domains der Verkauf aus möglich ist

/api/1.0/thumbnails
Sicherheit: Lege fest, auf welche Domains deine Vorschaugrafiken liegen

/api/1.0/pricing
Preiseinstellungen für eine Künstler-ID verändern

/api/1.0/vacation
Urlaub bitte hier eintragen

/api/1.0/stats
Nutzungsstatistik abfragen


Künstler-ID
« hier sollte deine Künstler-ID stehen.
Hier registrieren »


Nützliches
Linkgenerator
Zur einfachen Link-Erzeugung

Mini-PHP-Skript
Zur dynamischen Link-Erzeugung

Rückmeldungen der API
Mit Fehlercodes


Downloads
Fotokunst-Shop (PHP)
Download (ca. 1,5 MB) // Demo

Kundenbereich für Auftragsfotografen (PHP)
Download (ca. 3,8 MB) // Demo



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}

Beispiel:
https://www.luxad.de/onlineshop/fotokunstvorschau/?api=1.0&aid=demo&pi=12335&iu=https://www.luxad.de/img/bilderrahmen-kapstadt.jpg&pu=https://www.luxad.de/holzrahmen/&it=Mein Foto

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}

Beispiel:
https://www.luxad.de/api/1.0/domains/?aid=demo&d=1234567890123456789&u=https://www.luxad.de/;http://www.digitaldavid.de/

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}

Beispiel:
https://www.luxad.de/api/1.0/thumbnails/?aid=demo&d=1234567890123456789&u=http://www.digitaldavid.de/fotokunst/

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

Deine Künstler-Id (aid) [*]
Diese Künstler-Id bekommst du vom Luxad. Über diese Id ermittelt die API deine Daten - also deinen Namen, deinen Preis pro Quadratzentimeter und auch deine Sicherheits- und Urlaubseinstellungen.


Das Vorschaubild (iu) [*]
Welches Foto möchtest du verkaufen? Kopier den Link zu genau dieser Bilddatei hier rein.
Geht einfach: Auf deinem Foto klick die rechte Maustaste an und wähle dann "Grafikadresse kopieren". Diese Grafikadresse kommt hier rein.


Deine Artikelnummer (pi)
Wenn ich dir diese Nummer nenne, musst du wissen, welches Foto das ist. Denk dir ein System aus, wie du schnell deine Fotos anhand der Artikelnummer wieder finden kannst.


Die Detailansicht (pu) [*]
Dein Foto wird auf einer einzigen Seite angezeigt? Prima, gib diese URL hier an. Sie dient als Detailansicht, wenn sich jemand dein Vorschaufoto größer anschauen möchte. Du kannst hier auch die gleiche URL angeben wie für das Vorschaubild.


Titel des Fotos (it) [optional]
Hier kannst du diesem Foto einen Titel geben. Gibst du keinen Titel an wird die Artikelnummer angezeigt.


Formatvorgabe (f) [optional]
Die API ermittelt selber das optimale Rahmenformat für das Foto. Du kannst aber das Rahmenformat auch vorgeben.

Maximale Kantenlänge (ml) [optional]
Das Foto kann oder soll nicht groß gedruckt werden? Gib hier die maximale Kantenlänge in ganzen Zentimetern an: cm



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.

OK

Der Aufruf bzw. die Aktion war erfolgreich.
Ggf. wird eine Nachricht angehängt, z.B. "OK - check mail"

NOK

Der Aufruf bzw. die Aktion war NICHT erfolgreich.
Ggf. wird ein Fehlercode angehängt, z.B. "NOK - F01"

Fehlercodes

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