API pública

L'API de Feedjolt és una API REST sobre JSON. L'auth es fa amb claus API (Bearer tokens). La referència completa d'endpoints, amb try-it, és a:

https://api.feedjolt.com/docs

Aquesta pàgina cobreix el que necessites saber abans d'obrir-la. El detall orientat a enginyeria (auth, errors, paginació, idempotència, contracte de webhooks) és a Desenvolupadors -> API.

URL base

https://api.feedjolt.com/api/v1

Autenticació

1. Panell -> Configuració -> Claus API -> Nova clau.
2. Posa un nom (alguna cosa com production-zapier per recordar-ho).
3. Tria scopes - què pot fer la clau.
4. Copia la clau. Es mostra un sol cop. Si la perds, necessitaràs una de nova.

Envia la clau a la capçalera Authorization:

Authorization: Bearer fjk_abc123...

Les claus API comencen amb fjk_ perquè siguin fàcils de detectar als logs (i a la nostra detecció de filtracions de git).

El que pots fer

L'API exposa les mateixes operacions que el panell - llegir i escriure posts, comentaris, vots, estats, etiquetes, membres, webhooks. El detall per endpoint (ruta, forma del cos, paràmetres de query, esquema de resposta, scopes requerits) és a la referència OpenAPI.

Una crida típica:

curl -H "Authorization: Bearer $FEEDJOLT_KEY" \
     "https://api.feedjolt.com/api/v1/boards/feature-requests/posts?limit=10"

Errors

Els errors retornen codis HTTP estàndard (400, 401, 403, 404, 409, 422, 429, 5xx). Els cossos segueixen la forma per defecte de FastAPI. Cada resposta inclou una capçalera X-Request-ID - inclou-la en qualsevol report de bug.

Veure Desenvolupadors -> API -> Errors per a l'estratègia de reintent.

Revocar claus

Les claus es poden revocar en qualsevol moment a Configuració -> Claus API. La revocació és immediata.

Si una clau es filtra, revoca-la a l'instant. No detectem filtracions automàticament (encara); recomanem git-secrets o un hook similar de pre-commit.

Spec OpenAPI

Referència completa, interactiva, amb try-it:

https://api.feedjolt.com/docs

El JSON OpenAPI és a https://api.feedjolt.com/openapi.json per a codegen.

SDKs / clients

No publiquem SDKs oficials encara. L'API és prou petita perquè un client escrit a mà en el teu llenguatge solgui bastar. Si en escrius un, envia'ns-el i el llistarem aquí.