Kişileri listele

Aktif firmaların kişileri (en çok 300, ada göre). Ayrılmış kişiler varsayılan olarak gelmez.

GET/api/v1/contacts

Yetkilendirme

Authorizationheaderzorunlu

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

Modül: MüşterilerKapsam: crm.read

Sorgu parametreleri

scopestringisteğe bağlı

mine = sorumlusu olduğum kayıtlar (satışçının varsayılanı), all = görebildiğim tüm kayıtlar (yöneticinin varsayılanı) ya da bir kullanıcı kimliği.

qstringisteğe bağlı

Ad, firma, telefon, e-posta ya da unvan içerir.

formerstringisteğe bağlı

1 = ayrılmış kişiler de gelsin.

İstek

curl "https://ornek.solk.app/api/v1/contacts?scope=all&q=a" \
  -H "Authorization: Bearer $SOLK_API_KEY"

const res = await fetch("https://ornek.solk.app/api/v1/contacts?scope=all&q=a", {
  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/contacts",
    headers={"Authorization": f"Bearer {os.environ['SOLK_API_KEY']}"},
    params={"scope": "all", "q": "a"},
)
print(r.json())

Yanıt

{
  "ok": true,
  "rows": [
    {
      "customer": "Ortanca Matbaacılık Ltd. Şti.",
      "customer_id": 22,
      "department": "Satın Alma",
      "email": "ahmet.aydin@ortancamatbaacilik.example",
      "id": 42,
      "is_former": false,
      "is_main": true,
      "name": "Ahmet Aydın",
      "note": "",
      "phone": "0 (332) 000 81 52",
      "rid": "003qMFfAArgzPDF",
      "title": "Satın Alma Müdürü",
      "wa": "903320008152"
    },
    {
      "customer": "Kamelya Lamine Film Ltd. Şti.",
      "customer_id": 6,
      "department": "Teknik",
      "email": "ahmet.ozturk@kamelyalamine.example",
      "id": 11,
      "is_former": false,
      "is_main": true,
      "name": "Ahmet Öztürk",
      "note": "",
      "phone": "0 (232) 000 89 83",
      "rid": "003t3MMhbXHOFjR",
      "title": "Teknik Müdür",
      "wa": "902320008983"
    }
  ],
  "total": 58
}

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