Buat proyek

Panduan ini menjelaskan cara membuat proyek pemantauan dan menyimpan ID yang diperlukan pada langkah berikutnya.

Prasyarat

• Akun Sociovite dengan username dan password yang valid

1. Masuk

curl -X POST \
  "$SOCIOVITE_API_URL/api/auth/login" \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "username": "your_username",
    "password": "your_password"
  }'

Respons 200 berisi token pada bagian teratas:

{
  "token": "eyJhbGciOi...",
  "expires_at": "2026-07-29T23:26:03.041292+07:00",
  "roles": [
    "user"
  ],
  "user": {
    "id": "user_id",
    "userId": "user_id",
    "name": "Example User",
    "email": "user@example.com",
    "username": "your_username"
  }
}

Gunakan nilai tersebut sebagai <access_token> pada permintaan berikutnya. Lihat referensi login untuk detail error dan field respons.

2. Siapkan proyek

Semua field berikut wajib diisi:

Field	Kegunaan
group	Nama proyek yang mudah dikenali
keyword	Kata kunci yang akan dipantau
categoryId	Kategori proyek
startDate	Awal periode pengumpulan
endDate	Akhir periode pengumpulan
type	manual atau auto

exclude bersifat opsional.

Format penulisan keyword

Field keyword dapat menggunakan operator and dan or. Contoh format yang dapat digunakan:

• kopi and kapal api
• kopi or kapal api
• kopi and kapal api or kopi kapal api

Pertahankan penulisan operator sesuai contoh agar ekspresi keyword dapat diproses dengan benar.

Contoh ini menggunakan format tanggal YYYY-MM-DD, tetapi Swagger tidak menetapkan format tanggal secara eksplisit. Konfirmasikan format yang diterima oleh lingkungan yang digunakan.

3. Buat proyek

curl -X POST \
  "$SOCIOVITE_API_URL/api/project" \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer <access_token>' \
  -H 'Content-Type: application/json' \
  -d '{
    "categoryId": "umum",
    "endDate": "2026-07-31",
    "exclude": "acme university",
    "group": "Acme July Monitoring",
    "keyword": "acme",
    "startDate": "2026-07-01",
    "type": "manual"
  }'

Jika berhasil, API mengembalikan status 201 Created:

{
  "message": "Group successfully added",
  "data": {
    "id": "project_id",
    "group": "Acme July Monitoring",
    "keyword": "acme",
    "exclude": "acme university",
    "islisten": 0,
    "updatedAt": "2026-07-20T08:35:00Z",
    "categoryid": "umum",
    "start_date": "2026-07-01",
    "end_date": "2026-07-31",
    "type": "manual"
  }
}

Simpan data.id.

Terminologi identifier

Swagger menyebut nilai ini sebagai ID proyek pada operasi pengelolaan proyek, tetapi menggunakan nama ID kata kunci pada operasi scraping, mention, dan ringkasan. Panduan ini mengikuti asumsi alur aplikasi saat ini bahwa data.id adalah nilai yang diteruskan ke operasi tersebut. Konfirmasikan pemetaannya jika backend yang digunakan mengembalikan ID kata kunci terpisah.

Langkah berikutnya

1. Tinjau cara field keyword direpresentasikan.
2. Mulai pengumpulan dan baca mention.
3. Lihat setiap field dan kategori dalam referensi POST /api/project.

Pemecahan masalah

Gejala	Hal yang perlu diperiksa
400 Bad Request	Sertakan keenam field wajib dan gunakan manual atau auto untuk type.
401 Unauthorized	Kirim token dari login sebagai Authorization: Bearer <access_token>.
Tanggal ditolak	Swagger menetapkan tipe tanggal sebagai string, tetapi tidak mendefinisikan format wajib; konfirmasikan ketentuan backend.