Fuarlar ve leadler

Lead girişi: firma sorgusu

Lead girerken: kayıtlı firma önerileri (q — Türkçe harf katlamalı; tam ad → başlangıç → kelime başı → içerir), bu fuarda aynı firma / telefon / e-postayla girilmiş leadler (dups) ve telefon / e-postanın CRM'deki karşılığı (hit = {contact, company}). Firma kartı: id, name, status_l, owner, city, sector, n_contacts, n_open (açık proje), here (bu fuardaki leadleri), prev (önceki fuarlar), initials.

GET/api/v1/fairs/{id}/lookup

Yetkilendirme

Authorizationheaderzorunlu

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

Modül: Fuar leadleriKapsam: crm.read

Yol parametreleri

idintegerzorunlu

Fuar kimliği.

Sorgu parametreleri

qstringisteğe bağlı

Firma adı (en az 2 harf).

companystringisteğe bağlı

Mükerrer araması için firma adı (yoksa q).

phonestringisteğe bağlı

Telefon (en az 7 hane).

emailstringisteğe bağlı

E-posta.

lidintegeristeğe bağlı

Düzenlenen lead (mükerrerde kendisi sayılmaz).

Hatalar

HTTP	error	Anlamı
`404`	`not_found`	Kayıt bulunamadı.
`403`	`module`	Modül lisansta ya da kullanıcının izinlerinde kapalı.

İstek

curl "https://ornek.solk.app/api/v1/fairs/1/lookup?q=Alize%20&company=Alize%20Paketleme%20San.%20ve%20Tic.%20A.%C5%9E." \
  -H "Authorization: Bearer $SOLK_API_KEY"

const res = await fetch("https://ornek.solk.app/api/v1/fairs/1/lookup?q=Alize%20&company=Alize%20Paketleme%20San.%20ve%20Tic.%20A.%C5%9E.", {
  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/fairs/1/lookup",
    headers={"Authorization": f"Bearer {os.environ['SOLK_API_KEY']}"},
    params={"q": "Alize ", "company": "Alize Paketleme San. ve Tic. A.Ş."},
)
print(r.json())

Yanıt

{
  "companies": [
    {
      "city": "İstanbul",
      "here": [],
      "id": 1,
      "initials": "AŞ",
      "n_contacts": 1,
      "n_open": 1,
      "name": "Alize Paketleme San. ve Tic. A.Ş.",
      "owner": "Deniz Aksoy",
      "prev": [],
      "sector": "Gıda ambalajı",
      "status": "AC",
      "status_l": "Müşteri",
      "url": "/customers/1",
      "website": "www.alizepaketleme.example"
    }
  ],
  "dups": [],
  "hit": null,
  "ok": true
}

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