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

GET/v1/posts

Clé API ou jeton d’accèsConservé dans cet onglet uniquement, et envoyé uniquement à api.sofia-post.com.establishmentId (query)cursor (query)status (query)from (query)to (query)createdBy (query)limit (query)

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

Autorisations

Authorizationstringrequis
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

200application/json

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

400

invalid_cursor, ou invalid_request pour un paramètre mal formé.

401

Le jeton est absent, inconnu, expiré ou révoqué.

403

Le jeton n’a pas la permission posts:read.

404

establishment_not_found : l’établissement n’est pas accessible au jeton.

4XXapplication/json

Toute autre erreur, dans l’enveloppe d’erreur.