REST APIGET

Podsumowanie skrzynki

Sprawdź nieprzeczytane komentarze, wzmianki, wiadomości i opinie na swoich kontach, zobacz, z których kanałów skrzynki może korzystać każde konto, i poproś o świeży odczyt.

Skrzynka zbiera cztery kanały z połączonych kont: komentarze do postów, wzmianki o kontach w postach innych osób, wiadomości bezpośrednie oraz opinie w Google Business Profile. TikTok i X nie mają skrzynki.

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

Zwraca liczbę nieprzeczytanych elementów w każdym kanale oraz, dla każdego połączonego konta, dostępne kanały i czas ostatniego odczytu.

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.

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.

Obsługiwane platformy

Kanały dostępne na każdej platformie. Konto ma tylko te kanały, do których jego połączenie ma uprawnienia; podsumowanie podaje to dla każdego konta.

PlatformaKomentarzeWzmiankiWiadomościOpinie
FACEBOOKTakTakTakNie
INSTAGRAMTakTylko odczyt, dla kont połączonych przez FacebookaTakNie
THREADSTakTakNieNie
YOUTUBETakNieNieNie
LINKEDINTylko strony organizacjiNieNieNie
BLUESKYTakTakTakNie
MASTODONTakTakTakNie
GOOGLE_BUSINESSNieNieNieTak

Pola podsumowania

PoleOpis
unreadElementy UNREAD w każdym kanale: comments, mentions, conversations i reviews
accounts[].accountIdId konta z GET /social-accounts, wraz z platform, accountName i avatarUrl
accounts[].needsReconnectTrue, gdy konto trzeba połączyć ponownie, aby odczytać jego komentarze
accounts[].lastSyncedAtMoment ostatniego odczytu konta przez AdaptlyPost lub null przed pierwszym odczytem
accounts[].lastErrorCodePrzyczyna niepowodzenia ostatniego odczytu lub null
accounts[].commentsAVAILABLE, RECONNECT_REQUIRED lub UNSUPPORTED dla danego kanału. Zob. poniżej
accounts[].mentionsAVAILABLE, RECONNECT_REQUIRED lub UNSUPPORTED dla danego kanału. Zob. poniżej
accounts[].messagesAVAILABLE, RECONNECT_REQUIRED lub UNSUPPORTED dla danego kanału. Zob. poniżej
accounts[].reviewsAVAILABLE, RECONNECT_REQUIRED lub UNSUPPORTED dla danego kanału. Zob. poniżej

Dostęp do kanałów

WartośćOpis
AVAILABLEKonto może korzystać z tego kanału
RECONNECT_REQUIREDPlatforma ma ten kanał, ale połączeniu brakuje uprawnienia lub token wygasł. Zapisy zwracają 403 inbox_reconnect_required, dopóki użytkownik nie połączy konta ponownie w AdaptlyPost
UNSUPPORTEDPlatforma nie ma takiego kanału

Natychmiastowy odczyt kont

POSThttps://post.adaptlypost.com/post/api/v1/inbox/refresh

Dodaje do kolejki odczyt każdego połączonego konta zamiast czekać na kolejne 10-minutowe uruchomienie i zwraca 202 { "queued": true }. Listy zmieniają się po zakończeniu odczytu.

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

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ć
Odczyt podsumowania skrzynki
curl --request GET \
  --url https://post.adaptlypost.com/post/api/v1/inbox/summary \
  --header 'Authorization: Bearer <api-key>'
Zlecenie natychmiastowego odczytu
curl --request POST \
  --url https://post.adaptlypost.com/post/api/v1/inbox/refresh \
  --header 'Authorization: Bearer <api-key>'

202
{ "queued": true }
200
{
  "unread": {
    "comments": 12,
    "mentions": 3,
    "conversations": 2,
    "reviews": 1
  },
  "accounts": [
    {
      "accountId": "conn_ig_001",
      "platform": "INSTAGRAM",
      "accountName": "adaptlypost",
      "avatarUrl": "https://cdn.adaptlypost.com/avatars/ig_001.jpg",
      "needsReconnect": false,
      "lastSyncedAt": "2026-11-08T09:40:12.000Z",
      "lastErrorCode": null,
      "comments": "AVAILABLE",
      "mentions": "AVAILABLE",
      "messages": "RECONNECT_REQUIRED",
      "reviews": "UNSUPPORTED"
    },
    {
      "accountId": "conn_gbp_001",
      "platform": "GOOGLE_BUSINESS",
      "accountName": "AdaptlyPost Kraków",
      "avatarUrl": null,
      "needsReconnect": false,
      "lastSyncedAt": "2026-11-08T09:38:55.000Z",
      "lastErrorCode": null,
      "comments": "UNSUPPORTED",
      "mentions": "UNSUPPORTED",
      "messages": "UNSUPPORTED",
      "reviews": "AVAILABLE"
    }
  ]
}