API Dokümantasyonuna Genel Bakış

1. Hesap Detaylarını Getir

Bitiş Noktası (Endpoint): GET https://mail.cod.tc/api/account/details

Açıklama: Sağlanan API Anahtarı İle İlişkili Hesabın Ayrıntılarını Getirir.

2. Tüm Ürünleri Getir

Bitiş Noktası (Endpoint): GET https://mail.cod.tc/api/items/all

Açıklama: Sağlanan API Anahtarı İle İlişkili Tüm Ürünleri Getirir.

3. Bir Ürünün Detaylarını Getir

Bitiş Noktası (Endpoint): GET https://mail.cod.tc/api/items/item

Açıklama: Sağlanan Ürün Kimliği Ve API Anahtarına Göre Belirli Bir Ürünün Ayrıntılarını Getirir.

4. Satın Alma Doğrulama

Bitiş Noktası (Endpoint): POST https://mail.cod.tc/api/purchases/validation

Açıklama: Bir Satın Alma Kodunu Doğrular Ve Geçerliyse Satın Alma İle İlgili Ayrıntıları Döndürür.

Kimlik Doğrulama

Çalışma Alanı Ayarlarına Git

Kullanıcı Öncelikle Platformdaki Hesabına Giriş Yapmalıdır. Ardından, Çalışma Alanının "Ayarlar" Bölümüne Gidebilir.

API Anahtarı Bölümünü Bul

Çalışma Alanı Ayarları İçinde, Kullanıcı Özellikle "API Anahtarı" Veya "API Erişimi" Olarak Etiketlenmiş Bir Bölüm Aramalıdır.

API Anahtarı Oluştur Veya Al

Bu Bölümde, Kullanıcı Yeni Bir API Anahtarı Oluşturabilir Veya Daha Önce Oluşturulmuşsa Mevcut Olanı Alabilir. Yeni Bir Anahtar Oluşturma Seçeneği Varsa, Kullanıcı Yeni Bir API Anahtarı Oluşturmak İçin Buna Tıklayabilir.

API Anahtarını Kopyala

API Anahtarı Oluşturulduktan Veya Alındıktan Sonra, Kullanıcı Bunu Ekranda Görüntüleyebilmelidir. Anahtarı Panoya Kopyalamak İçin Yanındaki Bir Düğmeye Veya Simgeye Tıklayabilirler.

API Anahtarını Kullan

Kopyalanan API Anahtarı İle Kullanıcı Artık Platform API Uç Noktalarına Erişirken İsteklerini Doğrulamak İçin Bunu Kullanabilir. Genellikle, API Kimlik Doğrulama Mekanizmasına Bağlı Olarak API Anahtarını İstek Başlıklarının Veya Parametrelerinin Bir Parçası Olarak Dahil Etmeleri Gerekir.

API Anahtarını Güvende Tut

Kullanıcılara API Anahtarlarını Güvende Tutmalarını Ve Herkese Açık Olarak Paylaşmamalarını Hatırlatmak Önemlidir. API Anahtarlarını İstemci Tarafı Koduna Sabit Kodlamaktan (Hardcoding) Veya Herkese Açık Depolarda Paylaşmaktan Kaçınmalıdırlar. Bunun Yerine, API Anahtarını Sunucu Tarafı Uygulamalarında Güvenli Bir Şekilde Saklamayı Ve Uygun Erişim Kontrollerini Kullanmayı Düşünmelidirler.

Hesap Detaylarını Getir

Sağlanan API Anahtarı İle İlişkili Hesabın Ayrıntılarını Getirir

Bitiş Noktası (Endpoint)

GET
https://mail.cod.tc/api/account/details

Parametreler

  • api_key: API Anahtarınız (Zorunlu)

Yanıtlar

Başarılı Yanıt:

{
    "status": "Başarılı",
    "data": {
        "name": {
            "firstname": "Ahmet",
            "lastname": "Yılmaz",
            "full_name": "Ahmet Yılmaz"
        },
        "username": "ahmetyilmaz",
        "email": "ahmet.yilmaz@ornek.com",
        "balance": 100.00,
        "currency": "TRY",
        "profile": {
            "heading": "Profil Başlığı",
            "description": "Profil Açıklaması",
            "contact": {
                "email": "iletisim@ornek.com"
            },
            "social_links": [
                "facebook": "/",
                "x": "/",
                // Vb...
            ],
            "media": {
                "avatar": "https://ornek.com/avatar.jpg",
                "cover": "https://ornek.com/kapak.jpg"
            }
        },
        "registered_at": "2024-04-27T12:00:00Z"
    }
}

Hata Yanıtı:

{
    "status": "hata",
    "msg": "Geçersiz İstek"
}

Tüm Ürünleri Getir

Sağlanan API Anahtarı İle İlişkili Tüm Ürünleri Getirir

Bitiş Noktası (Endpoint)

GET
https://mail.cod.tc/api/items/all

Parametreler

  • api_key: API Anahtarınız (Zorunlu)

Yanıtlar

Başarılı Yanıt:

{
    "status": "Başarılı",
    "items": [
        {
            "id": 1,
            "name": "Örnek Ürün",
            "description": "Bu Bir Örnek Üründür",
            "category": "Kategori Adı",
            "sub_category": "Alt Kategori Adı",
            "options": ["Seçenek1", "Seçenek2"],
            "version": 1.0.0,
            "demo_link": "https://ornek.com/demo",
            "tags": ["Etiket1", "Etiket2"],
            "media": {
                "thumbnail": "https://ornek.com/kucuk_resim.png",
                "preview_image": "https://ornek.com/onizleme.jpg", // Bu Ses Ürünleri İçin Dahil Edilmez
                "preview_video": "https://ornek.com/video.mp4", // Bu Sadece Video Ürünleri İçin Dahildir
                "preview_audio": "https://ornek.com/ses.mp3", // Bu Sadece Ses Ürünleri İçin Dahildir
                "screenshots": [ // Bu Sadece Ürünün Ekran Görüntüleri Varsa Dahildir
                    "https://ornek.com/ekran_goruntusu1.jpg",
                    "https://ornek.com/ekran_goruntusu2.jpg"
                ],
            },
            "price": {
                "regular": 19.99,
                "extended": 29.99
            },
            "currency": "TRY",
            "published_at": "2024-04-27T12:00:00Z"
        },
        {
            // Sonraki Ürün...
        }
    ]
}

Hata Yanıtı:

{
    "status": "hata",
    "msg": "Ürün Bulunamadı"
}

Ürün Detaylarını Getir

Sağlanan Ürün Kimliği Ve API Anahtarına Göre Belirli Bir Ürünün Ayrıntılarını Getirir.

Bitiş Noktası (Endpoint)

GET
https://mail.cod.tc/api/items/item

Parametreler

  • api_key: API Anahtarınız (Zorunlu)
  • item_id: Getirilecek Ürünün Kimliği (ID) (Zorunlu)

Yanıtlar

Başarılı Yanıt:

{
    "status": "Başarılı",
    "item": {
        "id": 1,
        "name": "Örnek Ürün",
        "description": "Bu Bir Örnek Üründür",
        "category": "Kategori Adı",
        "sub_category": "Alt Kategori Adı",
        "options": ["Seçenek1", "Seçenek2"],
        "version": 1.0.0,
        "demo_link": "https://ornek.com/demo",
        "tags": ["Etiket1", "Etiket2"],
        "media": {
            "thumbnail": "https://ornek.com/kucuk_resim.png",
            "preview_image": "https://ornek.com/onizleme.jpg", // Bu Ses Ürünleri İçin Dahil Edilmez
            "preview_video": "https://ornek.com/video.mp4", // Bu Sadece Video Ürünleri İçin Dahildir
            "preview_audio": "https://ornek.com/ses.mp3", // Bu Sadece Ses Ürünleri İçin Dahildir
            "screenshots": [ // Bu Sadece Ürünün Ekran Görüntüleri Varsa Dahildir
                "https://ornek.com/ekran_goruntusu1.jpg",
                "https://ornek.com/ekran_goruntusu2.jpg"
            ],
        },
        "price": {
            "regular": 19.99,
            "extended": 29.99
        },
        "currency": "TRY",
        "published_at": "2024-04-27T12:00:00Z"
    }
}

Hata Yanıtı:

{
    "status": "hata",
    "msg": "Ürün Bulunamadı"
}

Satın Alma Doğrulama

Bir Satın Alma Kodunu Doğrular Ve Geçerliyse Satın Alma İle İlgili Ayrıntıları Döndürür.

Bitiş Noktası (Endpoint)

POST
https://mail.cod.tc/api/purchases/validation

Parametreler

  • api_key: API Anahtarınız (Zorunlu).
  • purchase_code: Doğrulanacak Satın Alma Kodu (Zorunlu).

Yanıtlar

Başarılı Yanıt:

{
    "status": "Başarılı",
    "data": {
        "purchase": {
            "purchase_code": "abcdefghijklmnopqrstuvwxyz123456789",
            "license_type": "Standart",
            "price": 19.99,
            "currency": "TRY",
            "item": {
                "id": 1,
                "name": "Örnek Ürün",
                "description": "Bu Bir Örnek Üründür",
                "category": "Kategori Adı",
                "sub_category": "Alt Kategori Adı",
                "options": ["Seçenek1", "Seçenek2"],
                "version": 1.0.0,
                "demo_link": "https://ornek.com/demo",
                "tags": ["Etiket1", "Etiket2"],
                "media": {
                    "thumbnail": "https://ornek.com/kucuk_resim.png",
                    "preview_image": "https://ornek.com/onizleme.jpg", // Bu Ses Ürünleri İçin Dahil Edilmez
                    "preview_video": "https://ornek.com/video.mp4", // Bu Sadece Video Ürünleri İçin Dahildir
                    "preview_audio": "https://ornek.com/ses.mp3", // Bu Sadece Ses Ürünleri İçin Dahildir
                    "screenshots": [ // Bu Sadece Ürünün Ekran Görüntüleri Varsa Dahildir
                        "https://ornek.com/ekran_goruntusu1.jpg",
                        "https://ornek.com/ekran_goruntusu2.jpg"
                    ],
                },
                "price": {
                    "regular": 19.99,
                    "extended": 29.99
                },
                "currency": "TRY",
                "published_at": "2024-04-27T12:00:00Z"
            },
            "supported_until": "2024-04-27T12:00:00Z", // Bu Destek Devre Dışı Bırakılmışsa Veya Desteklenmiyorsa Mevcut Olmayacaktır
            "downloaded": false,
            "date": "2024-04-27T12:00:00Z"
        }
    }
}

Hata Yanıtı:

{
    "status": "hata",
    "msg": "Geçersiz Satın Alma Kodu"
}