Web Servisi Kullanım Dökümanı

Nedir

Bu dökümanda camlicakitap.com üzerinde yayında olan satış sisteminin web servisleri hakkında bilgi verilecektir.

Genel Kurallar

Tüm gönderim isteklerinde POST metodu kullanılmaktadır. Cevaplar ise JSONformatlıdır.

Genel Parametreler

Tüm gönderimlerde hash isimli parametreyi göndermeniz gerekmektedir. Bu parametre size özel verilmektedir.

Kategori Liste Servisi

POST /kategori/liste

Sistemde yer alan kategorileri almak için kullanılır. Kategoriler 2 seviyelidir. Hiyerarşik olarak verilir. Yayınevevleri parametresi isteğe bağlıdır ve tanımlanmazsa tüm kategoriler alınacaktır. Yayınevleri parametresi tanımlanırsa sadece ilgili yayınevlerine göre çalışır.

Parametreler

• yayinevi_ids Yayınevi numaraları aralarında , kullanılarak gönderilir. Ör: 17,26 Boş geçilebilir, bu durumda tüm kategoriler listelenir

Sonuç

{
    "sonuc": 1,
    "kayitlar": [
        {
            "id": 3,
            "adi": "Dini Kitaplar",
            "radi": "dini-kitaplar",
            "kitap_sayisi": 14,
            "alt_kategoriler": [
                {
                    "id": 58,
                    "adi": "Ahlak-Âdâb-Sohbet",
                    "radi": "ahlak-adab-sohbet",
                    "kitap_sayisi": 5
                },
                {
                    "id": 61,
                    "adi": "Siyer-İslam Tarihi",
                    "radi": "siyer-islam-tarihi",
                    "kitap_sayisi": 8
                }
            ]
        },
        {
            "id": 9,
            "adi": "Tarih - Araştırma",
            "radi": "tarih-arastirma",
            "kitap_sayisi": 5,
            "alt_kategoriler": []
        },
        {
            "id": 25,
            "adi": "Sağlık",
            "radi": "saglik",
            "kitap_sayisi": 1,
            "alt_kategoriler": []
        }
    ]
}

Kategori Detay Servisi

POST /kategori/detay

Bir kategoriye ait detayları verir.

Parametreler

• kategori_id parametresi gönderilebilir, Ör: 3

Sonuç

{
    "sonuc": 1,
    "kayit": {
        "id": 3,
        "adi": "Dini Kitaplar",
        "radi": "dini-kitaplar"
    }
}

Kitap Liste Servisi

POST /kitap/liste

Kitapların listesini almak için kullanılan servistir.

Parametreler

• yayinevi_ids Birden fazla yayınevi numarası aralarında , kullanılarak berlilenebilir. Zorunlu değildir.
• q Arama kelimesidir. Kitap isimlerinde %q% şeklinde arama yapmak için. Zorunlu değildir.
• yazar_id Yazarın kitapları isteniyorsa ilgili yazarın numarası. Zorunlu değildir.
• kategori_id Bir kategoriye ait kitaplar isteniyorsa. Zorunlu değildir.
• siralama_key Bu bilgiye göre sonuçlar sıralanabilir. Boş geçilirse id bilgisine göre sıralanır. Olabilecek değerler: kitap_adi (kitap adına göre sıralar)
• siralama_value Bu bilgiye göre a-z şeklinde ya da z-a şeklinde sıralama yapar. Muhtemel değerler: asc ya da desc
• baslangic Sonuçları sorgularken başlangıç sırası. Varsayılan olarak 0 dır.
• adet Kaç adet sonuç alınacak. En az 1, en fazla 100 olabilir.

Sonuç

{
    "sonuc": 1,
    "kayitlar": [
        {
            "id": 17,
            "adi": "Hicaz Vilayet Salnâmesi (H. 1303 - M. 1886)",
            "radi": "hicaz-vilayet-salnamesi-h-1303-m-1886",
            "resim_uzantisi": "jpg",
            "liste_fiyati": 23,
            "uye_fiyati": "18.40",
            "yazarlar": [
                {
                    "id": 15,
                    "adi": "Selman Soydemir",
                    "radi": "selman-soydemir"
                },
                {
                    "id": 47,
                    "adi": "Osman Doğan",
                    "radi": "osman-dogan"
                }
            ]
        },
        {
            "id": 21,
            "adi": "Sultan Abdülhamid Han'a Yapılan Suikastin Perde Arkası",
            "radi": "sultan-abdulhamid-han-a-yapilan-suikastin-perde-arkasi",
            "resim_uzantisi": "jpg",
            "liste_fiyati": 12,
            "uye_fiyati": "9.60",
            "yazarlar": [
                {
                    "id": 19,
                    "adi": "Harun Tuncer",
                    "radi": "harun-tuncer"
                }
            ]
        },
        {
            "id": 22,
            "adi": "Barbaros Hayreddin Paşa'nın Hatıraları",
            "radi": "barbaros-hayreddin-pasa-nin-hatiralari",
            "resim_uzantisi": "jpg",
            "liste_fiyati": 12,
            "uye_fiyati": "9.60",
            "yazarlar": [
                {
                    "id": 6,
                    "adi": "Seyyid Muradi Reis",
                    "radi": "seyyid-muradi-reis"
                }
            ]
        }
    ]
}

Kitap Detay Servisi

POST /kitap/detay

Bir kitaba ait detayları verir.

Parametreler

• kitap_id parametresi gönderilebilir, Ör: 17

Sonuç

{
    "sonuc": 1,
    "kayit": {
        "id": 17,
        "adi": "Hicaz Vilayet Salnâmesi (H. 1303 - M. 1886)",
        "radi": "hicaz-vilayet-salnamesi-h-1303-m-1886",
        "sayfa": "438",
        "stok_bilgisi": "Var",
        "boyut": "16 x 23 cm; Ciltli",
        "isbn": "9944-905-55-8",
        "detay": "Coğrafya literatüründe, Arabistan Yarımadası'nda Kızıldeniz'in doğu sahili boyunca uzanan ve Haremeyn ile mîkât mekânlarını ihtiva eden bölge Hicaz ismiyle geçer.\n\nOsmanlı idârî taksimatında ise Mekke-i Mükerreme, Medîne-i Münevvere ve Cidde sancakları ile bunlara bağlı kaza ve nâhiyelerden oluşan ve doğudan Necid, batıdan Kızıldeniz, güneyden Asîr sancağı, kuzeyden Kudüs sancağı ve Arîş, Akabe muhafızlıkları ile çevrili bölgeye Hicaz Vilâyeti adı verilmektedir.\n\nHicaz Vilâyeti ile alakalı kütüphanelerimizde ve arşivlerimizde çok kıymetli kaynaklar bulunmaktadır. Bu kaynakların en mühimlerinden biri de bizzat Hicaz vâliliği tarafından neşredilen Hicaz Vilâyet Salnâmeleridir. Osmanlı Devleti'nin en mühim vilâyetlerinden biri olan Hicaz Vilâyeti vâliliği de 1301, 1303, 1305, 1306 ve 1309 tarihlerine ait olmak üzere beş adet salnâme neşretmiştir. \n\nÇamlıca Basım Yayın olarak neşre hazırladığımız 1303 (1886) tarihli Hicaz Vilâyet Salnâmesi adlı eserimizle Mekke-i Mükerreme ve Medîne-i Münevvere'yi yakından tanıyacak; Osmanlı'nın Kâbe-i Muazzama ve Ravza-i Mutahhara'ya göstermiş olduğu büyük hürmet ve tâzimi, bu mübârek beldelere yaptığı hizmetleri ve Peygamber Efendimiz ve Ashâb-ı Kirâm'a olan hassâsiyetini görmüş olacaksınız. Osmanlıca tıpkıbasımını da koyduğumuz bu güzide eserin faydalı olmasını temenni ediyoruz.\n\n- XVI + 208 + 204 (Tıpkıbasım) Sayfa",
        "resim_uzantisi": "jpg",
        "liste_fiyati": 23,
        "uye_fiyati": "18.40",
        "kategori": {
            "id": 18,
            "adi": "Kaynak Eserler",
            "radi": "kaynak-eserler"
        },
        "dil": {
            "id": 1,
            "adi": "Türkçe"
        },
        "yazarlar": [
            {
                "id": 15,
                "adi": "Selman Soydemir",
                "radi": "selman-soydemir"
            },
            {
                "id": 47,
                "adi": "Osman Doğan",
                "radi": "osman-dogan"
            }
        ]
    }
}

Kitap Bilgi Servisi

POST /kitap/bilgi

Sistemdeki kitapların geneli hakkında bilgiler verir. Şimdilik sistemdeki kitap sayısını verir.

Parametreler

• yayinevi_ids Birden fazla yayınevi numarası aralarında , kullanılarak berlilenebilir. Zorunlu değildir.
• q Arama kelimesidir. Kitap isimlerinde %q% şeklinde arama yapmak için. Zorunlu değildir.
• yazar_id Yazarın kitapları isteniyorsa ilgili yazarın numarası. Zorunlu değildir.
• kategori_id Bir kategoriye ait kitaplar isteniyorsa. Zorunlu değildir.

Sonuç

{
    "sonuc": 1,
    "bilgi": {
        "adet": 1116
    }
}

Yazar Liste Servisi

POST /yazar/liste

Yazarların listesini almak için kullanılan servistir.

Parametreler

• yayinevi_ids Birden fazla yayınevi numarası aralarında , kullanılarak berlilenebilir. Zorunlu değildir.
• siralama_key Bu bilgiye göre sonuçlar sıralanabilir. Boş geçilirse id bilgisine göre sıralanır. Olabilecek değerler: yazar_adi (yazar adına göre sıralar)
• siralama_value Bu bilgiye göre a-z şeklinde ya da z-a şeklinde sıralama yapar. Muhtemel değerler: asc ya da desc
• baslangic Sonuçları sorgularken başlangıç sırası. Varsayılan olarak 0 dır.
• adet Kaç adet sonuç alınacak. En az 1, en fazla 100 olabilir.

Sonuç

{
    "sonuc": 1,
    "kayitlar": [
        {
            "id": 1,
            "adi": "Komisyon",
            "radi": "komisyon",
            "kitap_sayisi": 212
        },
        {
            "id": 2,
            "adi": "Heyet",
            "radi": "heyet",
            "kitap_sayisi": 104
        },
        {
            "id": 5,
            "adi": "Oruç Beğ",
            "radi": "oruc-beg",
            "kitap_sayisi": 1
        },
        {
            "id": 6,
            "adi": "Seyyid Muradi Reis",
            "radi": "seyyid-muradi-reis",
            "kitap_sayisi": 1
        }
    ]
}

Yazar Detay Servisi

POST /yazar/detay

Bir yazara ait detayları verir.

Parametreler

• yazar_id parametresi gönderilebilir, Ör: 5

Sonuç

{
    "sonuc": 1,
    "kayit": {
        "id": 5,
        "adi": "Oruç Beğ",
        "radi": "oruc-beg",
        "hakkinda": null
    }
}

Yazar Bilgi Servisi

POST /yazar/bilgi

Sistemdeki yazarların geneli hakkında bilgiler verir. Şimdilik sistemdeki yazar sayısını verir.

Parametreler

• yayinevi_ids Birden fazla yayınevi numarası aralarında , kullanılarak berlilenebilir. Zorunlu değildir.

Sonuç

{
    "sonuc": 1,
    "bilgi": {
        "adet": 544
    }
}