Buton token’ı

/api/v1/buton-token — POST

POST/api/v1/buton-token

Buton token’ı üret

Sunucunuzdan, gizli anahtarla çağrılır. tetikleyen sayfayı açan kendi kullanıcınızdır; hedef aranacak sepet (sepet_id), sipariş (siparis_no) ya da müşteri telefonudur (musteri_telefon; token’a yalnız özeti girer) — tam olarak biri. Token en çok 15 dakika geçerlidir (varsayılan 600 sn), tek bir arama isteği içindir ve sayfaya data-token olarak basılır.

• Kimlik doğrulama: Authorization: Bearer rz_live_…
• Kapsam: calls:write
• Paket özelliği: Asistan arasın butonu — 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.

ButtonTokenIn

Alan	Tür	Sınır	Anlamı
tetikleyen *	TriggererIn		Sayfayı açan kendi kullanıcınız.
hedef *	ButtonTarget		Aranacak hedef (tam olarak biri).
gecerlilik_sn	integer	≥ 60, ≤ 900, varsayılan 600	Geçerlilik (sn).

TriggererIn

Alan	Tür	Sınır	Anlamı
ad *	string	min 1, max 120	Ad.
eposta	string | null	max 200	E-posta.

ButtonTarget

Alan	Tür	Sınır	Anlamı
sepet_id	string | null	min 1, max 200	Sepet dis_id.
siparis_no	string | null	min 1, max 64	Sipariş numarası.
musteri_telefon	string | null	min 10, max 32	Müşteri telefonu (yalnız özeti saklanır).

Örnek

curl -s -X POST "$RZ_API/api/v1/buton-token" -H "Authorization: Bearer $RZ_KEY" -H "Content-Type: application/json" \
  -d '{"tetikleyen": {"ad": "Can Demir", "eposta": "[email protected]"},
       "hedef": {"sepet_id": "sepet-7f3a9c"}, "gecerlilik_sn": 600}'

Yanıt 200

{
  "token": "eyJ2Ijox…",
  "son_gecerlilik": "2026-09-27T10:25:00Z"
}

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