Fırsatlar
Fırsatı getir
Fırsatın tamamı: aşama, değer, olasılık, sağlık, kontrol listesi adımları, BANT, aşama kapısı sorunları (gate_problems), ziyaretler, denemeler, teklifler, siparişler, görevler, aşama geçmişi, notlar ve e-posta yazışmaları.
Yetkilendirme
AuthorizationheaderzorunluBearer belirteci: API anahtarı (sk_…), OAuth erişim belirteci (mcp_…) ya da mobil oturum (xk_…).
Modül: FırsatlarKapsam:
crm.readYol parametreleri
idintegerzorunluFırsat kimliği.
Hatalar
| HTTP | error | Anlamı |
|---|---|---|
404 | not_found | Kayıt bulunamadı. |
İstek
curl https://ornek.solk.app/api/v1/opportunities/31 \
-H "Authorization: Bearer $SOLK_API_KEY"const res = await fetch("https://ornek.solk.app/api/v1/opportunities/31", {
headers: {
Authorization: `Bearer ${process.env.SOLK_API_KEY}`,
},
});
const data = await res.json();import os, requests
r = requests.get(
"https://ornek.solk.app/api/v1/opportunities/31",
headers={"Authorization": f"Bearer {os.environ['SOLK_API_KEY']}"},
)
print(r.json())Yanıt
{
"ok": true,
"opp": {
"bant": 1,
"bant_a": true,
"bant_b": false,
"bant_n": false,
"bant_t": false,
"base_currency": "EUR",
"can_edit": true,
"can_revive": false,
"close_category": "",
"close_date": "2027-02-18",
"close_reason": "",
"closed_at": null,
"competitor": "Distribütör ürünü",
"cur_sym": "€",
"currency": "EUR",
"custom_fields": [
{
"key": "rakip_fiyat",
"label": "Rakip fiyatı",
"type": "currency",
"value": null
}
],
"customer": "Alize Paketleme San. ve Tic. A.Ş.",
"customer_city": "İstanbul",
"customer_id": 1,
"days_in_stage": 11,
"demos": [],
"detail_status": "",
"fc": "Pipeline",
"gate_ok": false,
"gate_problems": [
"BANT kriterleri 4/4 sağlanmalı (Budget · Authority · Need · Time)"
],
"gate_warnings": [],
"guide": "BANT 4/4",
"health": {
"grade": "success",
"label": "sağlıklı",
"score": 92
},
"health_color": "g",
"health_manual": false,
"health_note": "",
"health_why": [
[
"−8"
]
],
"id": 31,
"initials": "AP",
"is_account": false,
"is_open": true,
"last_update": "2026-10-12",
"lifetime_left": 169,
"line": "",
"logs": [
{
"date": "2026-10-04T08:00:00",
"from": null,
"note": "Proje açıldı",
"to": "Qualify",
"user": "Deniz Aksoy"
}
],
"name": "Mevcut Müşteri — Yenileme · 2026",
"next_stage": "Viable",
"next_step": "İhtiyaç, hat ve aylık miktar potansiyelini netleştir (Need)",
"note": "Hat hızı 300 m/dk'ya çıkacak; viskozite penceresi önemli.",
"notes": [],
"offer_price": null,
"offers": [],
"orders": [],
"owner": {
"color": "#5867e8",
"full_name": "Deniz Aksoy",
"id": 1,
"photo": null,
"role": "admin",
"role_label": "Yönetici",
"username": "admin"
},
"payment_days": null,
"potential_kg": 6000.0,
"prob": 0.1,
"probability": null,
"product": "PU-SL 200 Solventsiz Laminasyon Yapıştırıcısı",
"product_id": 1,
"pu": "€/kg",
"rid": "006aTpWeStFXTOI",
"sla_days": 30,
"sla_left": 19,
"source": "Bayi / distribütör",
"stage": "Qualify",
"stage_label": "Qualify",
"start_date": "2026-10-04",
"steps": [
{
"assignee": {
"color": "#5867e8",
"full_name": "Deniz Aksoy",
"id": 1,
"photo": null,
"role": "admin",
"role_label": "Yönetici",
"username": "admin"
},
"auto": true,
"done": true,
"due_date": null,
"id": 376,
"note": "otomatik: BANT kutusu",
"stage": "Qualify",
"state": "done",
"title": "Karar verici / yetkili kişiyi belirle (Authority)"
}
],
"tags": [],
"tasks": [],
"threads": [
{
"category": "musteri",
"category_color": "#2a78d6",
"category_label": "Müşteri yazışması",
"category_source": "rule",
"customer": "Alize Paketleme San. ve Tic. A.Ş.",
"customer_id": 1,
"id": 1,
"last_at": "2026-10-15T06:02:00",
"last_dir": "in",
"n": 2,
"opp": "Mevcut Müşteri — Yenileme · 2026",
"opp_how": "single",
"opp_id": 31,
"opp_note": "firmanın tek açık projesi",
"peer": "Selin Doğan",
"subject": "Tanışma görüşmesi ve teknik föyler",
"suggested": false,
"waiting": true
}
],
"threads_n": 2,
"trend": "",
"trend_label": "Otomatik",
"type": "Mevcut Müşteri — Yenileme",
"unit": "kg",
"unit_code": "kg",
"value": 302000.0,
"value_base": 302000.0,
"value_short": "302K",
"visits": [
{
"action_date": "2026-10-30",
"action_done": false,
"action_state": "open",
"contact": "Selin Doğan",
"customer": "Alize Paketleme San. ve Tic. A.Ş.",
"customer_id": 1,
"date": "2026-10-04",
"id": 73,
"line": "",
"next_action": "Ziyaret Planla",
"note": "Aylık tüketim ve stok seviyesi konuşuldu; sipariş tahmini alındı.",
"opp": "Mevcut Müşteri — Yenileme · 2026",
"opp_id": 31,
"product": "",
"result": "Bütçe onayı bekleniyor",
"rid": "00UuPRn6Jj1l9UU",
"topic": "Tanışma",
"type": "Call",
"user": "Deniz Aksoy"
}
],
"weighted": 30200.0
}
}Örnek yanıt örnek veriyle çalışan bir v98 kurulumundan alındı; listeler en çok iki öğeyle kısaltıldı.