Es gibt eine besondere Art von Fehler, die mehr als andere frustriert: Wenn alles richtig konfiguriert aussieht, kein Fehler angezeigt wird und das Ergebnis trotzdem ausbleibt. So zeigt sich eines der häufigsten Probleme bei der Veröffentlichung in VK – der Text des Beitrags wird ohne Beanstandungen gesendet, aber Fotos oder Videos erscheinen einfach nicht, ohne eine klare Fehlermeldung. Weder „Zugriffsfehler“ noch „Limit überschritten“ – einfach Stille und ein Beitrag ohne Medien, wo eigentlich ein Bild oder Video sein sollte.
Wir sind selbst auf diese Landmine mit dem VK-Token gestoßen, als wir die Veröffentlichung mit Medien in der frühen Testphase ausprobierten, und haben eine erhebliche Zeit damit verbracht, herauszufinden, warum alles „wie in der Dokumentation“ eingerichtet ist, aber das Video nicht veröffentlicht wird. Es stellte sich heraus, dass es genau am Typ des Tokens lag – und dieser Fehler ist so verbreitet unter Anfängern, dass es sich lohnt, ihn separat und ausführlich zu betrachten.
Zwei verschiedene Tokens, die austauschbar erscheinen
Im VK API gibt es einen grundlegenden Unterschied zwischen dem Community-Token (community token) und dem Benutzer-Token des Community-Administrators (user token, das durch vollständige Autorisierung bei VKontakte erhalten wird). Für rein textbasierte Veröffentlichungen über die API ist das Community-Token normalerweise ausreichend – und genau deshalb zeigt sich das Problem nicht sofort: Die ersten Testbeiträge mit Text werden problemlos veröffentlicht, was ein falsches Gefühl vermittelt, dass alles richtig konfiguriert ist.
Das Problem tritt auf, sobald Medien – ein Foto oder Video – zur Veröffentlichung hinzugefügt werden. Der Upload von Mediendateien in VK funktioniert als mehrstufiger Prozess: Man muss einen Server zum Hochladen erhalten, die Datei selbst hochladen und dann den Upload über die API bestätigen – und an bestimmten Stellen dieser Kette verlangt VK genau das Benutzer-OAuth-Token des Community-Administrators mit den entsprechenden Rechten, nicht das Token der Community selbst. Das Community-Token ist für diesen Teil des Prozesses technisch nicht geeignet, unabhängig davon, welche Rechte ihm formal in den Einstellungen zugewiesen wurden.
Warum dies keinen klaren Fehler ausgibt
Das Unangenehmste an diesem Problem ist, wie es sich in der Praxis äußert. VK API gibt in einigen Fällen keinen eindeutigen Zugriffsfehler zurück, wenn versucht wird, ein ungeeignetes Token zum Hochladen von Medien zu verwenden – der Textteil des Beitrags kann erfolgreich veröffentlicht werden, während das Anhängen von Medien stillschweigend nicht funktioniert oder mit Einschränkungen verarbeitet wird, von denen das Integrationssystem möglicherweise nicht einmal direkt erfährt. Infolgedessen sieht der Benutzer den veröffentlichten Beitrag ohne Bild und versteht nicht, woran es liegt: Die Einstellungen scheinen korrekt zu sein, es gibt keine Fehler in den Logs, und die Funktionalität funktioniert nicht.
Dies ist genau der Fall, in dem das „Fehlen eines Fehlers“ stärker irreführt als eine klare Ablehnung: Wenn das System sofort melden würde „falscher Token-Typ zum Hochladen von Medien“, könnte das Problem in einer Minute gelöst werden. Stattdessen muss man die Ursache anhand indirekter Hinweise rekonstruieren.
Wie man das richtige Token erhält
Damit die Medienveröffentlichung in VK stabil funktioniert, wird ein Benutzer-Token benötigt, das über OAuth 2.1 mit PKCE (Proof Key for Code Exchange – eine Erweiterung des Autorisierungsprotokolls, die die Sicherheit des Token-Austauschs erhöht) im Namen einer Person erhalten wird, die Administratorrechte in der entsprechenden Community hat. Praktisch bedeutet dies: sich als echter Benutzer bei VKontakte zu authentifizieren, den erforderlichen Satz von Zugriffsrechten zu bestätigen und sicherzustellen, dass dieser Benutzer tatsächlich im Administrationskreis der Community ist, in deren Namen die Veröffentlichung erfolgt.
Für die korrekte Konfiguration auf der Anwendungsseite sind die Parameter VK_CLIENT_ID und VK_REDIRECT_URI erforderlich – die Anwendungs-ID von VK und die Adresse, auf die VK den Benutzer nach erfolgreicher Autorisierung umleitet. Ohne korrekt konfigurierten Redirect URI wird die Autorisierung nicht erfolgreich abgeschlossen, und das Token wird überhaupt nicht erhalten – dies ist ein weiterer Schritt, bei dem man sorgfältig überprüfen sollte, was in den Anwendungs-Einstellungen von VK angegeben ist und was tatsächlich auf der Integrationsseite konfiguriert ist.
Praktische Checkliste vor der Medienveröffentlichung
Wenn die Veröffentlichung von Text in VK funktioniert, aber Medien nicht erscheinen, sollte man die folgenden Punkte der Reihe nach überprüfen:
Token-Typ. Sicherstellen, dass das Benutzer-Token des Community-Administrators verwendet wird und nicht das Token der Community selbst – das ist meist die Ursache des Problems.
Autorisierungsrechte. Überprüfen, dass bei der Autorisierung der erforderliche Satz von Rechten angefordert und bestätigt wurde, der zum Hochladen von Fotos und Videos erforderlich ist, und nicht nur für die Veröffentlichung von Textbeiträgen.
Administrativer Status. Sicherstellen, dass der Benutzer, dessen Token verwendet wird, tatsächlich zum Zeitpunkt der Veröffentlichung Administrator der entsprechenden Community ist und diesen Status nicht nach einer Änderung der Administratoren verloren hat.
Aktualität des Tokens. Überprüfen, dass das Token nicht abgelaufen ist – Benutzer-Tokens von VK haben eine eigene Lebensdauer, die sich von der des Community-Tokens unterscheidet, und müssen regelmäßig über denselben OAuth-Mechanismus aktualisiert werden.
Warum es sich lohnt, dies einmal einzurichten und zu vergessen
Die gesamte Komplexität dieser Konfiguration konzentriert sich auf eine einmalige Aktion – die richtige Autorisierung mit den erforderlichen Rechten für den benötigten Benutzer-Administrator durchzuführen. Danach funktioniert die Veröffentlichung von Fotos und Videos in VK ebenso transparent wie die Veröffentlichung von Texten, ohne dass für jeden Beitrag eine erneute Autorisierung erforderlich ist. Deshalb lohnt es sich, im Voraus Zeit für diesen Schritt zu investieren, anstatt sich mit stillen Fehlern bei der Medienveröffentlichung auseinanderzusetzen, nachdem der VK-Kanal zu einer aktiven Traffic-Quelle geworden ist und die Kosten für einen Fehler in einem bestimmten Beitrag gestiegen sind.