Manajemen Koneksi Kanal Sosial (/v1/projects/:id/connections)

Setiap kanal sosial (Facebook Page, Instagram Business, LinkedIn Profile/Page, Threads Account) didaftarkan sebagai sebuah record Connection di dalam proyek Anda. Token akses setiap koneksi dilindungi oleh enkripsi AES-256-GCM.

📋 Daftar Endpoint Koneksi

1. Mengambil Daftar Koneksi (GET)

Gunakan endpoint ini untuk memeriksa platform apa saja yang sedang aktif dan siap menerima publikasi postingan.

Request:

GET https://api.kirem.co/v1/projects/proj_12345/connections HTTP/1.1
Authorization: Bearer kd_live_your_api_key

Response (200 OK):

{
  "status": 200,
  "message": "connections retrieved",
  "data": [
    {
      "id": "conn_fb_001",
      "project_id": "proj_12345",
      "platform": "facebook",
      "name": "PT Kirem Solusi Digital (Facebook Page)",
      "external_id": "104928374829102",
      "status": "active",
      "created_at": "2026-08-17T10:00:00Z"
    },
    {
      "id": "conn_ig_002",
      "project_id": "proj_12345",
      "platform": "instagram",
      "name": "@kirem.official (Instagram Business)",
      "external_id": "178414053092019",
      "status": "active",
      "created_at": "2026-08-17T10:05:00Z"
    },
    {
      "id": "conn_threads_003",
      "project_id": "proj_12345",
      "platform": "threads",
      "name": "@kirem.official (Threads)",
      "external_id": "9812739182371",
      "status": "active",
      "created_at": "2026-08-20T14:30:00Z"
    },
    {
      "id": "conn_li_004",
      "project_id": "proj_12345",
      "platform": "linkedin",
      "name": "Kirem Dev Platform (LinkedIn Page)",
      "external_id": "urn:li:organization:9981273",
      "status": "active",
      "created_at": "2026-08-17T10:10:00Z"
    }
  ]
}

2. Menghubungkan Kanal Baru (POST)

Selain menggunakan tombol OAuth 1-Klik di Dasbor Pengaturan Kirem, developer dapat mendaftarkan kredensial token akun secara terprogram:

Request:

POST https://api.kirem.co/v1/projects/proj_12345/connections HTTP/1.1
Authorization: Bearer kd_live_your_api_key
Content-Type: application/json

{
  "platform": "threads",
  "name": "@kirem.official",
  "external_id": "9812739182371",
  "access_token": "TH_TOKEN_EAAB..."
}

Nilai Platform yang Valid:

• facebook — Facebook Business Page
• instagram — Instagram Business Account
• linkedin — Akun Pribadi atau Halaman Organisasi LinkedIn
• threads — Akun Resmi Threads
• whatsapp — Kanal / Saluran Resmi WhatsApp

3. Memutuskan / Menghapus Koneksi (DELETE)

Untuk mencabut integrasi kanal tertentu:

Request:

DELETE https://api.kirem.co/v1/projects/proj_12345/connections/conn_threads_003 HTTP/1.1
Authorization: Bearer kd_live_your_api_key

Response (200 OK):

{
  "status": 200,
  "message": "connection disconnected successfully"
}