Publications

Lister les publications

Liste les publications des établissements accessibles au jeton, les plus récentes d’abord, filtrées par établissement, statut, dates et auteur, page par page.

GEThttps://api.sofia-post.com/api/v1/posts

Lister les publications

Liste les publications des établissements accessibles au jeton, les plus récentes d’abord, filtrées par établissement, statut, dates et auteur, page par page.

Autorisations

Authorizationstringrequis

Votre clé personnelle ou jeton d’accès OAuth, envoyé sous la forme Bearer <token>.

Conservé dans cet onglet uniquement, et envoyé uniquement à api.sofia-post.com. Obtenir une clé API

Paramètres de requête

establishmentIdstring

Uniquement les publications de cet établissement.

cursorstring

Le nextCursor de la page précédente.

statusstring

En ligne : au moins un réseau dans cet état. Le status de la publication résume ses réseaux, donc filtrer sur failed peut renvoyer partial.

fromstring<date-time>

En ligne : au moins un réseau publié (ou, avant publication, programmé) à partir de cet instant.

tostring<date-time>

En ligne : et avant cet instant (exclu).

createdBystring

En ligne : me pour les publications de la personne pour qui le jeton agit, app pour celles créées par cette application. Absent : toutes.

limitnumber

Taille de page, de 1 à 100 (20 par défaut).

Lister les publications

curl -X GET 'https://api.sofia-post.com/api/v1/posts' \
  -H "Authorization: Bearer $SOFIA_API_KEY"

{
  "data": [
    {
      "id": "string",
      "status": "published",
      "establishmentId": "string",
      "scheduledAt": "2026-11-02T10:00:00.000Z",
      "createdAt": "2026-11-02T10:00:00.000Z",
      "targets": [
        {
          "platform": "instagram",
          "accountId": "string",
          "state": "published",
          "permalink": "https://www.instagram.com/p/C1"
        }
      ]
    }
  ]
}

Lister les publications

curl --request GET \
  --url 'https://api.sofia-post.com/api/v1/posts' \
  --header "Authorization: Bearer $SOFIA_API_KEY"

{
  "data": [
    {
      "id": "string",
      "status": "published",
      "establishmentId": "string",
      "scheduledAt": "2026-11-02T10:00:00.000Z",
      "createdAt": "2026-11-02T10:00:00.000Z",
      "targets": [
        {
          "platform": "instagram",
          "accountId": "string",
          "state": "published",
          "permalink": "https://www.instagram.com/p/C1"
        }
      ]
    }
  ]
}

GET /v1/posts liste toutes les publications accessibles au jeton, les plus récentes d’abord, filtrées par establishmentId, status, from, to et createdBy (me ou app). Une publication correspond à status quand au moins un de ses réseaux est dans cet état. Voir la pagination.

Les états possibles d’une publication sont décrits sur la page Lire une publication.

Autorisations

Authorizationstringheaderrequis
Votre clé personnelle ou jeton d’accès OAuth, envoyé sous la forme Bearer <token>.

Paramètres de requête

establishmentIdstring
Uniquement les publications de cet établissement.
cursorstring
Le nextCursor de la page précédente.
statusstring
En ligne : au moins un réseau dans cet état. Le status de la publication résume ses réseaux, donc filtrer sur failed peut renvoyer partial.
Valeurs autorisées : draftscheduledpublishingpublishedsent_to_inboxfailed
fromstring<date-time>
En ligne : au moins un réseau publié (ou, avant publication, programmé) à partir de cet instant.
tostring<date-time>
En ligne : et avant cet instant (exclu).
createdBystring
En ligne : me pour les publications de la personne pour qui le jeton agit, app pour celles créées par cette application. Absent : toutes.
Valeurs autorisées : meapp
limitnumber
Taille de page, de 1 à 100 (20 par défaut).

Réponse

Une page de publications, avec nextCursor quand il y en a d’autres.

dataobject[]requis
Les publications de la page
Afficher les attributs enfants
- idstringrequis
  Identifiant de la publication
- statusstringrequis
  Sur l’ensemble des réseaux ; partial : publiée sur l’un, échouée sur l’autre
  Valeurs autorisées : draftscheduledpublishingpublishedsent_to_inboxfailedpartial
- establishmentIdstringrequis
  Établissement de la publication
- createdAtstring<date-time>requis
  Moment où la publication a été créée
- targetsobject[]requis
  Une entrée par réseau et par compte : deux comptes sur un même réseau, deux entrées
  Afficher les attributs enfants
  - platformstringrequis
    Réseau de la cible
  - accountIdstringrequis
    Le compte qui publie (GET /v1/establishments/:id/accounts)
  - statestringrequis
    État de la cible sur son réseau
    Valeurs autorisées : draftscheduledpublishingpublishedsent_to_inboxfailed
  - publishedAtstring<date-time>
    Moment où la cible a été publiée
  - permalinkstring
    Lien vers la publication sur le réseau
  - errorstring
    Pourquoi le réseau a refusé
- scheduledAtstring<date-time>
  Moment où la publication doit paraître
nextCursorstring
À passer en ?cursor= pour la page suivante ; absent à la fin

Cette page vous a-t-elle aidé ?