Log & Monitoring Publikasi Sosial (GET /v1/projects/:id/posts)

Setiap postingan yang dikirim melalui POST /v1/posts, tool MCP kirem_distribute_content, atau n8n node akan diproses secara asynchronous di antrean background worker (Redis + Asynq). Anda dapat memantau status pengiriman, URL live post, dan pesan error jika terjadi kegagalan.

🔑 Endpoint & Autentikasi

• Endpoint: GET /v1/projects/:project_id/posts
• Base URL: https://engine.kirem.co (atau https://api.kirem.co)
• Headers:
  • Authorization: Bearer <API_KEY_OR_JWT>

📋 Parameter Query (Opsional)

📤 Contoh Response Sukses (HTTP 200 OK)

{
  "status": 200,
  "message": "post logs retrieved",
  "data": [
    {
      "id": "post_th_90125",
      "project_id": "proj_12345",
      "connection_id": "conn_threads_003",
      "platform": "threads",
      "content": "Kabar gembira! Fitur Omnichannel Kirem kini resmi mendukung Threads 🚀",
      "media_urls": [
        "https://kirem.co/assets/slide-1.jpg",
        "https://kirem.co/assets/slide-2.jpg"
      ],
      "status": "published",
      "external_post_id": "18029384910293",
      "permalink": "https://www.threads.net/@kirem.official/post/C9xyz...",
      "error_message": null,
      "created_at": "2026-09-08T14:30:00Z",
      "published_at": "2026-09-08T14:30:05Z"
    },
    {
      "id": "post_ig_90124",
      "project_id": "proj_12345",
      "connection_id": "conn_ig_002",
      "platform": "instagram",
      "content": "5 Tips Praktis Mengoptimalkan WhatsApp Business API 💡",
      "media_urls": [
        "https://kirem.co/assets/slide-1.jpg"
      ],
      "status": "published",
      "external_post_id": "1799201928374",
      "permalink": "https://www.instagram.com/p/C9abc...",
      "error_message": null,
      "created_at": "2026-09-08T14:30:00Z",
      "published_at": "2026-09-08T14:30:08Z"
    }
  ]
}

⚠️ Status Transaksi Postingan

• queued: Postingan berhasil masuk ke antrean worker Asynq.
• publishing: Worker sedang mengunggah kontainer media dan memproses penerbitan ke server Meta / LinkedIn.
• published: Postingan sukses terbit secara publik. Nilai external_post_id dan permalink terisi.
• failed: Pengiriman gagal (misal: token kedaluwarsa atau rasio aspek media tidak memenuhi standar Meta). Rincian kegagalan tercantum di error_message.