Article Images

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

Returns a rendered article image at the requested resolution.

Request

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

Parameters

Parameter	Required	Description
token	Required	Authentication
profile	Optional	Server profile
manufacturer	Required	Manufacturer ID
program	Required	Series ID
basearticlenumber	Required	Base article number
finalarticlenumber	Required	Final article number
reinitstring	Optional	Reinit string
metareinitstring	Optional	Meta reinit string
width	Optional	Image width in pixels (default: 250)
height	Optional	Image height in pixels (default: 250)
view	Optional	Camera angle: top, left, right, bottom, front, back
camstyle	Optional	Camera style: 0 = perspective, 1 = orthographic (default: 1)

Response

Image in JPEG format.

HTTP headers

The response headers contain the dimensions (bounding box) of the article in meters, e.g. SizeX: 1.4000 for a table 140 cm wide:

Header	Description
SizeX	Width (OFML X axis)
SizeY	Height (OFML Y axis)
SizeZ	Depth (OFML Z axis)

Error handling

Unlike all other methods, no error JSON is returned on error; instead, the corresponding HTTP status code is returned:

Code	Meaning
400	Missing or invalid parameter
401	Missing or invalid token
404	No component list found
500	Server error

Example

HTML embedding

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

curl

curl -o artikel.jpg \
  "https://web.3doffice.de/webkatalog2/api/odb.dll/odb/articlesimage.jpg?token={TOKEN}&manufacturer=_dx&program=webti&basearticlenumber=27R0614Q&finalarticlenumber=27%20R%2006%2014%20KL%20Q&width=500&height=500"