API pública
La API REST de Feedjolt usa JSON y autenticación con token Bearer. Lee y escribe publicaciones, comentarios, votos y estados. Referencia en api.feedjolt.com/docs.
La API de Feedjolt es una API REST sobre JSON. La auth se hace con claves API (Bearer tokens). La referencia completa de endpoints, con try-it, está en:
Esta página cubre lo que necesitas saber antes de abrir esa. El detalle orientado a ingeniería (auth, errores, paginación, idempotencia, contrato de webhooks) está en Desarrolladores -> API.
URL base
https://api.feedjolt.com/api/v1Autenticación
- Panel -> Ajustes -> Claves API -> Nueva clave.
- Pon un nombre (algo como
production-zapierpara que lo recuerdes). - Elige scopes - qué puede hacer la clave.
- Copia la clave. Se muestra una sola vez. Si la pierdes, necesitarás una nueva.
Envía la clave en la cabecera Authorization:
Authorization: Bearer fjk_abc123...Las claves API empiezan con fjk_ para que sean fáciles de detectar en logs (y en nuestra detección de filtraciones de git).
Lo que puedes hacer
La API expone las mismas operaciones que el panel - leer y escribir posts, comentarios, votos, estados, etiquetas, miembros, webhooks. El detalle por endpoint (ruta, forma del cuerpo, parámetros de query, esquema de respuesta, scopes requeridos) está en la referencia OpenAPI.
Una llamada típica:
curl -H "Authorization: Bearer $FEEDJOLT_KEY" \
"https://api.feedjolt.com/api/v1/boards/feature-requests/posts?limit=10"Errores
Los errores devuelven códigos HTTP estándar (400, 401, 403, 404, 409, 422, 429, 5xx). Los cuerpos siguen la forma por defecto de FastAPI. Cada respuesta incluye una cabecera X-Request-ID - inclúyela en cualquier reporte de bug.
Ver Desarrolladores -> API -> Errores para la estrategia de reintento.
Revocar claves
Las claves se pueden revocar en cualquier momento en Ajustes -> Claves API. La revocación es inmediata.
Si una clave se filtra, revócala al instante. No detectamos filtraciones automáticamente (todavía); recomendamos git-secrets o un hook similar de pre-commit.
Spec OpenAPI
Referencia completa, interactiva, con try-it:
El JSON OpenAPI está en https://api.feedjolt.com/openapi.json para codegen.
SDKs / clientes
No publicamos SDKs oficiales todavía. La API es lo bastante pequeña como para que un cliente escrito a mano en tu lenguaje suela bastar. Si escribes uno, mándanoslo y lo listaremos aquí.
Webhooks
Feedjolt envía eventos firmados por POST a tu endpoint cuando cambian publicaciones, estados, comentarios o votos. Crea endpoints, elige eventos y reenvíalos.
Desarrolladores
Integra Feedjolt en tu app con el widget incrustable, webhooks firmados y la API REST. Guía rápida, referencias y el flujo para reportar errores.