Feed RSS

Permesso: posts.read. Vedi Ruoli e permessi.

Elencare e leggere i feed e i loro elementi richiede posts.read. Creare, vedere l'anteprima, aggiornare, mettere in pausa, riprendere, controllare ed eliminare richiedono posts.draft, più il permesso che chiede la modalità di pubblicazione del feed: posts.schedule per SCHEDULE, posts.publish per PUBLISH e ai.generate per le didascalie IA. Un feed configurato da un altro membro richiede anche posts.others per aggiornarlo, metterlo in pausa, riprenderlo, controllarlo o eliminarlo.

Un feed viene controllato secondo una pianificazione, e ogni elemento comparso dopo che l'hai aggiunto diventa un post sugli account in targets. Ogni post passa gli stessi controlli di Crea post. Un feed pubblica come il membro che l'ha salvato per ultimo: creare, aggiornare o riprendere un feed rende il membro della chiave il suo proprietario.

POST /api/v1/rss-feeds

Legge il feed e registra ogni elemento che contiene già, così vengono pubblicati solo gli elementi che compaiono dopo. Un workspace può avere fino a 20 feed.

Le destinazioni possono essere FACEBOOK, INSTAGRAM, THREADS, TWITTER, BLUESKY, LINKEDIN, MASTODON, TELEGRAM e GOOGLE_BUSINESS.

Richiesta di esempio:

{
  "url": "https://blog.example.com/feed.xml",
  "targets": [
    { "platform": "LINKEDIN", "connectionId": "conn_li_001" },
    { "platform": "FACEBOOK", "connectionId": "conn_fb_001", "pageId": "123456789012345" }
  ],
  "postMode": "SCHEDULE",
  "publishDelayMinutes": 30,
  "contentMode": "TEMPLATE",
  "template": "Novità sul blog: {title}\n\n{link}",
  "excludeKeywords": ["sponsored"]
}

Restituisce 201 con il feed:

{
  "id": "rss_01j9x",
  "userId": "user_123",
  "accountGroupId": "ag_01j9x",
  "name": "Example Blog",
  "url": "https://blog.example.com/feed.xml",
  "siteUrl": "https://blog.example.com",
  "status": "ACTIVE",
  "postMode": "SCHEDULE",
  "publishDelayMinutes": 30,
  "contentMode": "TEMPLATE",
  "template": "Novità sul blog: {title}\n\n{link}",
  "includeImage": true,
  "twitterKeepLinks": false,
  "includeKeywords": [],
  "excludeKeywords": ["sponsored"],
  "maxPostsPerCheck": 3,
  "checkIntervalMinutes": 60,
  "targets": [
    { "platform": "LINKEDIN", "connectionId": "conn_li_001", "displayName": "Example Inc." },
    { "platform": "FACEBOOK", "connectionId": "conn_fb_001", "pageId": "123456789012345", "displayName": "Example" }
  ],
  "nextCheckAt": "2026-11-08T15:00:00.000Z",
  "createdAt": "2026-11-08T14:00:00.000Z",
  "updatedAt": "2026-11-08T14:00:00.000Z"
}

Un URL che non è un feed RSS o Atom, un feed già collegato, una piattaforma di destinazione non supportata, un publishDelayMinutes mancante o il limite di 20 feed restituisce 400. Un feed non raggiungibile restituisce 503. Una chiave senza il permesso richiesto dalla modalità di pubblicazione o dalle didascalie IA restituisce 403.

Campi del feed

Gli altri campi riportano le impostazioni sopra.

Risolvi la causa, poi riprendi il feed.

POST /api/v1/rss-feeds/preview

Accetta url e un template facoltativo, legge il feed senza salvare nulla e restituisce url, title, siteUrl e i suoi 5 items più recenti, ciascuno con title, link, summary, publishedAt, imageUrl e text, l'elemento con il modello applicato.

GET /api/v1/rss-feeds/:id/items

Elenca gli elementi che il feed ha visto, dal più recente, esclusi quelli già presenti quando il feed è stato aggiunto. limit accetta da 1 a 100, predefinito 20. Restituisce { "items": [...] }, ciascuno con id, title, link, publishedAt, createdAt, status, postId e error.

Aggiornare, mettere in pausa, riprendere, controllare ed eliminare

PATCH accetta gli stessi campi della creazione, tranne url e postLatestItem, e cambia solo quelli che invii. Pausa, ripresa, controllo ed eliminazione non hanno corpo. Tutti tranne l'eliminazione restituiscono il feed; l'eliminazione restituisce { "deleted": true }. Un id che non esiste o che appartiene a un altro workspace restituisce 404.