Kanały RSS
Podłącz kanał RSS lub Atom i zamieniaj każdy nowy wpis w szkic, zaplanowany post lub opublikowany post na wybranych kontach, z szablonem albo opisami AI.
Uprawnienie: posts.read. Zobacz Role i uprawnienia.
Wyświetlanie i odczyt kanałów oraz ich wpisów wymagają posts.read. Tworzenie, podgląd, aktualizacja, wstrzymywanie, wznawianie, sprawdzanie i usuwanie wymagają posts.draft oraz uprawnienia potrzebnego w trybie publikacji kanału: posts.schedule dla SCHEDULE, posts.publish dla PUBLISH i ai.generate dla opisów AI. Aktualizacja, wstrzymanie, wznowienie, sprawdzenie lub usunięcie kanału skonfigurowanego przez innego członka wymaga też posts.others.
Kanał jest sprawdzany według harmonogramu, a każdy wpis, który pojawi się po jego dodaniu, staje się postem na kontach z targets. Każdy post przechodzi te same kontrole co Utwórz post. Kanał publikuje jako członek, który zapisał go ostatni: utworzenie, aktualizacja lub wznowienie kanału czyni jego właścicielem członka powiązanego z kluczem.
| Metoda | Ścieżka | Opis |
|---|---|---|
| GET | /api/v1/rss-feeds | Lista kanałów obszaru roboczego, od najnowszych |
| POST | /api/v1/rss-feeds | Podłączenie kanału |
| POST | /api/v1/rss-feeds/preview | Pobranie kanału bez zapisywania i renderowanie 5 najnowszych wpisów |
| GET | /api/v1/rss-feeds/:id | Pobranie jednego kanału |
| PATCH | /api/v1/rss-feeds/:id | Zmiana wysłanych pól. Adresu URL nie można zmienić |
| DELETE | /api/v1/rss-feeds/:id | Zakończenie sprawdzania kanału. Utworzone już posty pozostają |
| GET | /api/v1/rss-feeds/:id/items | Lista wpisów, które kanał napotkał |
| POST | /api/v1/rss-feeds/:id/pause | Wstrzymanie kanału |
| POST | /api/v1/rss-feeds/:id/resume | Usunięcie powodu wstrzymania i sprawdzenie kanału w ciągu minuty |
| POST | /api/v1/rss-feeds/:id/check | Przesunięcie sprawdzenia na teraz; kanał zostanie pobrany w ciągu minuty |
POST /api/v1/rss-feeds
Pobiera kanał i zapisuje wszystkie wpisy, które już się w nim znajdują, więc publikowane są tylko te, które pojawią się później. Obszar roboczy może mieć do 20 kanałów.
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
| url | string | Tak | Publiczny adres URL http lub https kanału RSS albo Atom |
| targets | array | Tak | Od 1 do 20 kont, każde jako { platform, connectionId, pageId }. connectionId to id konta z Konta społecznościowe, a pageId jest wymagane dla FACEBOOK |
| postMode | string | Tak | DRAFT tworzy szkic. SCHEDULE planuje post na publishDelayMinutes po wykryciu wpisu. PUBLISH publikuje go od razu |
| contentMode | string | Tak | TEMPLATE wypełnia template. AI pisze jeden opis na platformę na podstawie artykułu, dodaje link i zużywa 1 kredyt AI na platformę za każdy wpis |
| name | string | Nie | Do 120 znaków. Domyślnie tytuł kanału |
| publishDelayMinutes | integer | Nie | Od 5 do 10080 (7 dni). Wymagane, gdy postMode to SCHEDULE |
| template | string | Nie | Tekst posta z {title}, {link}, {description}, {author} i {feed}, do 2000 znaków. Domyślnie {title}\n\n{link}. Opis, a potem tytuł, są skracane do limitu każdej platformy; link nigdy nie jest ucinany |
| aiInstructions | string | Nie | Dodatkowe instrukcje dla opisów AI, do 1000 znaków |
| includeImage | boolean | Nie | Dołącza obraz wpisu albo obraz podglądu artykułu. Domyślnie true |
| twitterKeepLinks | boolean | Nie | Zachowuje klikalne linki w postach na X. Tylko w planach lifetime, a każdy post na X z linkiem kosztuje wtedy więcej kredytów. Domyślnie false |
| includeKeywords | string[] | Nie | Do 50. Publikuje tylko wpisy, których tytuł lub streszczenie zawiera jedno z nich |
| excludeKeywords | string[] | Nie | Do 50. Pomija wpisy, których tytuł lub streszczenie zawiera jedno z nich |
| maxPostsPerCheck | integer | Nie | Od 1 do 10, domyślnie 3. Nowe wpisy są publikowane od najstarszych; pozostałe czekają na kolejne sprawdzenie |
| checkIntervalMinutes | integer | Nie | 15, 30, 60, 180, 360, 720 lub 1440. Domyślnie 60 |
| postLatestItem | boolean | Nie | Publikuje też najnowszy wpis przy pierwszym sprawdzeniu. Domyślnie false |
Celami mogą być FACEBOOK, INSTAGRAM, THREADS, TWITTER, BLUESKY, LINKEDIN, MASTODON, TELEGRAM i GOOGLE_BUSINESS.
Przykładowe żądanie:
{
"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": "New on the blog: {title}\n\n{link}",
"excludeKeywords": ["sponsored"]
}Zwraca 201 z kanałem:
{
"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": "New on the 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"
}Adres URL, który nie jest kanałem RSS ani Atom, kanał już podłączony, nieobsługiwana platforma docelowa, brak publishDelayMinutes lub przekroczenie limitu 20 kanałów zwraca 400. Kanał, z którym nie można się połączyć, zwraca 503. Klucz bez uprawnienia wymaganego przez tryb publikacji lub opisy AI zwraca 403.
Pola kanału
| Pole | Opis |
|---|---|
| userId | Członek, jako który publikuje kanał: ten, kto zapisał go ostatni |
| status | ACTIVE lub PAUSED |
| pauseReason | Powód wstrzymania, ustawiony tylko, gdy kanał ma status PAUSED. Zobacz tabelę poniżej |
| lastError | Błąd, który spowodował wstrzymanie, jeśli przyczyną była awaria |
| targets[].displayName | Nazwa konta uzupełniana przez AdaptlyPost. Wysłana wartość jest ignorowana |
| nextCheckAt, lastCheckedAt, lastPostedAt | Kiedy nastąpi kolejne sprawdzenie, kiedy było ostatnie i kiedy kanał ostatnio utworzył post |
Pozostałe pola zawierają opisane wyżej ustawienia.
| Powód wstrzymania | Znaczenie |
|---|---|
| USER | Ktoś wstrzymał kanał przez API lub w aplikacji |
| FETCH_FAILURES | 5 kolejnych pobrań się nie powiodło |
| CONSECUTIVE_FAILURES | 3 kolejnych wpisów nie udało się opublikować |
| ACCESS_LOST | Właściciel stracił uprawnienie wymagane przez tryb publikacji |
| SUBSCRIPTION_INACTIVE | Plan nie obejmuje już publikowania |
| CONNECTION_REMOVED | Wszystkie konta docelowe zostały odłączone |
Usuń przyczynę, a potem wznów kanał.
POST /api/v1/rss-feeds/preview
Przyjmuje url i opcjonalny template, pobiera kanał bez zapisywania czegokolwiek i zwraca url, title, siteUrl oraz 5 najnowszych items, każdy z title, link, summary, publishedAt, imageUrl i text, czyli wpisem wyrenderowanym według szablonu.
GET /api/v1/rss-feeds/:id/items
Wyświetla wpisy, które kanał napotkał, od najnowszych, z pominięciem tych, które były w nim już w chwili dodania. limit przyjmuje wartości od 1 do 100, domyślnie 20. Zwraca { "items": [...] }, każdy z id, title, link, publishedAt, createdAt, status, postId i error.
| Status wpisu | Znaczenie |
|---|---|
| BASELINE | Był już w kanale w chwili jego dodania |
| PROCESSING | Trwa zamiana w post |
| POSTED | Stał się postem. postId wskazuje ten post |
| FILTERED | Odrzucony przez reguły słów kluczowych |
| SKIPPED | Opublikowany ponad 14 dni przed dodaniem kanału |
| FAILED | Nie udało się utworzyć posta. error podaje przyczynę |
Aktualizacja, wstrzymanie, wznowienie, sprawdzenie i usunięcie
PATCH przyjmuje te same pola co tworzenie, z wyjątkiem url i postLatestItem, i zmienia tylko te, które wyślesz. Wstrzymanie, wznowienie, sprawdzenie i usunięcie nie przyjmują treści żądania. Każde z nich oprócz usunięcia zwraca kanał; usunięcie zwraca { "deleted": true }. Identyfikator, który nie istnieje lub należy do innego obszaru roboczego, zwraca 404.