Artikelbilder

/api/odb.dll/odb/articlesimage.jpg

Gibt ein gerendertes Artikelbild in der übergebenen Auflösung zurück.

Aufruf

GET /api/odb.dll/odb/articlesimage.jpg?token={TOKEN}&manufacturer={MANU}&program={PROG}&basearticlenumber={ARTNR}&finalarticlenumber={FINNR}&width={W}&height={H}&reinitstring={REINIT}

Parameter

Parameter	Pflicht	Beschreibung
token	Pflicht	Authentifizierung
profile	Optional	Server-Profil
manufacturer	Pflicht	Hersteller-ID
program	Pflicht	Serien-ID
basearticlenumber	Pflicht	Grundartikelnummer
finalarticlenumber	Pflicht	Endartikelnummer
reinitstring	Optional	Reinitstring
metareinitstring	Optional	Meta-Reinitstring
width	Optional	Bildbreite in Pixel (Default: 250)
height	Optional	Bildhöhe in Pixel (Default: 250)
view	Optional	Kamerawinkel: top, left, right, bottom, front, back
camstyle	Optional	Kamerastil: 0 = Perspektivisch, 1 = Orthogonal (Default: 1)

Antwort

Bild im JPEG-Format.

HTTP-Header

Im Response-Header werden die Abmaße (Bounding Box) des Artikels zurückgegeben:

Header	Beschreibung
SizeX	Breite (OFML X-Achse)
SizeY	Höhe (OFML Y-Achse)
SizeZ	Tiefe (OFML Z-Achse)

Fehlerbehandlung

Anders als alle anderen Methoden wird im Fehlerfall kein Fehler-JSON zurückgegeben, sondern der entsprechende HTTP-Statuscode:

Code	Bedeutung
400	Fehlender oder fehlerhafter Parameter
401	Fehlender oder fehlerhafter Token
404	Keine Bauteilliste gefunden
500	Serverfehler

Beispiel

HTML-Einbindung

<img
  src="https://web.3doffice.de/webkatalog2/api/odb.dll/odb/articlesimage.jpg?token={TOKEN}&manufacturer=_D&program=WEBTI&basearticlenumber=27R0614Q&finalarticlenumber=27%20R%2006%2014%20KL%20Q&width=300&height=300&reinitstring=..."
  width="300px"
  height="300px"
  alt="Artikelbild"
>

curl

curl -o artikel.jpg \
  "https://web.3doffice.de/webkatalog2/api/odb.dll/odb/articlesimage.jpg?token={TOKEN}&manufacturer=_D&program=TI&basearticlenumber=DTI&finalarticlenumber=DTI&width=500&height=500"