Müşteriler

/api/v1/musteriler — PUT

PUT/api/v1/musteriler

Müşterileri toplu yaz

Müşteri kartlarını dis_id’ye göre yazar. Telefon şifreli saklanır. Kartlar, firma ayarındaki saklama süresi dolunca silinir.

• Kimlik doğrulama: Authorization: Bearer rz_live_…
• Kapsam: ingest:customers
• Paket özelliği: Veri API + Sepetler — kapalıysa uç 404 not_found döner
• Idempotency-Key: isteğe bağlı (tekrar denemeler için önerilir)

İstek gövdesi (application/json)

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

CustomerBatch

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

ApiCustomer

Alan	Tür	Sınır	Anlamı
dis_id *	string	min 1, max 200	Müşteri kimliği.
ad	string | null	max 200	Ad.
eposta	string | null	max 200	E-posta.
telefon	string | null	max 32	Telefon.
meta	object	varsayılan {}	Serbest ek bilgi.

Örnek

curl -s -X PUT "$RZ_API/api/v1/musteriler" -H "Authorization: Bearer $RZ_KEY" -H "Content-Type: application/json" \
  -d '{"items": [{"dis_id": "87", "ad": "Ayşe Yılmaz", "eposta": "[email protected]", "telefon": "05321234567",
                  "meta": {"segment": "kurumsal"}}]}'

Yanıt 200

{
  "inserted": 1,
  "updated": 0
}

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

---

/api/v1/musteriler/{dis_id} — DELETE

DELETE/api/v1/musteriler/{dis_id}

Müşteriyi sil

Müşteri kartını siler. Kayıt yoksa 404 not_found.

• Kimlik doğrulama: Authorization: Bearer rz_live_…
• Kapsam: ingest:customers
• Paket özelliği: Veri API + Sepetler — kapalıysa uç 404 not_found döner
• Idempotency-Key: isteğe bağlı (tekrar denemeler için önerilir)

Parametreler

Ad	Yer	Tür	Sınır	Anlamı
dis_id *	path	string		Sizin sisteminizdeki kimlik.

Örnek

curl -s -X DELETE "$RZ_API/api/v1/musteriler/87" -H "Authorization: Bearer $RZ_KEY"

Yanıt 200

{
  "deleted": 1
}

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