Buat ringkasan proyek

Buat ringkasan AI setelah mention tersedia, lalu ambil kembali ringkasan yang tersimpan.

Prasyarat

• Access token bearer
• ID kata kunci yang terkait dengan mention yang sudah dikumpulkan

Swagger menamai parameter path sebagai keywordID. Alur aplikasi saat ini menggunakan ID yang dikembalikan saat pembuatan proyek, tetapi kontraknya tidak mendokumentasikan pemetaan tersebut secara formal.

1. Buat ringkasan

Permintaan tidak memiliki body:

curl -X POST \
  "$SOCIOVITE_API_URL/api/project/generate-summary/keyword_id" \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer <access_token>'

Contoh respons 200 OK:

{
  "status": "success",
  "keyword_id": "keyword_id",
  "result": {
    "summary": "Summary of the collected mentions.",
    "metrics": {
      "sentiment_distribution": {
        "negative": 2,
        "neutral": 4,
        "positive": 8
      }
    }
  }
}

Distribusi yang dikembalikan di sini adalah objek dengan key berupa string dan value berupa jumlah bilangan bulat.

Error yang dideklarasikan:

Status	Arti
400	ID kata kunci tidak disertakan
500	Error server internal

2. Ambil ringkasan tersimpan

curl \
  "$SOCIOVITE_API_URL/api/project/summary/keyword_id" \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer <access_token>'

Contoh respons 200 OK:

{
  "id": "summary_id",
  "ai_summary": "Summary of the collected mentions.",
  "sentiment_distribution": "{\"neutral\":4,\"negative\":2,\"positive\":8}",
  "created_at": "2026-07-20T09:00:00Z",
  "keyword_id": "keyword_id"
}

Schema ringkasan tersimpan menetapkan sentiment_distribution sebagai string, bukan objek. Uraikan sebagai JSON hanya jika nilai runtime merupakan JSON terserialisasi yang valid.

Error yang dideklarasikan:

Status	Arti
400	ID kata kunci tidak disertakan
404	Ringkasan tersimpan tidak ditemukan
500	Error server internal

Endpoint mana yang perlu dipanggil?

Kebutuhan	Endpoint
Buat atau perbarui insight	POST /api/project/generate-summary/{keywordID}
Baca hasil tersimpan	GET /api/project/summary/{keywordID}

Lihat referensi lengkap ringkasan API Proyek.