Aksita.ai Logo Dokumentasi

API Sinkronisasi KB URL

Sinkronkan konten website secara otomatis ke knowledge base agent Anda. API ini membuat atau mengupdate entri KB, sempurna untuk webhook CMS, update terjadwal, dan pipeline CI/CD.

HTTP Request
POST /api/kb/url

Fitur Utama

Upsert Otomatis

Otomatis membuat atau mengupdate entri KB. Tanpa duplikat.

Tanpa Downtime

Konten lama tetap aktif saat konten baru diproses.

URL Unik

Setiap agent hanya bisa memiliki satu resource per URL.

Header Request

HeaderWajibDeskripsi
Content-TypeRequiredapplication/json
X-API-KeyRequiredAPI key agent Anda

Parameter Request

ParameterTipeWajibDeskripsi
urlstringRequiredURL lengkap yang akan di-scrape dan disinkronkan
namestringOptionalNama custom (auto-generate dari judul halaman jika kosong)
URL Unik Per Agent

Setiap agent hanya bisa memiliki SATU resource per URL. Jika Anda mensinkronkan URL yang sama lagi, sistem akan MENGUPDATE resource yang sudah ada daripada membuat yang baru. Ini memastikan tidak ada URL duplikat di knowledge base Anda.

Contoh Request

curl -X POST https://api.aksita.ai/api/kb/url \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "url": "https://example.com/pricing",
    "name": "Pricing Information"
  }'

Response Sukses

200 OK
{
  "status": true,
  "data": {
    "resource": {
      "id": 123,
      "name": "Pricing Information",
      "url": "https://example.com/pricing",
      "status": "training",
      "credits": 4,
      "remaining_credits": 1111,
      "created_at": "2026-01-22T10:30:00Z"
    }
  },
  "detail": "URL dalam antrian untuk diproses"
}

Status Pemrosesan

Status resource awalnya akan "training". Akan berubah menjadi "completed" setelah URL di-scrape, diproses, dan ditambahkan ke knowledge base. Biasanya memakan waktu 10-60 detik tergantung ukuran halaman.

Response Error

URL hilang atau kosong

400 Bad Request
{
  "status": false,
  "reason": "url wajib diisi"
}

Format URL tidak valid

400 Bad Request
{
  "status": false,
  "reason": "format URL tidak valid"
}

API key tidak valid atau hilang

401 Unauthorized
{
  "status": false,
  "reason": "API key tidak valid"
}

Kredit tidak cukup

402 Payment Required
{
  "status": false,
  "reason": "Kredit tidak cukup"
}

Kasus Penggunaan Umum

Webhook CMS

Picu sinkronisasi KB otomatis saat konten dipublikasikan di WordPress, Strapi, atau CMS apa pun dengan dukungan webhook.

Update Terjadwal

Gunakan cron job atau scheduled task untuk mensinkronkan KB setiap hari, menjaga agent Anda tetap update dengan konten website terbaru.

Pipeline CI/CD

Integrasikan sinkronisasi KB ke pipeline deployment Anda untuk mengupdate knowledge base otomatis setelah deployment website.

Update Massal

Loop melalui banyak URL untuk mensinkronkan seluruh bagian website dalam satu batch, sempurna untuk setup awal atau update besar.