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ı oluşturun ve müşteri etiketlerini yönetin. Tüm operasyonlar tutarlı JSON zarf formatında yanıt döndürür.
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ı üzerinde kısmi 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, Maksimum: 100). |
| cursor | string | Bir sonraki sayfaya geçmek için kullanılan cursor değeri. |
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. Eğer veritabanında aynı telefon numarasına sahip bir müşteri mevcutsa, yeni kayıt oluşturulmaz ve mevcut müşteri bilgileri created: false yanıtıyla döndürülür. Bu davranış mükerrer kayıtları önler.
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 güncellemek için bu uç noktayı kullanın. PATCH isteklerinde yalnızca gönderilen alanlar güncellenir; gönderilmeyen alanlar mevcut değerleriyle korunur. Müşteri iddeğerini URL'nin sonuna ekleyin.
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
}