Tentukan kata kunci proyek

API Sociovite yang dipublikasikan tidak menyediakan endpoint terpisah untuk membuat kata kunci. Kata kunci disertakan sebagai string keyword saat Anda memanggil POST /api/project.

Aturan kontrak

Swagger hanya mendefinisikan batasan berikut:

Aturan	Nilai
Tipe	string
Wajib	Ya
Panjang minimum	2 karakter
Panjang maksimum	255 karakter

Contoh minimal:

{
  "keyword": "acme"
}

Nilai di atas adalah salah satu field dalam permintaan pembuatan proyek yang lengkap, bukan payload mandiri.

Group, keyword, dan exclude

Field berikut memiliki peran yang berbeda dalam permintaan proyek:

Field	Arti dalam kontrak	Batasan
group	Nama proyek/grup	2–100 karakter
keyword	String kata kunci pemantauan	2–255 karakter
exclude	String pengecualian opsional	Hingga 1.000 karakter

Contoh:

{
  "group": "Acme July Monitoring",
  "keyword": "acme",
  "exclude": "acme university"
}

Sintaks kueri tidak didefinisikan

Kontrak Swagger tidak menjelaskan apakah backend mendukung:

• Operator Boolean seperti AND atau OR;
• frasa dalam tanda kutip;
• beberapa kata kunci dalam satu string;
• pencocokan tanpa membedakan huruf besar dan kecil;
• karakter escape atau karakter khusus.

Perlakukan keyword sebagai string opak kecuali tim backend memublikasikan tata bahasa kueri. Jangan membuat ekspresi kompleks hanya berdasarkan contoh dari dokumentasi lama.

Validasi hasil

Setelah proyek dibuat:

1. Konfirmasikan bahwa respons mengembalikan data.keyword yang diharapkan.
2. Mulai scraping dengan POST /api/ai-service/scrap-project-keywords.
3. Panggil GET /api/mentions dengan ID kata kunci yang sesuai.
4. Ubah kata kunci hanya melalui alur kerja backend yang terdokumentasi; Swagger yang diberikan tidak mendefinisikan endpoint umum untuk memperbarui proyek atau kata kunci.

Lanjutkan ke Kumpulkan dan baca mention.