Bilgi içeriği

/api/v1/kb/articles — PUT

PUT/api/v1/kb/articles

Bilgi içeriğini toplu yaz

SSS, iade, kargo gibi bilgi içeriğini yazar. HTML düz metne çevrilir; 1500 karakteri aşan içerik id-1, id-2… parçalarına bölünür. ek- önekli kimlikler konsoldan elle eklenen içeriğe ayrılmıştır: API’den yazılamaz ve tam senkronda korunur.

• Kimlik doğrulama: Authorization: Bearer rz_live_…
• Kapsam: ingest:kb
• Paket özelliği: yok (her pakette açık)
• Idempotency-Key: isteğe bağlı (tekrar denemeler için önerilir)

Parametreler

Ad	Yer	Tür	Sınır	Anlamı
full	query	boolean	varsayılan false	true: listede olmayan kayıtlar pasiflenir (ek- önekli elle eklenen bilgi satırları korunur). Tam liste tek istekte (≤1000) gönderilmeli.

İstek gövdesi (application/json)

• ile işaretli alanlar zorunludur. Bilinmeyen alan 422 ile reddedilir.

ArticleBatch

Alan	Tür	Sınır	Anlamı
items *	ApiArticle[]	en az 1, en çok 1000	1–1000 kayıt.

ApiArticle

Alan	Tür	Sınır	Anlamı
id *	string	min 1, max 200	Kalıcı kimlik (ek- öneki ayrılmış).
baslik *	string	min 1, max 500	Başlık ya da soru.
icerik *	string	min 1, max 100000	İçerik (HTML olabilir).
bolum	string | null	max 2000	Bölüm.
url	string | null	max 2000	Kaynak sayfa.

Örnek

curl -s -X PUT "$RZ_API/api/v1/kb/articles?full=true" \
  -H "Authorization: Bearer $RZ_KEY" -H "Content-Type: application/json" \
  -d '{"items": [{"id": "iade-kosullari", "baslik": "İade koşulları", "bolum": "Yardım",
                  "icerik": "Ürünü teslim aldıktan sonra 14 gün içinde iade edebilirsiniz.",
                  "url": "https://magaza.example.com/iade"}]}'

Yanıt 200

Şema: IngestResult

Alan	Tür	Sınır	Anlamı
dataset *	string
inserted *	integer
updated *	integer
unchanged *	integer
deactivated *	integer
skipped *	integer

{
  "dataset": "bilgi",
  "inserted": 1,
  "updated": 0,
  "unchanged": 0,
  "deactivated": 0,
  "skipped": 0
}

Hata durumları: 401, 403, 404, 413, 422, 429 — bkz. Hatalar ve sınırlar.