Çalışma alanı

Ara

Firma (ad, şehir), kişi (ad, telefon, e-posta), fırsat ve fuar leadlerinde arar; her türden en çok 10–15 sonuç. 15 karakterlik bir kayıt kimliği (001…, 006…) verilirse record alanında o kayıt döner.

GET/api/v1/search

Yetkilendirme

Authorizationheaderzorunlu
Bearer belirteci: API anahtarı (sk_…), OAuth erişim belirteci (mcp_…) ya da mobil oturum (xk_…).
Kapsam: crm.read

Sorgu parametreleri

qstringzorunlu
Aranan metin (en az 2 karakter).
İstek
curl "https://ornek.solk.app/api/v1/search?q=Alize" \
  -H "Authorization: Bearer $SOLK_API_KEY"
Yanıt
{
  "contacts": [
    {
      "customer": "Alize Paketleme San. ve Tic. A.Ş.",
      "customer_id": 1,
      "department": "Satın Alma",
      "email": "selin.dogan@alizepaketleme.example",
      "id": 1,
      "is_former": false,
      "is_main": true,
      "name": "Selin Doğan",
      "note": "",
      "phone": "0 (212) 000 55 24",
      "rid": "003axHLVxmQvHIP",
      "title": "Satın Alma Müdürü",
      "wa": "902120005524"
    }
  ],
  "customers": [
    {
      "active": true,
      "at_risk": false,
      "city": "İstanbul",
      "currency": "EUR",
      "currency_default": "",
      "id": 1,
      "initials": "AP",
      "last_visit": "2026-10-04",
      "main_contact": {
        "email": "selin.dogan@alizepaketleme.example",
        "name": "Selin Doğan",
        "phone": "0 (212) 000 55 24",
        "wa": "902120005524"
      },
      "name": "Alize Paketleme San. ve Tic. A.Ş.",
      "next_visit_due": "2027-01-02",
      "open_opps": 1,
      "owner": {
        "color": "#5867e8",
        "full_name": "Deniz Aksoy",
        "id": 1,
        "photo": null,
        "role": "admin",
        "role_label": "Yönetici",
        "username": "admin"
      },
      "pending_state": "open",
      "period": 90,
      "phone": "0 (212) 000 15 65",
      "potential_kg": 8000.0,
      "rid": "001ORO926mXCqn8",
      "sector": "Gıda ambalajı",
      "status": "AC",
      "status_label": "Aktif Müşteri",
      "unit": "kg",
      "visit_overdue_days": -79,
      "visit_state": "ok"
    }
  ],
  "leads": [],
  "ok": true,
  "opps": [
    {
      "bant": 0,
      "base_currency": "EUR",
      "close_date": "2027-04-12",
      "cur_sym": "€",
      "currency": "EUR",
      "customer": "Alize Paketleme San. ve Tic. A.Ş.",
      "customer_city": "İstanbul",
      "customer_id": 1,
      "days_in_stage": 1,
      "detail_status": "",
      "fc": "Omitted",
      "health": null,
      "health_color": null,
      "health_manual": false,
      "health_note": "",
      "id": 44,
      "initials": "AP",
      "is_account": true,
      "is_open": false,
      "last_update": "2026-10-15",
      "lifetime_left": 179,
      "line": "",
      "name": "Müşteri Takibi",
      "next_step": null,
      "offer_price": null,
      "owner": {
        "color": "#5867e8",
        "full_name": "Deniz Aksoy",
        "id": 1,
        "photo": null,
        "role": "admin",
        "role_label": "Yönetici",
        "username": "admin"
      },
      "payment_days": null,
      "potential_kg": null,
      "prob": 0.0,
      "probability": null,
      "product": "",
      "product_id": null,
      "pu": "€/kg",
      "rid": "006l87fvwUhNwPa",
      "sla_days": null,
      "sla_left": null,
      "source": "",
      "stage": "Account",
      "stage_label": "Müşteri Takibi",
      "start_date": "2026-10-14",
      "trend": "",
      "trend_label": "Otomatik",
      "type": "Müşteri Takibi",
      "unit": "kg",
      "unit_code": "kg",
      "value": 0,
      "value_base": 0,
      "value_short": "0"
    },
    {
      "bant": 4,
      "base_currency": "EUR",
      "close_date": "2026-10-13",
      "cur_sym": "€",
      "currency": "EUR",
      "customer": "Alize Paketleme San. ve Tic. A.Ş.",
      "customer_city": "İstanbul",
      "customer_id": 1,
      "days_in_stage": 2,
      "detail_status": "",
      "fc": "Closed",
      "health": null,
      "health_color": null,
      "health_manual": false,
      "health_note": "",
      "id": 1,
      "initials": "AP",
      "is_account": false,
      "is_open": false,
      "last_update": "2026-10-13",
      "lifetime_left": 114,
      "line": "",
      "name": "Yeni Müşteri · 2026",
      "next_step": null,
      "offer_price": 3.92,
      "owner": {
        "color": "#5867e8",
        "full_name": "Deniz Aksoy",
        "id": 1,
        "photo": null,
        "role": "admin",
        "role_label": "Yönetici",
        "username": "admin"
      },
      "payment_days": 120,
      "potential_kg": 1500.0,
      "prob": 1.0,
      "probability": null,
      "product": "PU-SL 200 Solventsiz Laminasyon Yapıştırıcısı",
      "product_id": 1,
      "pu": "€/kg",
      "rid": "006uqgmsVMQL2gn",
      "sla_days": null,
      "sla_left": null,
      "source": "Bayi / distribütör",
      "stage": "Win",
      "stage_label": "Win",
      "start_date": "2026-08-10",
      "trend": "",
      "trend_label": "Otomatik",
      "type": "Yeni Müşteri",
      "unit": "kg",
      "unit_code": "kg",
      "value": 70560.0,
      "value_base": 70560.0,
      "value_short": "71K"
    }
  ],
  "record": null
}

Örnek yanıt örnek veriyle çalışan bir v98 kurulumundan alındı; listeler en çok iki öğeyle kısaltıldı.