REST APIGET

Wzmianki w skrzynce

Wyświetl posty i komentarze wspominające twoje konta na Facebooku, Instagramie, Threads, Bluesky i Mastodonie, odpowiadaj na nie i oznaczaj je jako przeczytane.

GEThttps://post.adaptlypost.com/post/api/v1/inbox/mentions

Zwraca posty i komentarze wspominające konta, od najnowszych. Odpowiedź: { mentions, total, hasMore, nextCursor }.

Klucz API (token Bearer)
Uprawnienie:inbox.readRole i uprawnienia

Każda rola ma inbox.read, więc skrzynkę może odczytać każdy ważny klucz.

Parametry zapytania

ParametrTypOpis
accountIdsstring[]Tylko te konta, według id z GET /social-accounts. Klucz można powtórzyć lub rozdzielić wartości przecinkami. Do 50
platformsPlatformType[]Tylko te platformy. Klucz można powtórzyć lub rozdzielić wartości przecinkami
statusesInboxStatus[]Tylko elementy w tych stanach: UNREAD, READ lub DONE. Klucz można powtórzyć lub rozdzielić wartości przecinkami
sincestring (ISO 8601)Tylko elementy utworzone na platformie w tym momencie lub później
searchstringWyszukiwany tekst
limitnumberElementy na stronę, od 1 do 100. Domyślnie 25
cursorstringnextCursor poprzedniej strony. Na ostatniej stronie nextCursor ma wartość null

Około 10 minut, nie w czasie rzeczywistym

AdaptlyPost odczytuje każde połączone konto co 10 minut i zapisuje znalezione dane. Listy korzystają z tej kopii, więc nowy komentarz, wzmianka, wiadomość lub opinia pojawia się w ciągu około 10 minut. POST /api/v1/inbox/refresh zleca odczyt od razu. Zdarzenia webhooków pochodzą z tych samych odczytów.

Kanały wymagające ponownego połączenia

Każdy kanał jest dostępny przez API. Gdy połączeniu brakuje uprawnienia platformy do kanału lub działania, także takiego, które platforma nadal weryfikuje dla AdaptlyPost, GET /api/v1/inbox/summary pokazuje kanał jako RECONNECT_REQUIRED, a każdy zapis w nim zwraca 403 inbox_reconnect_required. Tak samo jest przy wygasłym tokenie. Należy poprosić użytkownika o ponowne połączenie konta w AdaptlyPost; ponawianie nie pomoże.

Pola wzmianki

PoleOpis
idId wzmianki. Używane w poniższych endpointach
accountIdKonto, do którego należy element: jego id z GET /social-accounts
platformPlatforma jako PlatformType
accountNameWyświetlana nazwa tego konta
platformMentionIdId posta lub komentarza na platformie, który wspomina konto
authorAutor: id (identyfikator użytkownika na platformie), name, username i avatarUrl. id, username i avatarUrl mogą mieć wartość null
textTekst wspominający konto
permalinkPubliczny link na platformie lub null, jeśli platforma go nie podaje
thumbnailUrlObraz posta lub null
createdAtMoment utworzenia na platformie
statusUNREAD, READ lub DONE. Ten stan jest przechowywany tylko w AdaptlyPost; platforma go nie widzi
repliedTrue, gdy konto odpowiedziało przez AdaptlyPost
repliedAtMoment ostatniej odpowiedzi konta lub null
capabilitiescanReply: false, gdy platforma nie pozwala kontu odpowiedzieć, jak w przypadku wzmianek na Instagramie
repliesOdpowiedzi wysłane przez AdaptlyPost, od najstarszych, każda z id, text, permalink i createdAt. Odpowiedzi napisane w aplikacji platformy nie są wymieniane

Odpowiedź na wzmiankę

POSThttps://post.adaptlypost.com/post/api/v1/inbox/mentions/:id/reply

Odpowiada z danego konta na post lub komentarz, który je wspomina, i zwraca 201 ze wzmianką. Na Mastodonie odpowiedź zachowuje widoczność oryginalnego posta.

Klucz API (token Bearer)
Uprawnienie:inbox.replyRole i uprawnienia

Zapisy wymagają inbox.reply (Administrator i Edytor) oraz aktywnego planu AdaptlyPost. Bez planu zwracają 403 subscription_required.

Parametry treści żądania

ParametrTypOpis
textWYMAGANEstringOdpowiedź. Obowiązuje limit komentarzy platformy: Threads 500, Bluesky 300, Mastodon 500 i Facebook 8000 znaków

Oznaczanie jako przeczytane lub załatwione

POSThttps://post.adaptlypost.com/post/api/v1/inbox/mentions/status

Ustawia status maksymalnie 100 wzmianek i zwraca { mentions, unreadCount }.

Klucz API (token Bearer)
Uprawnienie:inbox.replyRole i uprawnienia

Parametry treści żądania

ParametrTypOpis
idsWYMAGANEstring[]Od 1 do 100 id z listy
statusWYMAGANEInboxStatusUNREAD, READ lub DONE

Odmowy

Odrzucone wywołanie zwraca { statusCode, error, code, message }. Logikę należy opierać na code. message opisuje odmowę słownie.

KodStatusKiedy i co zrobić
inbox_item_not_found404Id nie istnieje lub należy do innego obszaru roboczego. Należy przerwać
inbox_action_unsupported400Platforma lub ten element nie pozwala na ukrycie, usunięcie lub polubienie. Możliwości opisuje capabilities. Należy przerwać
inbox_reconnect_required403Połączeniu brakuje uprawnienia do tego kanału lub działania, także będącego w trakcie weryfikacji platformy, albo token wygasł. Należy poprosić użytkownika o ponowne połączenie konta w AdaptlyPost. Nie należy ponawiać
inbox_reply_invalid400Tekst jest pusty lub przekracza limit. Komunikat podaje limit. Należy poprawić tekst
inbox_messaging_window_closed400Facebook lub Instagram: minęło 24-godzinne okno na odpowiedź. Należy przerwać
inbox_rate_limited429Platforma ograniczyła liczbę zapytań AdaptlyPost. Należy ponowić po pewnym czasie
inbox_platform_error503Błąd platformy. Należy ponowić później
permission_denied403Rola klucza nie ma inbox.read ani inbox.reply. Nie należy ponawiać
subscription_required403Zapis bez aktywnego planu AdaptlyPost. Nie należy ponawiać
Lista nowych wzmianek
curl --request GET \
  --url 'https://post.adaptlypost.com/post/api/v1/inbox/mentions?statuses=UNREAD&since=2026-11-01T00:00:00Z' \
  --header 'Authorization: Bearer <api-key>'
Odpowiedź na wzmiankę
curl --request POST \
  --url https://post.adaptlypost.com/post/api/v1/inbox/mentions/mnt_41c7e0b2/reply \
  --header 'Authorization: Bearer <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{ "text": "Thanks for the shout-out!" }'
Oznaczenie wzmianki jako przeczytanej
curl --request POST \
  --url https://post.adaptlypost.com/post/api/v1/inbox/mentions/status \
  --header 'Authorization: Bearer <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{ "ids": ["mnt_41c7e0b2"], "status": "READ" }'
200
{
  "mentions": [
    {
      "id": "mnt_41c7e0b2",
      "accountId": "conn_bsky_001",
      "platform": "BLUESKY",
      "accountName": "adaptlypost.com",
      "platformMentionId": "at://did:plc:4k2x.../app.bsky.feed.post/3lb2x7q",
      "author": {
        "id": "did:plc:7f3q2m",
        "name": "Marta Nowak",
        "username": "marta.bsky.social",
        "avatarUrl": null
      },
      "text": "Scheduling a month of posts with @adaptlypost.com took me 20 minutes",
      "permalink": "https://bsky.app/profile/marta.bsky.social/post/3lb2x7q",
      "thumbnailUrl": null,
      "createdAt": "2026-11-07T18:03:10.000Z",
      "status": "UNREAD",
      "replied": false,
      "repliedAt": null,
      "capabilities": { "canReply": true },
      "replies": []
    }
  ],
  "total": 3,
  "hasMore": false,
  "nextCursor": null
}