Sie möchten Buchhandlung-finden.de auf Ihrer Website einbinden? Über 4.000 stationäre Buchhandlungen sind auf der Karte vertreten und zeigen so auf einen Blick die Vielfalt der deutschen Buchhandelslandschaft. Damit bieten Sie Ihren Kunden und Lesern einen zusätzlichen Service und unterstützen sie bei der Suche nach der nächstgelegenen Buchhandlung.
Neben einer einfachen Verlinkung zu Buchhandlung-finden.de bieten wir Ihnen verschiedene Möglichkeiten die Buchhandlungsdaten auf Ihrer Homepage zu integrieren. Kurze Anleitungen und Erklärungen zu den unterschiedlichen Einbindungen finden Sie hier. Fordern Sie einfach Ihren API-Schlüssel, falls Sie Buchhandlung-finden.de via JSON-API einbinden möchten, an oder lassen Sie sich von uns persönlich beraten.
Die Einbindung per iFrame ist die einfachste Methode Buchhandlung-finden.de in Ihrer
Webseite zu integrieren.
Folgender HTML-Code zeigt zum Beispiel alle Buchhandlungen in Frankfurt am Main an.
<iframe src="https://www.buchhandlung-finden.de/suche?q=Frankfurt%20am%20Main" width="500" height="300"></iframe>
Name | Pflichtangabe | Standardwert | Bemerkung |
---|---|---|---|
q
|
Nein | Deutschland |
Der Paramater Beispiele:
|
Wenn Sie die volle Kontrolle über die optische Darstellung der Einbindung haben möchten,
empfehlen wir Ihnen die Einbindung per JSON-API. Sie haben zudem die Möglichkeit spezifischer
nach Buchhandlungen zu filtern, zum Beispiel nach Region oder nach Name.
Folgender JavaScript-Code ruft, mithilfe von jQuery, einen Teil der Buchhandlungen, welche mit Ihrem
API Schlüssel abrufbar sind, ab.
"use strict";
$(document).ready(function () {
var apiKey = 'YOUR_API_KEY';
$.get({
url: 'https://www.buchhandlung-finden.de/api/bookstores.json?apiKey=' + apiKey,
success: function(response) {
// In der Eigenschaft response.bookstores befindet sich eine Liste von Buchhandlungen.
//
// Eine Buchhandlung hält folgende Eigenschaften:
// vewaAddressNumber, verkehrsnummer, name, phoneNumber, emailAddress, street, zipcode, city,
// homepage, webshop, facebookPage, instagramPage, youTubePage
console.log(response.bookstores);
// In der Eigenschaft response.links, befinden sich Links, mit welchen Sie über das ganze Set iterieren können,
// da immer nur eine Teilmenge an Buchhandlungen zurückgegeben wird.
//
// Die Eigenschaft zur jeweiligen Seite ist nur vorhanden, sofern die jeweilige Seite auch existiert.
//
// Falls Sie zur nächsten Seite blättern möchten, rufen Sie den Link in response.links.nextPage ab.
// Falls Sie zur vorherigen Seite blättern möchten, rufen Sie den Link in response.links.previousPage ab.
console.log(response.links);
}
});
});
Name | Pflichtangabe | Standardwert | Bemerkung |
---|---|---|---|
apiKey
|
Ja | Kein Standardwert |
Der API-Schlüssel, welchen Sie von uns erhalten haben.
Sie haben noch keinen API-Schlüssel? |
address
|
Nein | Kein Standardwert |
Der Parameter Wenn Sie diesen Parameter angeben, werden die Buchhandlungen im Umkreis von 20 Kilometern angezeigt. Die Buchhandlungen werden zudem automatisch sortiert. Der Adresse am nähesten gelegene Buchhandlungen, werden zuerst angezeigt. Beispiele:
|
zipcode
|
Nein | Kein Standardwert |
Der Parameter Somit haben Sie die Möglichkeit alle Buchhandlungen in einem Postleitzahlengebiet, oder einer direkten Postleitzahl zu suchen. Beispiele:
|
name
|
Nein | Kein Standardwert |
Der Parameter Somit haben Sie die Möglichkeit alle Buchhandlungen, welche dieses bestimmte Teilstück des Namens beinhalten, zu finden. |