Wer schon mal mit einer externen API wie der von LinkedIn gearbeitet hat, kennt vermutlich dieses eine Fehlerbild: Der Code sieht auf den ersten Blick völlig korrekt aus, eine bestimmte Aktion schlägt trotzdem fehl — und die Ursache liegt am Ende gar nicht im eigenen Code, sondern in den angeforderten API-Berechtigungen, den sogenannten Scopes.
Das Tückische an falschen oder fehlenden Scopes: Sie fallen oft nicht sofort beim ersten Verbindungsaufbau auf. Die grundlegende Authentifizierung funktioniert einwandfrei, weil dafür meist nur ein Basis-Scope nötig ist. Das Problem zeigt sich erst später, bei einer ganz bestimmten Aktion — zum Beispiel dem eigentlichen Veröffentlichen eines Posts —, die eine zusätzliche, spezifischere Berechtigung braucht, die man beim initialen Verbindungsaufbau nicht mit angefordert hat.
Das macht das Debugging in solchen Fällen besonders mühsam: Man sucht instinktiv im eigenen Code nach dem Fehler — in der Logik, die den Post zusammenbaut, im Request selbst — obwohl der eigentliche Fehler eine Ebene höher liegt, nämlich in der Konfiguration der OAuth-Verbindung. Wenn man das nicht sofort erkennt, kann man dabei ziemlich viel Zeit im falschen Bereich verbringen.
Die praktische Lehre, die sich bei uns inzwischen als fester Reflex etabliert hat: Bei jedem Fehler, der mit einer externen API zu tun hat, prüfen wir zuerst die angeforderten Scopes und Berechtigungen, bevor wir tief in die eigene Businesslogik eintauchen. In den meisten Fällen spart das am Ende erheblich Zeit.
Schreibe einen Kommentar