Eintrags-API: Bilder

Beim Lesen von Einträgen werden die ersten 5 Bilder des Eintrags zurückgeliefert. Außerdem können beim Neuanlegen und Editieren von Einträgen über die Eintrags-API auch Bilder importiert werden.

Bildinformationen beim Lesen von Einträgen

Das Pictures-Array enthält alle Bilder des Eintrags, jeweils in der Form:

  • Id: Id des Bildes, wird z. B. zum Ändern von Bildinformationen oder zum Löschen benötigt
  • OrderInGallery: Ganzahlwert, nach dem die Bilder aufsteigend sortiert in den Gallerie-Ansichten dargestellt werden. Diese Reihenfolge entscheidet aber auch darüber, welche Bilder z. B. bei Suchergebnissen oder in Premium-Blöcken angezeigt werden.
  • Url: URL des Bildes
  • Description: die hinterlegte Beschreibung
  • PictureCreditsUrl: URL zur Bild-Quelle
  • PictureCredits: Text der Bild-Quelle
  • DownloadUrl: die Url, von der das Bild heruntergeladen worden ist. Dieses Feld ist nur befüllt, falls das Bild über den Import oder über die API in das Branchenportal gekommen ist.

Beispiel für einen Eintrag mit einem Bild:

"Pictures": [
        {
            "Id": 42,
            "OrderInGallery": 1,
            "Url": "http://discoverize/Media/Default/Gallery/265584/265586.jpg",
            "Description": "Beschreibung des Bildes",
            "PictureCreditsUrl": null,
            "PictureCredits": "(c) xyz",
            "DownloadUrl": "https://discoverize.com/branchenexperte.jpg"
        }
    ]

Import, Ändern von Bildinformationen und Löschen von Bildern

Import, Löschen und Ändern von Bildern kann in einem Aufruf beliebig kombiniert werden.

Import von Bildern

Beim Neuanlegen oder Editieren von Einträgen über die API können auch Bilder importiert werden. Dazu muss im Pictures-Array für jedes Bild ein Objekt mit den benötigten Informationen angegeben werden.

Der Aufbau ist ähnlich wie bei den Bildinformationen beim Lesen, es fällt jedoch die URL-Property weg, da diese die URL im Discoverize Branchenportal ist und nicht von außen gesetzt werden kann.

Das Feld OrderInGallery ist optional. Normalerweise werden die Bilder beim Import in der angegebenen Reihenfolge hinter den vorhandenen Bildern eingeordnet. Wenn jedoch Bilder zwischen bereits vohandene Bilder in einem Import sortiert werden sollen, kann das hier über das Feld OrderInGallery erfolgen.

Beispiel-Json zum Import von Bildern

"Pictures": [
        {
            "DownloadUrl": "https://discoverize.com/uploads/branchenportal.jpg",
            "Description": "This picture is about...",
            "PictureCreditsUrl": "www.credits.com/credits-url-of-picture",
            "PictureCredits": "(c) credits text of picture",
            "OrderInGallery": 4
        },
        {
            ...
        }
    ]

Fehler beim Import von Bildern

Beim Bildimport können Fehler auftreten, mehr Informationen dazu gibt es auf der Seite zu API-Fehlermeldungen:

Löschen von Bildern

Alle Eigenschaften außer Id und DeletePicture werden beim Löschen von Bildern ignoriert.

Beispiel-Json zum Löschen von Bildern

"Pictures": [
        {
            "Id": 42,
            "DeletePicture": true
        },
        {
            ...
        }
    ]

Fehler beim Löschen von Bildern

Beim Löschen von Bildern können Fehler auftreten, mehr Informationen dazu gibt es auf der Seite zu API-Fehlermeldungen:

Ändern von Bildern

Es kann zum einen die Bildbeschreibung angepasst werden, zum anderen aber auch die Credits und die Reihenfolge des Bildes in der Gallerie.

Der Download-Link wird ignoriert (falls vorhanden). Ein Download erfolgt immer nur bei neuen Bildern (ohne Bild-Id). Um einen erneuten Download zu erzwingen, muss also ein neues Bild importiert werden und das vorhandene gelöscht werden.

Beispiel-Json zum Ändern von Bildern

"Pictures": [
        {
            "Id": 42,
            "Description": "Description changed",
            "PictureCreditsUrl": "www.credits.com/credits-url-of-picture",
            "PictureCredits": "(c) credits text of picture",
            "OrderInGallery": 3
        }
]

    Unverbindlichen Beratung anfragen

    Gerne besprechen wir in einem Vorgespräch in ca. 15 Minuten Ihre Portalidee und ob und wie sich diese mit discoverize umsetzen ließe. Entweder per Telefon oder gerne auch in Person bei uns im Büro.



    9-12 Uhr12-15 Uhr15-18 Uhr

      Kontakt zum discoverize Team

      Bei allen Fragen rund Branchenportale, Beratung, Strategie helfen wir gerne weiter.