Links in der App öffnen¶
Es ist möglich Links in der IServ-App zu öffnen, falls diese auf dem Endgerät installiert ist. Die App registriert dazu die URL https://open.iserv.app/ und das Schema iserv://. Links, die diesem Format folgen, werden im folgenden App-Links genannt, alle anderen Links auf IServ werden als IServ-Links bezeichnet. Wird ein App-Link in der IServ-App geöffnet, interpretiert diese den darin enthaltenen IServ-Link und öffnet ihn mit einem in der App hinterlegten Account.
Es ist derzeit nicht möglich beliebige IServ-Links direkt in der IServ-App zu öffnen. Diese müssen daher zunächst in eines der unten beschriebenen Formate gebracht werden. Im Folgenden wird das Format dieser Links näher erläutert.
open.iserv.app¶
https://open.iserv.app/#{iserv-link}
Der # nachfolgende Teil beschreibt die Resource auf die der IServ-Link zeigt. Als Schema des IServ-Links wird implizit https:// angenommen, das Schema ist also nicht Teil von {iserv-link}. Der IServ-Link wird nicht an den Webserver von open.iserv.app übertragen. Der IServ-Link muss einen Pfad enthalten, der mit /iserv/ beginnt. Beispielsweise würde also https://open.iserv.app/#mein-iserv.de/iserv von der IServ-App als https://mein-iserv.de/iserv interpretiert werden und mit einem in der App für mein-iserv.de hinterlegten Accounts geöffnet werden.
In der Regel werden Links im Format https://open.iserv.app/# vom Betriebssytem in einem Webbrowser geöffnet. Falls z.B. die IServ-App nicht installiert ist oder vom Benutzer explizit der Web-Browser zum Öffnen solcher Links ausgewählt wurde, leitet open.iserv.app auf den enthaltenen IServ-Link weiter. Aus Kompatibiltätsgründen ist daher dieses Format zu bevorzugen.
iserv://¶
iserv://{iserv-link}
Als Schema des IServ-Links wird implizit https:// angenommen, das Schema ist also nicht Teil von {iserv-link}. Beispielsweise würde also iserv://mein-iserv.de/iserv von der IServ-App als https://mein-iserv.de/iserv interpretiert werden und mit einem in der App für mein-iserv.de hinterlegten Accounts geöffnet werden. Der IServ-Link muss einen Pfad enthalten, der mit /iserv/ beginnt.
Dieses Schema dient primär zur Kommunikation von anderen Apps auf dem selben Gerät mit der IServ-App. Für die Verlinkung von Inhalten sollte stattdessen das Format open.iserv.app bevorzugt werden.
Verhalten bei mehreren Accounts¶
Die IServ-App bestimmt anhand des Host-Teils des IServ-Links den Account mit dem der IServ-Link geöffnet werden soll. Kennt die App mehrere Accounts auf für denselben IServ, wird der Anwenderin eine Auswahl angeboten und der Link mit dem ausgewählten Account geöffnet.
Gleichbedeutende URIs¶
Als Konvention wird der leere Pfad und / als /iserv behandelt. Die folgenden URIs sind also gleichbedeutend:
https://open.iserv.app/#mein-iserv.de/iserv
https://open.iserv.app/#mein-iserv.de/
iserv://mein-iserv.de/iserv
iserv://mein-iserv.de