API Dokümanlarına Genel Bakış

1. Hesap Ayrıntılarını Alın

Son Nokta: GET https://coderia.net/api/account/details

Açıklama: Sağlanan API anahtarıyla ilişkili hesabın ayrıntılarını alır.

2. Tüm Öğeleri Alın

Son Nokta: GET https://coderia.net/api/items/all

Açıklama: Sağlanan API anahtarıyla ilişkili tüm öğeleri alır.

3. Ürün Detaylarını Alın

Son Nokta: GET https://coderia.net/api/items/item

Açıklama: Verilen öğe kimliği ve API anahtarına göre belirli bir öğenin ayrıntılarını alır.

4. Satın Alma Doğrulaması

Son Nokta: POST https://coderia.net/api/purchases/validation

Açıklama: Bir satın alma kodunu doğrular ve geçerliyse satın alma ile ilgili ayrıntıları döndürür.

Kimlik Doğrulaması

Çalışma Alanı Ayarları'na gidin

Kullanıcı öncelikle platformdaki hesabına giriş yapmalıdır. Ardından, çalışma alanlarının "Ayarlar" bölümüne gidebilirler.

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

Çalışma alanı ayarları içinde, kullanıcı özellikle "API Anahtarı" veya "API Erişimi" olarak etiketlenmiş bir bölüm aramalıdır.

API Anahtarı Oluşturun veya Alın

Bu bölümde, kullanıcı yeni bir API anahtarı oluşturabilir veya daha önce oluşturulmuşsa mevcut bir anahtarı geri alabilir. Yeni bir anahtar oluşturma seçeneği varsa, kullanıcı yeni bir API anahtarı oluşturmak için buna tıklayabilir.

API Anahtarını Kopyalayın

API anahtarı oluşturulduktan veya alındıktan sonra, kullanıcı bunu ekranda görebilmelidir. Panolarına kopyalamak için anahtarın yanındaki bir düğmeye veya simgeye tıklamaları yeterlidir.

API Anahtarını Kullanın

Kopyalanan API anahtarı ile kullanıcı artık platform API uç noktalarına erişirken isteklerinin kimliğini doğrulamak için bu anahtarı kullanabilir. API kimlik doğrulama mekanizmasına bağlı olarak, genellikle API anahtarını istek başlıklarının veya parametrelerinin bir parçası olarak eklemeleri gerekir.

API Anahtarının Güvenliğini Sağlayın

Kullanıcılara API anahtarlarını güvende tutmaları ve herkese açık olarak paylaşmamaları gerektiğini hatırlatmak önemlidir. API anahtarlarını istemci tarafı kodunda sabit kodlamaktan 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 Ayrıntılarını Alın

Sağlanan API anahtarı ile ilişkili hesabın ayrıntılarını alır

Son Nokta

GET
https://coderia.net/api/account/details

Parametreler

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

Yanıtlar

Başarılı Yanıt:

{
    "status": "başarı",
    "data": {
        "name": {
            "firstname": "John",
            "lastname": "Doe",
            "full_name": "John Doe"
        },
        "username": "johndoe",
        "email": "john.doe@example.com",
        "balance": 100.00,
        "currency": "TRY",
        "profile": {
            "heading": "Profile Heading",
            "description": "Profile Description",
            "contact": {
                "email": "contact@example.com"
            },
            "social_links": [
                "facebook": "/",
                "x": "/",
                // etc...
            ],
            "media": {
                "avatar": "https://example.com/avatar.jpg",
                "cover": "https://example.com/cover.jpg"
            }
        },
        "registered_at": "2024-04-27T12:00:00Z"
    }
}

Hata Yanıtı:

{
    "status": "hata",
    "msg": "Geçersiz istek"
}

Tüm Ürünleri Alın

Sağlanan API anahtarıyla ilişkili tüm öğeleri alır

Son Nokta

GET
https://coderia.net/api/items/all

Parametreler

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

Yanıtlar

Başarılı Yanıt:

{
    "status": "başarı",
    "items": [
        {
            "id": 1,
            "name": "Sample Item",
            "description": "This is a sample item",
            "category": "Category Name",
            "sub_category": "Subcategory Name",
            "options": ["option1", "option2"],
            "version": 1.0.0,
            "demo_link": "https://example.com/demo",
            "tags": ["tag1", "tag2"],
            "media": {
                "thumbnail": "https://example.com/thumbnail.png",
                "preview_image": "https://example.com/preview.jpg", // Sesli ürünler için bu dahil değildir
                "preview_video": "https://example.com/video.mp4", // Bu yalnızca video ürünleri için dahildir
                "preview_audio": "https://example.com/audio.mp3", // Bu yalnızca sesli ürünler için dahildir
                "screenshots": [
                    "https://example.com/screenshot1.jpg",
                    "https://example.com/screenshot2.jpg"
                ],
            },
            "price": {
                "regular": 19.99,
                "extended": 29.99
            },
            "currency": "TRY",
            "published_at": "2024-04-27T12:00:00Z"
        },
        {
            // Next item...
        }
    ]
}

Hata Yanıtı:

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

Ürün Detaylarını Alın

Verilen öğe kimliği ve API anahtarına göre belirli bir öğenin ayrıntılarını alır.

Son Nokta

GET
https://coderia.net/api/items/item

Parametreler

  • api_key: API anahtarınız (Zorunlu)
  • item_id: Alınacak ürünün kimliği (Zorunlu)

Yanıtlar

Başarılı Yanıt:

{
    "status": "başarı",
    "item": {
        "id": 1,
        "name": "Sample Item",
        "description": "This is a sample item",
        "category": "Category Name",
        "sub_category": "Subcategory Name",
        "options": ["option1", "option2"],
        "version": 1.0.0,
        "demo_link": "https://example.com/demo",
        "tags": ["tag1", "tag2"],
        "media": {
            "thumbnail": "https://example.com/thumbnail.png",
            "preview_image": "https://example.com/preview.jpg", // Sesli ürünler için bu dahil değildir
            "preview_video": "https://example.com/video.mp4", // Bu yalnızca video ürünleri için dahildir
            "preview_audio": "https://example.com/audio.mp3", // Bu yalnızca sesli ürünler için dahildir
            "screenshots": [
                "https://example.com/screenshot1.jpg",
                "https://example.com/screenshot2.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ğrulaması

Bir satın alma kodunu doğrular ve geçerliyse satın alma ile ilgili ayrıntıları döndürür.

Son Nokta

POST
https://coderia.net/api/purchases/validation

Parametreler

  • api_key: API anahtarınız (Zorunlu).
  • purchase_code: Geçerli kılınacak satın alma kodu (Zorunlu).

Yanıtlar

Başarılı Yanıt:

{
    "status": "başarı",
    "data": {
        "purchase": {
            "purchase_code": "abcdefghijklmnopqrstuvwxyz123456789",
            "license_type": "Düzenli",
            "price": 19.99,
            "currency": "TRY",
            "item": {
                "id": 1,
                "name": "Sample Item",
                "url": "https://example.com/item",
                "media": {
                    "preview_image": "https://example.com/preview.jpg"
                }
            },
            "supported_until": "2024-04-27T12:00:00Z", // Destek devre dışı bırakılmışsa veya desteklenmiyorsa bu mevcut olmayacaktır
            "downloaded": false,
            "date": "2024-04-27T12:00:00Z"
        }
    }
}

Hata Yanıtı:

{
    "status": "hata",
    "msg": "Geçersiz satın alım kodu"
}