Web sohbet müşteri token’ı
/api/v1/sohbet-token — POST
Bölüm başlığı “/api/v1/sohbet-token — POST”POST/api/v1/sohbet-token
Web sohbet müşteri token’ı üret
Sunucunuzdan, gizli anahtarla çağrılır: sitenizde giriş yapmış müşteri için kısa ömürlü (en çok 15 dakika), tek kullanımlık, şifreli token üretir. Sayfaya data-musteri-token olarak basılır; sohbet penceresi bu token’la açılırsa müşterinin numarası doğrulanmış sayılır ve kendi siparişleri konuşulabilir. Token’ı yalnız oturumu açık müşterinin kendi numarasıyla üretin.
- Kimlik doğrulama:
Authorization: Bearer rz_live_… - Kapsam:
sohbet:write - Paket özelliği: Web sohbet — kapalıysa uç 404
not_founddöner - Idempotency-Key: isteğe bağlı (tekrar denemeler için önerilir)
İstek gövdesi (application/json)
Bölüm başlığı “İstek gövdesi (application/json)”- ile işaretli alanlar zorunludur. Bilinmeyen alan 422 ile reddedilir.
CustomerTokenIn
| Alan | Tür | Sınır | Anlamı |
|---|---|---|---|
musteri * | zitena_api__routes_sohbet__CustomerIn | ||
gecerlilik_sn | integer | ≥ 60, ≤ 900, varsayılan 600 |
zitena_api__routes_sohbet__CustomerIn
| Alan | Tür | Sınır | Anlamı |
|---|---|---|---|
telefon * | string | min 10, max 32 | |
ad | string | null | max 80 |
curl -s -X POST "$RZ_API/api/v1/sohbet-token" -H "Authorization: Bearer $RZ_KEY" -H "Content-Type: application/json" \ -d '{"musteri": {"telefon": "+905321234567", "ad": "Can Demir"}, "gecerlilik_sn": 600}'Yanıt 200
Bölüm başlığı “Yanıt 200”{ "token": "eyJ2Ijox…", "son_gecerlilik": "2026-10-26T10:25:00Z"}Hata durumları: 401, 403, 404, 413, 422, 429 — bkz. Hatalar ve sınırlar.
© 2026 Erusoft