...
| Info |
|---|
Auf dieser Seite sind Endpunkte der REST-API dokumentiert, die in der aktuellen Version der PICTURE-Prozessplattform aus Gründen der Abwärtskompatibilität noch enthalten sind, die aber in künftigen Releases wegfallen werden. Für neue Entwicklungsvorhaben sollten diese Endpunkte nicht mehr verwendet werden. Bestehende Client-Anwendungen sollten rechtzeitig angepasst werde, so dass beim Update auf eine PPP-Version, in der diese Endpunkte nicht mehr enthalten sind, keine Beeinträchtigungen der Funktionalität auftreten. Für jeden wegfallenden Endpunkt werden auf dieser Seite die künftig empfohlenen Alternativen genannt. |
| Inhalt | ||
|---|---|---|
|
Zugriff auf Portal-Freigaben mittels "Share Token"
| Info | ||
|---|---|---|
| ||
Eine Freigabe in der Prozessplattform umfasst eine Liste von Prozessen / Prozesslandkarten. Die Authentifizierung des Zugriffs erfolgt über das Share Token der Freigabe, welches den Query-Parametern (&shareToken=...) des zugehörigen Freigabelinks entnommen werden kann. Der Zugriff auf die Freigabe kann in der Prozessplattform per Whitelisting auf bestimmte IP-Adressbereiche begrenzt werden. |
Abrufen des Kurzsteckbriefs zu einem Element
GET https://www{hostid}.prozessplattform.de/{tenant}/rest/share/{shareToken}/quickInfo/{targetType}/{elementUUID}
...
Deprecated seit v3.1.24. Erste Version ohne diesen Endpunkt: v3.2.0. Die Umstellung vorhandener Clients, welche diesen Endpunkt nutzen, sollte bis zum 31.12.2018 abgeschlossen sein.
Nachfolger-Endpunkt: /wiki/spaces/pppdoc300/pages/666009692
Spezielle Fehlercodes
| HTTP-Response-Code | mögliche Fehlerursache |
|---|---|
| 400 | ungültiges Token |
| 403 | Der angefragte Inhalt ist nicht Teil der Freigabe |
| 404 | Zur angefragten ID liegt kein Inhalt (mehr) vor |
...