Eine Konto-ID benennt genau ein verbundenes LinkedIn-Konto. Sie bekommen eine zurück, wenn eine Anmeldung abgeschlossen ist, und setzen sie danach in fast jeden Aufruf ein — in ein Pfadsegment, einen Query-Parameter, ein JSON-Feld oder ein Multipart-Feld, je nach Operation.
Sie ist undurchsichtig. Sie hat kein Präfix, sie ist keine UUID, und sie trägt keine Bedeutung, die Sie auseinandernehmen sollten. Behandeln Sie sie als Zeichenkette, die Sie speichern und zurücksenden.
Warum sie 404 antwortet und nicht 403
Jede Abonnentin und jeder Abonnent der MakeHybrid API wird an einen einzigen gemeinsamen Tenant beim externen Anbieter weitergereicht, das heißt die Konto-IDs aller Kundinnen und Kunden liegen im selben Namensraum. Nichts erreicht diesen Anbieter unter Nennung einer Konto-ID, bevor wir bestätigt haben, dass Ihre Organisation sie verbunden hat.
Ein Fehlschlag antwortet 404, niemals 403. Der Unterschied ist keine Höflichkeit. Ein 403 hieße, dass die ID existiert und nicht Ihnen gehört — jemand könnte sich also hinsetzen, IDs erzeugen und echte von erfundenen an der Antwort unterscheiden. Ein 404 für beides sagt überhaupt nichts.
Das wird an allen vier Stellen geprüft, an denen eine ID ankommen kann: im Pfad, im Query-String, in einem Feld des JSON-Körpers und in einem Multipart-Feld. Eine ID, die ungeprüft beim Anbieter ankäme, wäre ein Lesezugriff über Mandantengrenzen hinweg.
Häufige Fragen
Muss man einem KI-Agenten die Konto-ID nennen?
Er kann sie selbst finden. Ein Assistent über MCP oder ein KI-Agent im Raum mit angekreuztem MakeHybrid listet die verbundenen Konten der Organisation auf und nimmt die account_id aus der Antwort. Meist genügt es, das Konto in normalen Worten zu nennen.
Kann ein KI-Agent die Konto-ID einer anderen Organisation verwenden?
Nein. Die ID wird gegen die Organisation geprüft, zu der der Schlüssel gehört, und die ID einer anderen Organisation antwortet einem KI-Agenten mit 404, genau wie dem Code.