Due minuti, e conviene farlo prima di qualunque altra cosa: quasi ogni problema di integrazione successivo si rivela una delle due cose che questo dimostra.
1. Create una chiave
Crea chiave nel pannello. Vedete la chiave intera una volta. Mettetela in un posto da cui il vostro codice la legga dall'ambiente e non da un file nel repository.
2. Chiedete che cosa avete
curl "https://makehybrid.com/linkedin/connect/accounts" \ -H "X-API-KEY: $MAKEHYBRID_KEY"
Una risposta significa che la chiave è valida e il piano è attivo, e l'elenco che torna è ogni account LinkedIn che la vostra organizzazione ha connesso. Due cose dimostrate e l'unico dato in ingresso di cui ogni altra chiamata ha bisogno — l'id dell'account — in una sola richiesta che non tocca LinkedIn per niente.
3. Imparate subito la forma degli errori
{"type":"errors/payment_required","status":402,"detail":"..."}
- 401 — la chiave manca, è sbagliata o è stata revocata.
- 402 — il piano non è pagato, oppure la prova è finita.
- 404 — non c'è, oppure non è vostro. La stessa risposta, apposta.
- 429 — troppe richieste, oppure LinkedIn che limita l'account.
- 503 — il salto davanti a LinkedIn non ha risposto; il corpo porta lo stato nudo che ha visto.
Scrivete un gestore su quella forma e ogni rotta del catalogo è coperta. Il campo detail è scritto per essere mostrato a una persona, quindi mostrarlo di solito è la cosa giusta.
Domande frequenti
Posso fare la prima chiamata da una chat?
Sì. Collegate il vostro assistente e chiedete quali account sono collegati; fa lo stesso tipo di chiamata e vi rilegge la risposta. Farla una volta a mano vale comunque la pena, perché la forma dell'errore che vedete qui è la stessa che leggerà un agente IA.
Una stanza di progetto ha bisogno di questa chiave?
Non per aprire una stanza o interpellare un agente IA integrato. Solo un vostro agente che agisce su LinkedIn ha bisogno di una chiave, e quella la crea da sé la stanza.