Ana içeriğe atla
POST
/
user
/
knowledgebases
/
{knowledgebaseId}
/
documents
Belge oluştur
curl --request POST \
  --url https://app.whattalk.ai/api/user/knowledgebases/{knowledgebaseId}/documents \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "description": "<string>",
  "type": "<string>",
  "url": "<string>",
  "links": [
    {
      "link": "<string>"
    }
  ],
  "relative_links_limit": 123
}
'
{
  "message": "Document created successfully. Processing will begin shortly.",
  "data": {
    "id": 1,
    "name": "Company Website",
    "description": "Main website content",
    "type": "website",
    "type_label": "Website",
    "status": "processing",
    "status_label": "Processing",
    "created_at": "2025-01-08T10:30:00.000000Z"
  }
}
Bu endpoint, bir bilgi bankasında yeni belge oluşturur. Belgeler eşzamansız olarak işlenir - endpoint hemen yanıt dönerken işleme arka planda devam eder.

​
Yol Parametreleri

​
knowledgebaseId
integer
gerekli
Bilgi bankasının benzersiz tanımlayıcısı

​
İstek Gövdesi

​
name
string
gerekli
Belgenin adı (maksimum 255 karakter)
​
description
string
Belgenin isteğe bağlı açıklaması (maksimum 255 karakter)
​
type
string
gerekli
Belge türü: website, pdf, txt veya docx

​
Web Sitesi Belgeleri

​
url
string
Taranacak ana URL. links sağlanmadıysa zorunludur.
​
links
array
Taranacak belirli URL’lerin dizisi. url sağlanmadıysa zorunludur.
​
relative_links_limit
integer
varsayılan:"10"
Tarama sırasında takip edilecek maksimum bağıl bağlantı sayısı (1-50)

​
Dosya Belgeleri (PDF, TXT, DOCX)

​
file
file
gerekli
Yüklenecek dosya (maksimum 20MB). multipart/form-data kodlaması kullanın.

​
Yanıt

​
message
string
Başarı mesajı
​
data
object
Oluşturulan belge nesnesi
{
  "message": "Document created successfully. Processing will begin shortly.",
  "data": {
    "id": 1,
    "name": "Company Website",
    "description": "Main website content",
    "type": "website",
    "type_label": "Website",
    "status": "processing",
    "status_label": "Processing",
    "created_at": "2025-01-08T10:30:00.000000Z"
  }
}

​
Belge Türleri

TürAçıklamaGirdi
websiteWeb sayfalarını tarar ve metin içeriğini çıkarırURL veya URL listesi
pdfPDF dosyalarından metin çıkarırPDF dosya yüklemesi
txtDüz metin içeriğiTXT dosya yüklemesi
docxWord belgelerinden metin çıkarırDOCX dosya yüklemesi

​
Örnek: Web Sitesi Belgesi Oluşturma

curl -X POST https://app.whattalk.ai/api/user/knowledgebases/1/documents \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Company Website",
    "description": "Main website content",
    "type": "website",
    "url": "https://example.com",
    "relative_links_limit": 20
  }'

​
Örnek: PDF Belgesi Yükleme

curl -X POST https://app.whattalk.ai/api/user/knowledgebases/1/documents \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "name=Product Manual" \
  -F "description=User guide for our product" \
  -F "type=pdf" \
  -F "file=@/path/to/document.pdf"
Belge işleme eşzamansızdır. İşlemenin tamamlanıp tamamlanmadığını kontrol etmek için belge getir endpoint’ini sorgulayın.