REST APIPOST

Synchronizacja analityki

Sprawdź, jak aktualna jest analityka każdego połączonego konta, zobacz, które konta trzeba połączyć ponownie, i poproś o odświeżenie tuż po publikacji.

Uprawnienie: analytics.read. Zobacz Role i uprawnienia.

GET /api/v1/analytics/sync-status wymaga analytics.read, a POST /api/v1/analytics/sync wymaga analytics.sync (Administrator i Edytor).

Analityka jest odczytywana z każdej platformy według harmonogramu, co kilka godzin, zależnie od limitów zapytań danej platformy. Dwa endpointy pozwalają sprawdzić stan tego procesu i poprosić o odświeżenie, gdy nie możesz czekać.

GET /api/v1/analytics/sync-status

GET /api/v1/analytics/sync-status
{
  "accountGroupId": "ag_01j9x",
  "syncInProgress": false,
  "lastSyncedAt": "2026-09-08T06:12:41.000Z",
  "historyHorizonAt": "2026-03-12T00:00:00.000Z",
  "platforms": [
    {
      "platform": "INSTAGRAM",
      "connectionId": "cmlxmnxn20006hzpzvo291ckg",
      "accountName": "adaptlypost",
      "status": "IDLE",
      "lastSyncedAt": "2026-09-08T06:12:41.000Z",
      "lastErrorMessage": null,
      "historyHorizonAt": "2026-03-12T00:00:00.000Z",
      "lastDiscoveryAt": "2026-09-08T06:10:03.000Z",
      "needsAnalyticsReconnect": false
    }
  ]
}
PoleOpis
syncInProgressTrue, dopóki którekolwiek konto czeka w kolejce lub jest synchronizowane
historyHorizonAtNajwcześniejsza data, dla której jakiekolwiek konto ma dane. Dla wcześniejszych dat danych po prostu nie ma, co nie oznacza zerowej aktywności
connectionIdid konta z Konta społecznościowe
statusIDLE, QUEUED, SYNCING lub FAILED
lastErrorMessagePowód niepowodzenia ostatniej synchronizacji, jeśli się nie udała
needsAnalyticsReconnectTrue, gdy konto połączono, zanim pojawiły się uprawnienia do analityki

Konta na platformach bez analityki (Mastodon, Telegram, Tumblr i WordPress) nie są wymieniane.

Ponowne łączenie na potrzeby analityki

Platformy społecznościowe nie pozwalają aplikacji dodawać uprawnień do istniejącej zgody. Konto połączone, zanim AdaptlyPost zaczął prosić o dostęp do analityki, pozostaje wstrzymane, bez synchronizacji i bez błędów, dopóki jego właściciel nie połączy go ponownie i nie zatwierdzi dodatkowych uprawnień. To właśnie sygnalizuje needsAnalyticsReconnect. Sprawdzi się tu link do połączenia, dzięki któremu agent lub klient może połączyć konto ponownie bez udostępniania hasła.

POST /api/v1/analytics/sync

POST /api/v1/analytics/sync

Bez treści. Dodaje do kolejki synchronizację każdego konta z analityką i ponownie odczytuje ostatnie 7 dni. Użyj tego zaraz po publikacji, gdy do zaplanowanego odświeżenia jest jeszcze daleko.

{
  "queued": true,
  "message": "Analytics sync queued. Fresh numbers will appear within a few minutes",
  "cooldownSecondsRemaining": null
}

Jedno uruchomienie na obszar roboczy co 15 minut, a kanał YouTube odczytany w ciągu ostatnich 12 godzin jest pomijany. W czasie karencji odpowiedź nadal ma kod 200:

{
  "queued": false,
  "message": "Analytics were synced recently. Please try again in 412 seconds",
  "cooldownSecondsRemaining": 412
}

Uruchomienie jest asynchroniczne. Odpytuj GET /api/v1/analytics/sync-status, aż syncInProgress będzie mieć wartość false, a potem odczytaj metryki ponownie. Nie ponawiaj żądania w czasie karencji, bo odpowiedź się nie zmieni.