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
}
]
}| Pole | Opis |
|---|---|
| syncInProgress | True, dopóki którekolwiek konto czeka w kolejce lub jest synchronizowane |
| historyHorizonAt | Najwcześniejsza data, dla której jakiekolwiek konto ma dane. Dla wcześniejszych dat danych po prostu nie ma, co nie oznacza zerowej aktywności |
| connectionId | id konta z Konta społecznościowe |
| status | IDLE, QUEUED, SYNCING lub FAILED |
| lastErrorMessage | Powód niepowodzenia ostatniej synchronizacji, jeśli się nie udała |
| needsAnalyticsReconnect | True, 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/syncBez 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.