Publicaciones

Obtener una publicación

Devuelve una publicación con el estado de cada red, su enlace una vez publicada y su error. En live, cualquiera del Workspace; en prueba, una simulada.

GEThttps://api.sofia-post.com/api/v1/posts/{id}

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

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

Obtener una publicación

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

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

Lee una publicación para seguir el estado de cada una de sus redes: cada destino pasa a published con su enlace permanente, o a failed con su motivo. Para recibir un aviso sin consultar la API, registra un webhook.

{
  "id": "efc578cc-ef79-40e9-876d-be1a33d3b8db",
  "status": "published",
  "targets": [
    {
      "platform": "instagram",
      "state": "published",
      "publishedAt": "2026-11-02T20:17:25.453Z",
      "permalink": "https://www.instagram.com/p/DfQJVPGFfb_/"
    }
  ]
}

Estados

Estado	Significado
`draft`	Guardada, no sale
`scheduled`	Saldrá en `scheduledAt`
`publishing`	Enviándose a la red
`published`	En línea, con su `permalink`
`failed`	La red la ha rechazado; `error` dice por qué
`sent_to_inbox`	Enviada a la app de la red, donde el propietario la termina (TikTok)

El status de la publicación resume sus destinos. Vale partial cuando una red ha publicado y otra ha fallado.

Autorizaciones

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

Parámetros de ruta

idstringobligatorio
Identificador de la publicación.

Respuesta

La publicación y el estado de cada destino.

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

¿Te ha resultado útil esta página?