Deux minutes, et cela vaut la peine avant tout le reste : presque tout problème d'intégration ultérieur se révèle être l'une des deux choses que ceci démontre.
1. Créez une clé
Créer une clé dans le tableau de bord. Vous voyez la clé entière une fois. Mettez-la quelque part où votre code la lit depuis l'environnement et non depuis un fichier du dépôt.
2. Demandez ce que vous avez
curl "https://makehybrid.com/linkedin/connect/accounts" \ -H "X-API-KEY: $MAKEHYBRID_KEY"
Une réponse signifie que la clé est valide et que le plan est actif, et la liste renvoyée est l'ensemble des comptes LinkedIn que votre organisation a connectés. Deux choses prouvées et la seule donnée dont tout autre appel a besoin — l'identifiant de compte — en une seule requête qui ne touche pas du tout à LinkedIn.
3. Apprenez la forme des erreurs tout de suite
{"type":"errors/payment_required","status":402,"detail":"..."}
- 401 — la clé manque, est fausse ou a été révoquée.
- 402 — le plan n'est pas payé, ou l'essai est terminé.
- 404 — ce n'est pas là, ou ce n'est pas à vous. La même réponse, exprès.
- 429 — trop de requêtes, ou LinkedIn qui bride le compte.
- 503 — le saut devant LinkedIn n'a pas répondu ; le corps porte le statut brut qu'il a vu.
Écrivez un gestionnaire contre cette forme et toutes les routes du catalogue sont couvertes. Le champ detail est écrit pour être montré à une personne, donc le montrer est en général la bonne chose à faire.
Questions fréquentes
Puis-je faire le premier appel depuis un chat ?
Oui. Connectez votre assistant et demandez quels comptes sont connectés ; il fait le même genre d'appel et vous relit la réponse. Le faire une fois à la main vaut tout de même la peine, parce que la forme d'erreur que vous voyez ici est aussi celle qu'un agent IA lira.
Une salle de projet a-t-elle besoin de cette clé ?
Pas pour ouvrir une salle ni interroger un agent IA intégré. Seul un agent à vous qui agit sur LinkedIn a besoin d'une clé, et la salle crée celle-là toute seule.