Synchronisation des statistiques

Les statistiques sont lues sur chaque plateforme selon un planning, toutes les quelques heures selon les limites de débit de la plateforme. Deux endpoints vous permettent de voir où cela en est et de demander une actualisation quand vous ne pouvez pas attendre.

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
    }
  ]
}

Champ	Description
syncInProgress	True tant qu'un compte est en file d'attente ou en cours de synchronisation
historyHorizonAt	Date la plus ancienne pour laquelle un compte a des données. Les dates antérieures n'ont pas de données, ce n'est pas une activité nulle
connectionId	L'`id` du compte provenant de Comptes sociaux
status	`IDLE`, `QUEUED`, `SYNCING` ou `FAILED`
lastErrorMessage	Raison de l'échec de la dernière synchronisation, le cas échéant
needsAnalyticsReconnect	True lorsque le compte a été connecté avant l'existence des permissions de statistiques

Les comptes sur des plateformes sans statistiques (X) ne sont pas listés.

Reconnexion pour les statistiques

Les plateformes sociales ne permettent pas à une application d'ajouter des permissions à une autorisation existante. Un compte connecté avant qu'AdaptlyPost ne demande l'accès aux statistiques reste en attente, sans synchronisation ni erreur, jusqu'à ce que son propriétaire se reconnecte et approuve les permissions supplémentaires. C'est ce que signale needsAnalyticsReconnect. Un lien de connexion permet de faire cela, afin qu'un agent ou un client puisse se reconnecter sans partager de mot de passe.

POST /api/v1/analytics/sync

POST /api/v1/analytics/sync

Aucun corps de requête. Met en file d'attente une synchronisation pour chaque compte disposant de statistiques et relit les 7 derniers jours. Utilisez-le juste après avoir publié, quand l'actualisation planifiée est trop lointaine.

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

Une exécution par espace de travail toutes les 10 minutes. Pendant cette période d'attente, la réponse reste 200 :

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

L'exécution est asynchrone. Interrogez GET /api/v1/analytics/sync-status jusqu'à ce que syncInProgress soit false, puis relisez les statistiques. Ne réessayez pas pendant la période d'attente ; la réponse ne changera pas.