Obtener Post
Obtén los detalles de un post por su ID.
Obtén los detalles de un post por su ID.
/api/v1/post/{postId}Obtén los detalles completos de un post incluyendo su estado, contenido y programación.
Reemplaza {postId} con el postId devuelto por el endpoint de Publicación.
curl -H "x-api-key: <apiKey>" \
https://dopost.co/api/v1/post/<postId>curl -H "x-api-key: <apiKey>" \
https://dopost.co/api/v1/post/<postId>{
"id": "cm3abc123def456",
"status": "PUBLISHED",
"platform": "LINKEDIN",
"text": "¡Hola desde la API de dopost!",
"media": [],
"postUrl": "https://linkedin.com/feed/update/urn:li:share:123456",
"account": {
"id": "cm3xyz789ghi012",
"platform": "LINKEDIN",
"platformUsername": "johndoe"
},
"schedule": null,
"jobId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"source": "api",
"createdAt": "2025-06-01T12:00:00.000Z",
"updatedAt": "2025-06-01T12:00:05.000Z"
}{
"id": "cm3abc123def456",
"status": "PUBLISHED",
"platform": "LINKEDIN",
"text": "¡Hola desde la API de dopost!",
"media": [],
"postUrl": "https://linkedin.com/feed/update/urn:li:share:123456",
"account": {
"id": "cm3xyz789ghi012",
"platform": "LINKEDIN",
"platformUsername": "johndoe"
},
"schedule": null,
"jobId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"source": "api",
"createdAt": "2025-06-01T12:00:00.000Z",
"updatedAt": "2025-06-01T12:00:05.000Z"
}| Campo | Tipo | Descripción |
|---|---|---|
id | string | ID único del post |
status | string | PENDING, PUBLISHED, FAILED o DRAFT |
platform | string | Plataforma social de destino |
text | string | null | Texto del post |
media | array | URLs de media adjuntas al post |
postUrl | string | null | URL del post publicado en la plataforma (disponible tras publicar) |
account | object | Cuenta social a la que se publicó el post |
schedule | object | null | Detalles de programación si el post fue programado |
jobId | string | null | ID de grupo para seguimiento con el endpoint de Estado |
source | string | Origen del post (api, dashboard) |
createdAt | string | Fecha de creación ISO 8601 |
updatedAt | string | Fecha de última actualización ISO 8601 |
{
"id": "cm3def456ghi789",
"status": "PENDING",
"platform": "INSTAGRAM",
"text": "¡Próximamente!",
"media": ["https://cdn.dopost.co/uploads/foto.jpg"],
"postUrl": null,
"account": {
"id": "cm3jkl012mno345",
"platform": "INSTAGRAM",
"platformUsername": "janedoe"
},
"schedule": {
"scheduledFor": "2025-12-25T12:00:00.000Z",
"status": "SCHEDULED",
"publishedAt": null
},
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"source": "api",
"createdAt": "2025-06-01T10:00:00.000Z",
"updatedAt": "2025-06-01T10:00:00.000Z"
}{
"id": "cm3def456ghi789",
"status": "PENDING",
"platform": "INSTAGRAM",
"text": "¡Próximamente!",
"media": ["https://cdn.dopost.co/uploads/foto.jpg"],
"postUrl": null,
"account": {
"id": "cm3jkl012mno345",
"platform": "INSTAGRAM",
"platformUsername": "janedoe"
},
"schedule": {
"scheduledFor": "2025-12-25T12:00:00.000Z",
"status": "SCHEDULED",
"publishedAt": null
},
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"source": "api",
"createdAt": "2025-06-01T10:00:00.000Z",
"updatedAt": "2025-06-01T10:00:00.000Z"
}| Estado | Error | Causa |
|---|---|---|
401 | Invalid or missing API key | Cabecera x-api-key incorrecta o ausente |
403 | API key does not have permission for this action | La API key no tiene el scope necesario para este endpoint |
404 | Post not found | postId inválido o pertenece a otro workspace |
429 | Rate limit exceeded | Demasiadas peticiones. Revisa las cabeceras X-RateLimit-* y reintenta tras el tiempo indicado |
Los posts GOOGLE_BUSINESS incluyen además platformOptions (tipo, categoría, CTA, fechas y oferta), providerStatus y providerResourceName. Su error es null o { message, code, retryable, requiresReconnect, details? }; los datos desconocidos conservan null. Los estados de Google son los últimos devueltos al publicar, no una comprobación en tiempo real. PUBLISHED en dopost no garantiza que Google ya lo haya hecho visible. El listado de posts incluye estos mismos campos de Google Business.
Un post fallido incluye un objeto error con message, code, retryable y requiresReconnect. Cuando existen, se incluyen detalles de diagnóstico de la plataforma. Si esta no identificó un motivo concreto, la respuesta no inventa una causa. Un GET correcto solo confirma que se pudo consultar el estado; revisa status y error para conocer el resultado de la publicación.
groupId identifica el grupo de la web que comparten los posts creados juntos. Cada cuenta tiene su propio ID de post y estado de publicación. Usa el ID de post para Obtener Post; el ID de grupo no sustituye al de post.