Feedjoltdocs
Desenvolupadors

Desenvolupadors

Integra Feedjolt a la teva app amb el widget incrustable, webhooks signats i l'API REST. Guia ràpida, referències i el flux per reportar errors.

Aquesta secció és per a enginyers. Si configures Feedjolt com a admin (activar Slack, convidar membres), la secció Integracions és més amigable. Si escrius codi que parla amb Feedjolt, ets al lloc correcte.

Què pots construir

  • Incrustar feedback dins la teva app - instal·la el widget.
  • Reaccionar a esdeveniments - els webhooks lliuren JSON signat al teu endpoint quan es mou el feedback.
  • Llegir i escriure programàticament - l'API REST cobreix la major part del que fa el panell.

Per on començar

  • Quickstart - una integració de 10 minuts: widget al teu lloc, una clau API a la mà, un webhook arribant al teu servidor de dev.
  • Per a agents - quan fer servir Feedjolt, OpenAPI, MCP, markdown.
  • Widget - instal·lació, configuració, personalització, CSP.
  • Webhooks - referència de payload, verificació de firma, comportament de reintent.
  • API - autenticació, errors, paginació, enllaços a la referència OpenAPI completa.
  • MCP - servidor Streamable HTTP per a Claude, Cursor i altres agents.
  • Sandbox - alta self-serve, prova i claus API.

Referència de l'API

La referència interactiva d'endpoints és a https://api.feedjolt.com/docs (Swagger UI, amb try-it). JSON OpenAPI: https://www.feedjolt.com/openapi.json (també a https://api.feedjolt.com/openapi.json). YAML: https://www.feedjolt.com/api/openapi.yaml. Targeta MCP: https://www.feedjolt.com/.well-known/mcp.json.

Les pàgines d'aquesta secció cobreixen comportaments transversals (auth, errors, paginació, contracte de webhooks) - la referència OpenAPI és canònica per a la forma per endpoint.

El que ve

Algunes coses al full de ruta que sabem que demanen els desenvolupadors:

  • Reintents automàtics de webhooks amb backoff exponencial.
  • Firmes de webhook amb timestamp signat (protecció contra replay estil Stripe).
  • Una API JS window.feedjolt.open() per a botons personalitzats del widget.
  • SDKs oficials en TypeScript i Python.

Vota el que et desbloquejaria.

Reportar bugs

Si alguna cosa es comporta estranya:

  1. Reprodueix en un espai de dev nou perquè veiem les mateixes dades.
  2. Reporta a /ca/contact amb l'ID de petició de X-Request-ID (cada resposta de l'API en porta un).
  3. Per a bugs del widget, enganxa el teu snippet d'instal·lació i qualsevol error de CSP de la consola.

On this page