API Dokümantasyonuna Genel Bakış

1. Hesap Detaylarını Al

Son Nokta: GET https://tematif.com/api/account/details

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

2. Tüm Ürünleri Al

Son Nokta: GET https://tematif.com/api/items/all

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

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

Son Nokta: GET https://tematif.com/api/items/item

Açıklama: Sağlanan ürün kimliği ve API anahtarıyla ilişkili belirli bir öğenin detaylarını alır.

4. Satın Alma Doğrulaması

Son Nokta: POST https://tematif.com/api/purchases/validation

Açıklama: Bir satın alma kodunu doğrular ve geçerliyse satın alma hakkında detaylar döner.

Kimlik Doğrulama

Çalışma Alanı Ayarlarına Git

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

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

Çalışma alanı ayarları içinde, kullanıcı "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ı ya yeni bir API anahtarı oluşturabilir ya da önceden oluşturulmuş bir anahtarı 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ı Kopyala

API anahtarı oluşturulduktan veya alındıktan sonra, kullanıcı ekranında görüntülenen anahtarı görmelidir. Anahtarı panoya kopyalamak için anahtarın yanındaki bir düğmeye veya simgeye tıklayabilirler.

API Anahtarını Kullanın

API anahtarı kopyalandığında, kullanıcı artık platform API uç noktalarına erişirken isteklerini doğrulamak için anahtarı kullanabilir. Genellikle API anahtarını istek başlıkları veya parametreler olarak eklemeleri gerekir, API kimlik doğrulama mekanizmasına bağlı olarak.

API Anahtarını Güvende Tutun

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ı kodda sabitlemekten veya herkese açık erişilebilir 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ı Al

Sağlanan API anahtarıyla ilişkili hesabın detaylarını alır

Son Nokta

GET
https://tematif.com/api/account/details

Parametreler

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

Yanıtlar

Başarı 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

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

Son Nokta

GET
https://tematif.com/api/items/all

Parametreler

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

Yanıtlar

Başarı 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", // This is not included for audio items
                "preview_video": "https://example.com/video.mp4", // This is only included for video items
                "preview_audio": "https://example.com/audio.mp3", // This is only included for audio items
                "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ı"
}

Bir Ürün Detaylarını Al

Sağlanan ürün kimliği ve API anahtarıyla ilişkili belirli bir öğenin detaylarını alır.

Son Nokta

GET
https://tematif.com/api/items/item

Parametreler

  • api_key: API Anahtarınız (Zorunlu)
  • item_id: Alınacak öğenin kimliği (Zorunlu)

Yanıtlar

Başarı 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", // This is not included for audio items
            "preview_video": "https://example.com/video.mp4", // This is only included for video items
            "preview_audio": "https://example.com/audio.mp3", // This is only included for audio items
            "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": "Öğe Bulunamadı"
}

Satın Alma Doğrulaması

Bir satın alma kodunu doğrular ve geçerliyse satın alma hakkında detaylar döner.

Son Nokta

POST
https://tematif.com/api/purchases/validation

Parametreler

  • api_key: API Anahtarınız (Zorunlu).
  • purchase_code: Doğrulanacak satın alma kodu (Zorunlu).

Yanıtlar

Başarı Yanıtı:

{
    "status": "başarı",
    "data": {
        "purchase": {
            "purchase_code": "abcdefghijklmnopqrstuvwxyz123456789",
            "license_type": "Standart",
            "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", // This will not exist if support is disabled or its not supported
            "downloaded": false,
            "date": "2024-04-27T12:00:00Z"
        }
    }
}

Hata Yanıtı:

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