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