Webhooks
Feedjolt envia esdeveniments signats per POST al teu endpoint quan canvien publicacions, estats, comentaris o vots. Crea endpoints, tria esdeveniments i reenvia'ls.
Quan passa alguna cosa a Feedjolt - es crea un post, canvia un estat, un vot creua un llindar - Feedjolt pot fer POST a una URL que tu controles.
Aquesta pàgina cobreix la configuració d'admin. Per a la referència orientada a enginyeria (forma del payload, verificació de firma, comportament de reintent), veure Desenvolupadors -> Webhooks.
Configurar un endpoint
- Panell -> Configuració -> Webhooks -> Nou endpoint.
- Introdueix la teva URL.
- Tria quins esdeveniments enviar.
- Generem un secret de firma. Desa'l; el faràs servir per verificar les peticions entrants.
Esdeveniments
Tria qualsevol subconjunt per endpoint. Pots tenir diversos endpoints amb filtres d'esdeveniments diferents.
| Esdeveniment | Quan |
|---|---|
post.created | Es crea un nou post en un tauler al qual estàs subscrit. |
post.merged | Un post es fusiona amb un altre. |
post.moderated | Un esborrany s'aprova o rebutja. |
status.changed | Un post canvia d'estat. |
comment.created | Es publica un nou comentari. |
vote.threshold | Un post supera un llindar de vots configurat. |
Contracte de lliurament
POST application/jsonamb el payload de l'esdeveniment com a cos.- Capçaleres:
X-Feedjolt-Signature(HMAC-SHA256 sobre el cos canònic),X-Feedjolt-Event,X-Feedjolt-Timestamp. - Timeout de 10 segons.
- Un intent de lliurament per esdeveniment avui. Els fallits es registren; els admins poden replayar manualment des del panell.
Les formes completes de payload i els exemples de firma viuen a Desenvolupadors -> Webhooks.
Registre de lliuraments
Cada intent es registra a Configuració -> Webhooks -> [endpoint] -> Lliuraments:
- Esdeveniment, marca de temps, codi de resposta, cos de resposta (limitat a 4 KB).
- Botó de Replay per reenviar el mateix esdeveniment sota demanda.
Els registres es conserven mentre decidim un TTL raonable - assumeix "fins que la taula creixi prou perquè n'afegim un".
Bones pràctiques
- Respon 2xx en menys de 10 segons. Posa la feina pesada en cua; confirma ràpid.
- Sigues idempotent. Els replays manuals reenvien el mateix esdeveniment.
- Verifica firmes. Sense verificació, qualsevol a internet pot falsificar esdeveniments.
Veure la referència per a desenvolupadors per a exemples de codi en Node, Python, Ruby i Go.
Integració amb Linear
Sincronitza posts de Feedjolt amb issues de Linear, amb estat i comentaris bidireccionals. Connecta per OAuth, mapeja estats, envia posts i desconnecta.
API pública
L'API REST de Feedjolt usa JSON i autenticació amb token Bearer. Llegeix i escriu publicacions, comentaris, vots i estats. Referència a api.feedjolt.com/docs.