Zwei Minuten, und es lohnt sich vor allem anderen: fast jedes spätere Integrationsproblem entpuppt sich als eines der beiden Dinge, die das hier zeigt.
1. Einen Schlüssel erzeugen
Schlüssel erstellen im Dashboard. Sie sehen den ganzen Schlüssel einmal. Legen Sie ihn dorthin, wo Ihr Code ihn aus der Umgebung liest und nicht aus einer Datei im Repository.
2. Fragen, was Sie haben
curl "https://makehybrid.com/linkedin/connect/accounts" \ -H "X-API-KEY: $MAKEHYBRID_KEY"
Eine Antwort heißt, dass der Schlüssel gültig und der Plan aktiv ist, und die zurückgegebene Liste ist jedes LinkedIn-Konto, das Ihre Organisation verbunden hat. Zwei Dinge gezeigt und die eine Eingabe, die jeder andere Aufruf braucht — die Konto-ID — in einer einzigen Anfrage, die LinkedIn überhaupt nicht berührt.
3. Lernen Sie jetzt die Form der Fehler
{"type":"errors/payment_required","status":402,"detail":"..."}
- 401 — der Schlüssel fehlt, ist falsch oder widerrufen.
- 402 — der Plan ist nicht bezahlt, oder die Testphase ist vorbei.
- 404 — nicht da, oder nicht Ihres. Absichtlich dieselbe Antwort.
- 429 — zu viele Anfragen, oder LinkedIn drosselt das Konto.
- 503 — der Sprung vor LinkedIn hat nicht geantwortet; der Körper trägt den nackten Status, den er gesehen hat.
Schreiben Sie einen Handler gegen diese Form, und jede Route im Katalog ist abgedeckt. Das Feld detail ist so geschrieben, dass man es einem Menschen zeigen kann, also ist es meist richtig, genau das zu tun.
Häufige Fragen
Kann ich den ersten Aufruf auch aus einem Chat machen?
Ja. Verbinden Sie Ihren Assistenten und fragen Sie, welche Konten verbunden sind; er macht dieselbe Art von Aufruf und liest die Antwort zurück. Es einmal von Hand zu tun lohnt sich trotzdem, denn die Form der Fehler, die Sie hier sehen, ist auch die, die ein KI-Agent lesen wird.
Braucht ein Projektraum diesen Schlüssel?
Nicht, um einen Raum zu öffnen oder einen integrierten KI-Agenten zu fragen. Nur ein Agent von Ihnen, der auf LinkedIn handelt, braucht einen Schlüssel, und den erstellt der Raum selbst.