Lomavis Publishing API

Im Rahmen der Lomavis Publishing API können Zugriffe für jede Profilgruppe einzeln aktiviert werden. So ist es möglich, Beiträge automatisiert zu erstellen, entweder zunächst als Entwurf oder unmittelbar zur Veröffentlichung einzuplanen. Jede Profilgruppe bündelt dabei die zugehörigen Social-Media-Profile (z. B. Facebook, Instagram oder LinkedIn) und steuert zentral, welche Inhalte auf welchen Kanälen veröffentlicht werden.

Mit Hilfe dieser API lassen sich Workflows zur Beitragsplanung effizient automatisieren, ohne dass manuell in der Oberfläche eingegriffen werden muss.

Preise können der Preisliste entnommen werden.

API Dokumentation

Hier können Details zu den Entpunkten der API abgerufen werden: Link zur Dokumentation

API Access Token abrufen

In den Accounteinstellungen unter API-Access kann der Zugriffschlüssel für den API-Zugriff abgerufen werden und muss in Authorization-Header wie folgt gesetzt werden:

Authorization: Token <API Token>

Beitrag erstellen

Profilgruppen UUID abrufen

Um Beiträge einer bestimmten Profilgruppe zuordnen zu können, musst du zuerst die verfügbaren Profilgruppen abrufen. Dazu muss die API für die Profilgruppe in den verbunden Plattformen aktiviert werden. Nach der Aktivierung wird die UUID der Profilgruppe angezeigt.

Medien hochladen

Der Medienupload besteht aus drei Schritten, die nacheinander für jede Medien-Datei ausgeführt werden müssen. Im Anschluss kann die Datei in einem Beitrag genutzt werden.

Medienupload registieren

Im ersten Schritt muss mit den Metadaten für die hochzuladene Datei ein Upload registriert werden. Die Antwort beinhaltet die Informationen für den eigentlichen Dateiupload und die anschließende Bestätigung. Weitere Details zum Payload und der Server-Antwort befinden sich in der Dokumentation.

Datei hochladen & bestätigen

Im Rahmen der Anfrage zum Registrieren eines Uploads werden die Details zum Upload bereitgestellt.

{
  "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
  "headers": {
    "Cache-Control": "string",
    "x-goog-meta-user-uuid": "5e5f94c8-e5d0-4515-a040-21ae8813bc7f",
    "x-goog-meta-main-user-uuid": "c00ff6fc-9bd9-4a51-a329-6dfa13baa367",
    "x-goog-meta-upload-uuid": "e83e8c7b-74ed-40fa-b099-f01d859ad81f",
    "x-goog-meta-filename": "string",
    "x-goog-meta-content-type": "string",
    "x-goog-meta-filesize-in-bytes": 0,
    "x-goog-meta-media-library-upload": true,
    "x-goog-meta-preview-image-upload": true
  },
  "url": "http://url-to-upload-media-file-to.com",
  "confirm_url": "http://url-to-confirm-upload.com"
}

Mit diesen Daten kann der Upload durchgeführt werden. Dazu muss ein POST Upload als multipart/form durchgeführt werden. Dabei ist es wichtig, dass die Anfrage an die Url url mit den Headern aus headers durchgeführt wird. Die Datei muss wird dabei mit dem Schlüssel file im payload übertragen. Es dürfen keine weiteren Header gesetzt sein.

File upload via curl:

curl -X POST "http://url-to-upload-media-file-to.com" \
  -H "Cache-Control: string" \
  -H "x-goog-meta-user-uuid: 5e5f94c8-e5d0-4515-a040-21ae8813bc7f" \
  -H "x-goog-meta-main-user-uuid: c00ff6fc-9bd9-4a51-a329-6dfa13baa367" \
  -H "x-goog-meta-upload-uuid: e83e8c7b-74ed-40fa-b099-f01d859ad81f" \
  -H "x-goog-meta-filename: string" \
  -H "x-goog-meta-content-type: string" \
  -H "x-goog-meta-filesize-in-bytes: 0" \
  -H "x-goog-meta-media-library-upload: true" \
  -H "x-goog-meta-preview-image-upload: true" \
  -F "file=@/pfad/zu/deiner_datei.jpg"

Alternative kann dieser Upload auch via PUT Request umgesetzt werden. Diese Option muss gewählt werden, wenn man mit Tools wie Make.com oder N8N arbeitet:

curl -X PUT "http://url-to-upload-media-file-to.com" \
  -H "Cache-Control: string" \
  -H "x-goog-meta-user-uuid: 5e5f94c8-e5d0-4515-a040-21ae8813bc7f" \
  -H "x-goog-meta-main-user-uuid: c00ff6fc-9bd9-4a51-a329-6dfa13baa367" \
  -H "x-goog-meta-upload-uuid: e83e8c7b-74ed-40fa-b099-f01d859ad81f" \
  -H "x-goog-meta-filename: string" \
  -H "x-goog-meta-content-type: image/jpeg" \
  -H "x-goog-meta-filesize-in-bytes: 0" \
  -H "x-goog-meta-media-library-upload: true" \
  -H "x-goog-meta-preview-image-upload: true" \
  -H "Content-Type: image/jpeg" \
  --data-binary "@/pfad/zu/deiner_datei.jpg"

Im Anschluss an den Upload kann der Upload mittels einer PUT Anfrage an die confirm_url bestätigt werden.

Confirm file Upload:

curl -X PUT "http://url-to-confirm-upload.com" \
  -H "Content-Type: application/json" \
  -d '{"success": true}'

Mehr Details zum Bestätigen sind in der Dokumentation verfügbar.

Nach diesen Schritten ist die Datei erfolgreich hochgeladen und die uuid kann bei der Erstellung der Beiträge genutzt werden.

Beitrag erstellen

Mit der UUID der Profilgruppe und der UUID des Dateiuploads können Beiträge aktiv geplant oder als Entwurf gespeichert werden. Details zum Payload können hier der Dokumentation entnommen werden.