Görüşmeler
Ziyaretler
Ziyaret / görüşme listesi (gün, sonra kayıt anı, yeni önce). Satır: ziyaret alanları + geo (konum özeti — yalnız ziyareti girene ve yöneticiye; diğerlerine null): st (ok firmada · far uzakta · set firma konumu bu ziyaretle kaydedildi · low belirsiz · none konumsuz), label, short, dist (m), in_time, out_time, duration (dk), acc, in / out / firm ([enlem, boylam]), note, src (app · web · claude); ayrıca time (giriş saati, görme hakkı varsa), user_id, customer_status, customer_city, can_edit, url. Yanıt: rows, total, page, pages, has_next, stats (n, f2f, onsite, located, ok, located_pct, ok_pct, pending), scope, range, date_from, date_to, ranges, team (ekip kapsamı kullanılabilir mi), geo_mode, radius.
Yetkilendirme
AuthorizationheaderzorunluBearer belirteci: API anahtarı (sk_…), OAuth erişim belirteci (mcp_…) ya da mobil oturum (xk_…).
Modül: Ziyaretler / AktivitelerKapsam:
crm.readSorgu parametreleri
scopestringisteğe bağlımine benim (satışçı varsayılanı), team görebildiğim ekip (yönetici varsayılanı).Değerler
mineteamrangestringisteğe bağlıvarsayılan: 30Dönem.
Değerler
todayweekmonth3090alldate_from / date_tostringisteğe bağlıTarih aralığı (YYYY-MM-DD) — dönemi geçersiz kılar.
typestringisteğe bağlıGörüşme türü.
Değerler
F2FOnlineCallDenemeownerintegeristeğe bağlıSatışçı (ekip kapsamında).
customer_idintegeristeğe bağlıYalnız bu firma (dönem varsayılanı
all).qstringisteğe bağlıFirma, not, sonuç ya da konu içinde ara.
pendingbooleanisteğe bağlıYalnız sonraki aksiyonu açık olanlar.
geostringisteğe bağlınone konumsuz yerinde ziyaretler, far firmadan uzakta (satışçı yalnız kendininkiler).Değerler
nonefarpageintegeristeğe bağlıvarsayılan: 1Sayfa.
per_pageintegeristeğe bağlıvarsayılan: 40Sayfa başına (10–100).
İstek
curl https://ornek.solk.app/api/v1/visits \
-H "Authorization: Bearer $SOLK_API_KEY"const res = await fetch("https://ornek.solk.app/api/v1/visits", {
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/visits",
headers={"Authorization": f"Bearer {os.environ['SOLK_API_KEY']}"},
)
print(r.json())Yanıt