Müşteri Yönetimi Uç Noktaları

Müşteriler API (`/api/v1/contacts`)

Müşterilerinizi listeleyin, isme veya telefon numarasına göre arayın, yeni müşteri kartları açın ve müşteri etiketlerini güncelleyin.

Bu Uç Nokta Ne Yapar? (Basitçe Anlatım)

Bu adresler, rehberinizdeki müşteri kartlarıyla çalışmanızı sağlar. Tıpkı telefonunuzdaki rehber gibi düşünün: müşteri adı, telefonu, e-postası ve etiketleri (ör. "VİP", "Toptan") burada durur. Bu API ile rehberinizi okuyabilir (listeleme, arama) ve güncelleyebilirsiniz (yeni müşteri ekleme).

Akıllı davranış Aynı telefon numarasıyla tekrar müşteri eklerseniz sistem çoğaltmaz. Mevcut müşteriyi size geri döndürür (created: false). Böylece rehberinizde asla mükerrer (çift) kayıt oluşmaz.

GEThttps://gelsinsatislar.com/api/v1/contactsScope: contacts:read

1. Müşterileri Listele & Ara

Sorgu parametreleri (Query Parameters):

Parametre	Tipi	Açıklama
search	string	İsim veya telefon numarası içinde arama yapar.
tag	string (UUID)	Yalnızca belirli bir etiket ID'sine sahip müşterileri filtreler.
limit	integer	Sayfa başına sonuç sayısı (Varsayılan: 50, Maks: 100).
cursor	string	Bir sonraki sayfaya geçmek için kullanılan cursor imleci.

curl -X GET "https://gelsinsatislar.com/api/v1/contacts?search=Ahmet&limit=20" \
  -H "Authorization: Bearer gelsinsatislar_live_YOUR_API_KEY"

POSThttps://gelsinsatislar.com/api/v1/contactsScope: contacts:write

2. Yeni Müşteri Oluştur (Find-or-Create)

Telefon numarasına göre müşteri oluşturur. Telefon numarası veritabanınızda zaten varsa, var olan müşteriyi döner (`created: false`).

curl -X POST "https://gelsinsatislar.com/api/v1/contacts" \
  -H "Authorization: Bearer gelsinsatislar_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "+905320000000",
    "name": "Zeynep Kaya",
    "email": "zeynep@example.com"
  }'

{
  "data": {
    "id": "cnt_9481203",
    "phone": "+905320000000",
    "name": "Zeynep Kaya",
    "email": "zeynep@example.com",
    "created_at": "2026-08-08T22:00:00Z",
    "created": true
  },
  "error": null
}

PATCHhttps://gelsinsatislar.com/api/v1/contacts/{id}Scope: contacts:write

3. Müşteri Bilgilerini Güncelle (PATCH)

Var olan bir müşterinin adını, e-postasını veya etiketlerini değiştirmek için bu uç noktayı kullanın. Yalnızca gönderdiğiniz alanlar güncellenir; diğerleri olduğu gibi kalır. Müşteri id değerini adresin sonuna ekleyin.

Basitçe Anlatım

PATCH, "sadece söylediğim kısmı değiştir" demektir. Telefon rehberinizde bir kişinin yalnızca soyadını düzeltmek gibi. Güncellenmesini istemediğiniz alanları göndermezsiniz; onlar aynen kalır.

curl -X PATCH "https://gelsinsatislar.com/api/v1/contacts/cnt_9481203" \
  -H "Authorization: Bearer gelsinsatislar_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Zeynep Kaya Demir",
    "tags": ["vip", "toptan"]
  }'

{
  "data": {
    "id": "cnt_9481203",
    "phone": "+905320000000",
    "name": "Zeynep Kaya Demir",
    "email": "zeynep@example.com",
    "tags": ["vip", "toptan"],
    "updated_at": "2026-08-08T22:30:00Z"
  },
  "error": null
}