API Layanan AI

Layanan AI mengirimkan pekerjaan scraping untuk kata kunci suatu proyek.

Base path: /api/ai-service

Semua endpoint yang didokumentasikan memerlukan:

Authorization: Bearer <access_token>

Scraping kata kunci proyek

POST /api/ai-service/scrap-project-keywords

Kirim permintaan untuk melakukan scraping kata kunci suatu proyek di berbagai platform media sosial.

Autentikasi: Bearer token

Body permintaan: application/json

Field	Tipe	Wajib	Deskripsi
keyword_id	string	Ya	ID kata kunci; alur aplikasi saat ini menggunakan data.id proyek, tetapi Swagger tidak mendefinisikan pemetaan tersebut secara formal

{
  "keyword_id": "project_or_keyword_id"
}

Respons berhasil — 200 OK:

{
  "success": true,
  "result": {}
}

Respons yang dideklarasikan:

Status	Arti
200	Permintaan scraping berhasil
400	Body permintaan tidak valid atau parameter tidak lengkap
500	Pemrosesan gagal

curl -X POST \
  "$SOCIOVITE_API_URL/api/ai-service/scrap-project-keywords" \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer <access_token>' \
  -H 'Content-Type: application/json' \
  -d '{
    "keyword_id": "project_or_keyword_id"
  }'

Bentuk error

Error Layanan AI menggunakan format berikut:

{
  "success": false,
  "error": "Invalid request",
  "message": "keyword_id is required"
}

Endpoint ini dilindungi, meskipun tabel responsnya tidak mendeklarasikan respons 401 secara eksplisit.