Ordner können wie folgt per WebHook mit externen Repositorien synchronisiert werden, sofern diese als zip-Dateien verfügbar sind:

1. Den Ordner bearbeiten und in der Konfiguration die zip-Datei als Quelle (origin) angeben sowie eine Liste mit Unterordnern (unzip), die aus der Datei extrahiert werden sollen. Beispiel:
 

{
 "origin": "https://gitlab.rlp.net/adwmainz/digicademy/di/epigraf/epipresets/-/archive/devel/epipresets-devel.zip",
 "unzip": "epipresets-devel"
}

Beim Bearbeiten wird oben in der URL die Ordner-ID angezeigt - diese für den nächsten Schritt notieren. 

Hinweis: Es wird im Ordner ein Pull-Button angezeigt. Dieser kann nur mit einer expliziten Berechtigung genutzt werden - siehe den nächsten Schritt.

2. Einen Bot-Nutzer anlegen und diesem Bot-Nutzer folgende Berechtigung geben:

EinstellungWert
UserNutzername
Rolleleer lassen
Requested byAPI-Zugriff
Permission TypeAccess
Endpoint nameapp/files/pull
Entity TypeRecord
Entity Name*
Entity IDID des Ordners, zum Beispiel 76601

3. Im Repositiorium einen Webhook einrichten, der einen POST-Request auf folgenden Endpunkt auslöst:
 

https://epigraf.inschriften.net/files/pull/{FOLDERID}.json?token={ACCESSTOKEN}

Das ACCESSTOKEN kann im Nutzerprofil des Bots erzeugt werden. FOLDERID entspricht der Ordner-ID.