Erste Schritte

Ein durchgehendes Beispiel: Von der Authentifizierung bis zum gerenderten Artikelbild.

Szenario

Wir wollen ein Bild eines Tisches aus den Demodaten rendern.

Schritt 1: Token holen

# Public Key abrufen
curl -s "https://portal.3doffice.de/authsrv/AuthSrv.dll/datasnap/rest/AuthSrv/GetPublicKey/"

Antwort (Auszug):

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

→ Den PublicKey verwenden, um username/password zu verschlüsseln (siehe Authentifizierung).

# Token anfordern (vereinfacht dargestellt)
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,"AppKey":"..."}'

Antwort:

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

Schritt 2: Katalog durchsuchen

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

→ Liefert alle Hersteller. Navigieren Sie durch die Kategorien, bis Sie einen Artikel finden.

Schritt 3: Artikel laden

curl "https://web.3doffice.de/webkatalog2/api/ofml.dll/ofml/articles?token={TOKEN}&manufacturer=_D&program=TI&basearticlenumber=DTI&lang=de"

→ Liefert alle Merkmale, Preise und die reinitstring-Konfiguration.

Schritt 4: Bild rendern

Aus der Antwort von Schritt 3 die Werte übernehmen:

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

→ Speichert ein 500×500px Bild des konfigurierten Artikels.

Schritt 5: Bauteilliste holen (optional)

Für die 3D-Darstellung in WebGL:

curl "https://web.3doffice.de/webkatalog2/api/odb.dll/odb/btg?token={TOKEN}&manufacturer=_D&program=TI&basearticlenumber=DTI&finalarticlenumber=DTI&reinitstring=..."

→ Liefert die vollständige Bauanleitung mit Geometrie und Materialien.

Zusammenfassung

graph TD
    A[Token holen] --> B[Katalog navigieren]
    B --> C[Artikel laden]
    C --> D[Bild rendern]
    C --> E[Bauteilliste holen]
    E --> F[WebGL darstellen]

Jetzt können Sie den API Playground verwenden, um diese Schritte interaktiv auszuprobieren.