Publicaciones

Listar las publicaciones

Lista las publicaciones de los establecimientos accesibles al token, las más recientes primero, filtrables por establecimiento, estado, fechas y autor.

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

GET/v1/posts

Clave de API o token de accesoSe guarda solo en esta pestaña y se envía únicamente a 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"

Autorizaciones

Authorizationstringobligatorio
Tu clave personal o token de acceso OAuth, enviado como Bearer <token>.

Parámetros de consulta

establishmentIdstring
Solo las publicaciones de este establecimiento.
cursorstring
El nextCursor de la página anterior.
statusstring
Live: al menos una red en este estado. El status de la publicación resume sus redes, así que filtrar por failed puede devolver partial.
Valores permitidos: draftscheduledpublishingpublishedsent_to_inboxfailed
fromstring<date-time>
Live: al menos una red publicada (o, antes de publicar, programada) a partir de este instante.
tostring<date-time>
Live: y antes de este instante (excluido).
createdBystring
Live: me para las publicaciones de la persona por la que actúa el token, app para las que creó esta aplicación. Ausente: todas.
Valores permitidos: meapp
limitnumber
Tamaño de página, de 1 a 100 (20 por defecto).

Respuesta

200application/json

Una página de publicaciones, con nextCursor cuando hay más.

dataobject[]obligatorio
Las publicaciones de la página
Mostrar atributos hijos
- idstringobligatorio
  Identificador de la publicación
- statusstringobligatorio
  En todas las redes; partial: publicada en una, fallida en otra
  Valores permitidos: draftscheduledpublishingpublishedsent_to_inboxfailedpartial
- establishmentIdstringobligatorio
  Establecimiento de la publicación
- createdAtstring<date-time>obligatorio
  Cuándo se creó la publicación
- targetsobject[]obligatorio
  Una entrada por red y cuenta: dos cuentas en una red, dos entradas
  Mostrar atributos hijos
  - platformstringobligatorio
    Red del destino
  - accountIdstringobligatorio
    La cuenta que publica (GET /v1/establishments/:id/accounts)
  - statestringobligatorio
    Estado del destino en su red
    Valores permitidos: draftscheduledpublishingpublishedsent_to_inboxfailed
  - publishedAtstring<date-time>
    Cuándo se publicó el destino
  - permalinkstring
    Enlace a la publicación en la red
  - errorstring
    Por qué la red la rechazó
- scheduledAtstring<date-time>
  Cuándo está programada la publicación
nextCursorstring
Pásalo como ?cursor= para la página siguiente; ausente al final

400

invalid_cursor, o invalid_request para un parámetro mal formado.

401

El token falta, es desconocido, ha caducado o está revocado.

403

El token no tiene el permiso posts:read.

404

establishment_not_found: el establecimiento está fuera del alcance del token.

4XXapplication/json

Cualquier otro error, en el sobre de error.