Integrationsanleitung

Diese Anleitung soll die Integration in Programme erleichtern.

Die Abfrage ist ein zweiteiliger Prozess.

Im ersten Schritt wird die Katalogliste abgefragt, im zweiten Schritt der jeweilige Kataloginhalt angefordert.

Allgemeines

 

Entschließen Sie sich eine Integration durchzuführen, dann würden wir uns über eine Information darüber sehr freuen.

Katalogliste anfordern

 

  1. Stellen Sie eine Anfrage wie http://www.bphdb.com/catalog/list.xml
  2. Sie erhalten eine Liste aller Katalogeinträge als XML Datei zurück.
  3. Um die Liste auf Kataloge eines speziellen Landes einzuschränken, verwenden Sie den Parameter defCountry. Ein Beispiel zur Abfrage für Österreich ist http://www.bphdb.com/catalog/list.xml?max=10000&defCountry=AT
  4. Die Katalogliste enthält je Katalog eine GUID, mit der sich weitere Anfragen zu einem speziellen Katalog stellen lassen.

Die Katalogliste enthält Angaben zum Namen und das Datum der Erstellung und der letzen Änderung. Damit lässt sich an dieser Stelle entscheiden ob der Kataloginhalt aktualisiert werden muss.

Kataloginhalt anfordern

 

  1. Ermitteln Sie die benötigte GUID des Katalogs.
  2. Stellen Sie ein Anfrage wie http://www.bphdb.com/catalog/asXML/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx. Ersetzen Sie alle xxxx... durch die entsprechende GUID des Katalogs.
  3. Sie erhalten einen Katalog mit allen Katalogeinträgen als XML file.

Um Updates vorhandener Daten durchführen zu können, sind alle Katalogeinträge mit einer GUID ausgestattet.