API dokümantasyonu genel bakış

1. Hesap bilgilerini al

Uç nokta: GET https://www.tematif.com/api/account/details

Açıklama: Sağlanan API anahtarına bağlı hesabın bilgilerini getirir.

2. Tüm ürünleri al

Uç nokta: GET https://www.tematif.com/api/items/all

Açıklama: Sağlanan API anahtarına bağlı tüm ürünleri getirir.

3. Ürün detayını al

Uç nokta: GET https://www.tematif.com/api/items/item

Açıklama: Sağlanan ürün ID ve API anahtarına göre ilgili ürünün detaylarını getirir.

4. Satın alma doğrulama

Uç nokta: POST https://www.tematif.com/api/purchases/validation

Açıklama: Satın alma kodunu doğrular ve geçerliyse satın alma bilgilerini döndürür.

Kimlik doğrulama

Çalışma alanı ayarlarına gidin

Kullanıcı önce platformda 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ü bulun

Çalışma alanı ayarlarında "API anahtarı" veya "API erişimi" etiketli bölümü arayın.

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 anahtarı alabilir. Yeni anahtar oluşturma seçeneği varsa tıklayarak yeni API anahtarı oluşturabilir.

API anahtarını kopyala

API anahtarı oluşturulduğunda veya alındığında ekranda görünür. Anahtarın yanındaki buton veya ikona tıklayarak panoya kopyalayabilirsiniz.

API anahtarını kullan

API anahtarı kopyalandıktan sonra platform API uç noktalarına erişirken istekleri doğrulamak için kullanılabilir. API kimlik doğrulama mekanizmasına göre anahtar genellikle istek başlıklarına veya parametrelerine eklenmelidir.

API anahtarını güvende tutun

API anahtarlarını güvende tutmak ve herkese açık paylaşmamak önemlidir. İstemci tarafı kodda sabit kodlamaktan veya herkese açık depolarda paylaşmaktan kaçının; sunucu tarafında güvenli saklayın ve uygun erişim kontrolleri kullanın.

Hesap bilgilerini al

Sağlanan API anahtarına bağlı hesabın bilgilerini getirir

Uç nokta

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

Parametreler

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

Yanıtlar

Başarı yanıtı:

{
    "status": "başarılı",
    "data": {
        "name": {
            "firstname": "John",
            "lastname": "Doe",
            "full_name": "John Doe"
        },
        "username": "johndoe",
        "email": "john.doe@example.com",
        "balance": 100.00,
        "currency": "YTL",
        "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ına bağlı tüm ürünleri getirir

Uç nokta

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

Parametreler

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

Yanıtlar

Başarı yanıtı:

{
    "status": "başarılı",
    "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": [ // This is only included if item has screenshots
                    "https://example.com/screenshot1.jpg",
                    "https://example.com/screenshot2.jpg"
                ],
            },
            "price": {
                "regular": 19.99,
                "extended": 29.99
            },
            "currency": "YTL",
            "published_at": "2024-04-27T12:00:00Z"
        },
        {
            // Next item...
        }
    ]
}

Hata yanıtı:

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

Ürün detayını al

Sağlanan ürün ID ve API anahtarına göre ilgili ürünün detaylarını getirir.

Uç nokta

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

Parametreler

  • api_key: API anahtarınız (Zorunlu)
  • item_id: Getirilecek ürünün ID'si (Zorunlu)

Yanıtlar

Başarı yanıtı:

{
    "status": "başarılı",
    "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": [ // This is only included if item has screenshots
                "https://example.com/screenshot1.jpg",
                "https://example.com/screenshot2.jpg"
            ],
        },
        "price": {
            "regular": 19.99,
            "extended": 29.99
        },
        "currency": "YTL",
        "published_at": "2024-04-27T12:00:00Z"
    }
}

Hata yanıtı:

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

Satın alma doğrulama

Satın alma kodunu doğrular ve geçerliyse satın alma bilgilerini döndürür.

Uç nokta

POST
https://www.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ılı",
    "data": {
        "purchase": {
            "purchase_code": "abcdefghijklmnopqrstuvwxyz123456789",
            "license_type": "Standart",
            "price": 19.99,
            "currency": "YTL",
            "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": [ This is only included if item has screenshots
                        "https://example.com/screenshot1.jpg",
                        "https://example.com/screenshot2.jpg"
                    ],
                },
                "price": {
                    "regular": 19.99,
                    "extended": 29.99
                },
                "currency": "YTL",
                "published_at": "2024-04-27T12:00:00Z"
            },
            "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"
}