Satış fırsatları

/api/v1/firsatlar — GET

GET/api/v1/firsatlar

Satış fırsatlarını listele

Asistanın görüşmede açtığı satış fırsatları (iletişim izni veren müşteriler), yeniden eskiye; sinif (sicak, ilik, soguk), durum ve since ile süzülür. Telefon, ad ve e-posta maskelidir; Veri API’de kişisel veriyi açtıysanız tam döner. CRM aktarımı için firsat.olusturuldu webhook’u ile birlikte kullanın.

• Kimlik doğrulama: Authorization: Bearer rz_live_…
• Kapsam: firsat:read
• Paket özelliği: Veri API + Satış fırsatları — kapalıysa uç 404 not_found döner

Parametreler

Ad	Yer	Tür	Sınır	Anlamı
durum	query	"yeni" | "iletisimde" | "teklif" | "kazanildi" | "kaybedildi" | null		Durum süzgeci: sepette ör. terk; fırsatta yeni, iletisimde, teklif, kazanildi, kaybedildi.
sinif	query	"sicak" | "ilik" | "soguk" | null		Fırsat sınıfı: sicak, ilik, soguk.
since	query	string (date-time) | null		Bu andan sonrası (ISO 8601).
cursor	query	string | null		Önceki yanıttaki next_cursor.
limit	query	integer	≥ 1, ≤ 100, varsayılan 50	Sayfa boyutu.

Örnek

curl -s "$RZ_API/api/v1/firsatlar?sinif=sicak&limit=50" -H "Authorization: Bearer $RZ_KEY"

Yanıt 200

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

---

/api/v1/firsatlar/{lead_id} — GET

GET/api/v1/firsatlar/{lead_id}

Satış fırsatı

Tek satış fırsatı; alanlar ve maskeleme listedeki gibidir. Deneme görüşmelerinden açılanlar 404 döner.

• Kimlik doğrulama: Authorization: Bearer rz_live_…
• Kapsam: firsat:read
• Paket özelliği: Veri API + Satış fırsatları — kapalıysa uç 404 not_found döner

Parametreler

Ad	Yer	Tür	Sınır	Anlamı
lead_id *	path	string (uuid)		Satış fırsatı kimliği (UUID).

Örnek

curl -s "$RZ_API/api/v1/firsatlar/0199…" -H "Authorization: Bearer $RZ_KEY"

Yanıt 200

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