Quick start

One end-to-end example: from authentication to the rendered article image.

Step 1: Get a token

# Fetch the public key
curl -s "https://portal.3doffice.de/authsrv/AuthSrv.dll/datasnap/rest/AuthSrv/GetPublicKey/"

Response (excerpt):

{
  "result": ["-----BEGIN PUBLIC KEY-----\n...\n-----END PUBLIC KEY-----"]
}

→ Use the PublicKey to encrypt username/password (see Authentication).

# Request a token (simplified)
curl -X POST \
  "https://portal.3doffice.de/authsrv/AuthSrv.dll/datasnap/rest/AuthSrv/%22GetSessionToken%22/" \
  -H "Content-Type: application/json" \
  -d '{"User":"...","Password":"...","PublicKey":"...","RememberMe":false}'

Response:

{
  "result": ["{00000000-0000-0000-0000-000000000000}"]
}

Step 2: Browse the catalog

curl "https://web.3doffice.de/webkatalog2/api/xcf.dll/xcf/getnodes?token={TOKEN}&lang=de"

→ Returns all manufacturers the token is enabled for. Navigate through the categories until you find an article.

Step 3: Load the article

curl "https://web.3doffice.de/webkatalog2/api/ofml.dll/ofml/articles?token={TOKEN}&manufacturer=_dx&program=webti&basearticlenumber=27R0614Q&lang=de"

→ Returns all properties, prices and the reinitstring configuration.

Step 4: Render the image

Take ocd.finalarticlenumber and ocd.reinitstring from the response of step 3 (URL-encoded) and pass them as finalarticlenumber and reinitstring:

curl -o artikelbild.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&reinitstring=..."

→ Saves a 500×500 px image of the configured article.

Step 5: Get the component list (optional)

For the 3D view in WebGL:

curl "https://web.3doffice.de/webkatalog2/api/odb.dll/odb/btg?token={TOKEN}&manufacturer=_dx&program=webti&basearticlenumber=27R0614Q&finalarticlenumber=27%20R%2006%2014%20KL%20Q&reinitstring=..."

→ Returns the component list with geometry and materials for the 3D view.