Müşteriler

Galerinizin müşteri kayıtlarını (customers) okumak için tek uç nokta. Kapsam: customers:read.

GET /api/v1/customers.php

Yalnızca API key'inizin ait olduğu galerinin müşterilerini döner.

Sorgu Parametreleri

Parametre	Tip	Açıklama
limit	integer	Sayfa başına kayıt. Varsayılan 25, maksimum 100 — bkz. Sayfalama.
offset	integer	Atlanacak kayıt sayısı.

Bu uç nokta durum (status) filtresi desteklemez — müşteri kayıtlarında böyle bir alan yoktur.

Yanıt Alanları

Alan	Tip	Açıklama
id	uuid	Müşterinin benzersiz kimliği.
first_name	string	Ad.
last_name	string	Soyad.
phone	string	Telefon.
email	string|null	E-posta (girilmemişse null).
risk_level	string	Dahili risk seviyesi (ör. low/medium/high).
created_at / updated_at	timestamp	ISO 8601 (UTC).

Bilerek yanıta dahil edilmeyenler: kimlik numarası (id_no), adres, aylık gelir gibi hassas kişisel veriler — KVKK/veri gizliliği gerekçesiyle hiçbir API key ile dışarı verilmez.

Örnek İstekler

curl "https://otomovena.com/api/v1/customers.php?limit=20" \
  -H "Authorization: Bearer otv_live_xxxxx..."

<?php
$ch = curl_init('https://otomovena.com/api/v1/customers.php?limit=20');
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer otv_live_xxxxx...']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$customers = json_decode(curl_exec($ch), true)['data'];

const res = await fetch('https://otomovena.com/api/v1/customers.php?limit=20', {
  headers: { Authorization: 'Bearer otv_live_xxxxx...' }
});
const { data } = await res.json();

import requests

res = requests.get(
    "https://otomovena.com/api/v1/customers.php",
    params={"limit": 20},
    headers={"Authorization": "Bearer otv_live_xxxxx..."},
)
customers = res.json()["data"]

Örnek Yanıt

{
  "success": true,
  "data": [
    { "id": "8b083df5-...", "first_name": "Ahmet", "last_name": "Yılmaz", "phone": "0533 000 00 00", "email": null, "risk_level": "low", "created_at": "2026-05-10T09:00:00Z", "updated_at": "2026-05-10T09:00:00Z" }
  ],
  "meta": { "limit": 20, "offset": 0, "count": 1 }
}

Bu Uç Noktaya Özel Hatalar

HTTP	Kod	Neden
403	insufficient_scope	Key'de customers:read kapsamı yok.
405	method_not_allowed	GET dışında bir metod denendi.

Genel hata kodları için: Hata Kodları & Rate Limit.