API Reference v1.0
Eğitim Ana Site Giriş Yap

Cari Hesap

Müşteri ve tedarikçi cari kart yönetimi.

GET /api/v1/cari

Cari Listesi

Tüm cari kartları listeler.

Kimlik doğrulama gerektirir
Parametreler
Parametre Tip Zorunlu Açıklama
page integer Opsiyonel Sayfa numarası
tip string Opsiyonel Cari tipi filtresi (musteri, tedarikci, her_ikisi)
search string Opsiyonel Unvan veya vergi numarasına göre arama
Response 200
{
    "success": true,
    "data": [
        {
            "ck_id": 1,
            "ck_firmaUnvani": "ABC Teknoloji Ltd.",
            "ck_vergiNo": "1234567890",
            "ck_bakiye": 15750,
            "ck_tip": "musteri"
        }
    ],
    "meta": {
        "current_page": 1,
        "total": 89
    }
}

GET /api/v1/cari/{id}/ekstre

Cari Ekstre

Belirtilen carinin alacak/borç hareketlerini listeler.

Kimlik doğrulama gerektirir
Parametreler
Parametre Tip Zorunlu Açıklama
id integer Zorunlu Cari kart ID
baslangic date Opsiyonel Başlangıç tarihi (YYYY-MM-DD)
bitis date Opsiyonel Bitiş tarihi (YYYY-MM-DD)
Response 200
{
    "success": true,
    "data": {
        "cari": {
            "ck_firmaUnvani": "ABC Teknoloji Ltd."
        },
        "hareketler": [
            {
                "tarih": "2026-02-15",
                "aciklama": "Satış Faturası #1234",
                "borc": 0,
                "alacak": 5000,
                "bakiye": 5000
            }
        ],
        "toplam_borc": 0,
        "toplam_alacak": 5000
    }
}

cURL Örneği

GET /api/v1/cari
curl -X GET https://api.pratikesnaf.com/api/v1/cari \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json"