Ikhtisar Dokumentasi API

1. Dapatkan Detail Akun

Endpoint: GET https://wisnyemil.my.id/api/account/details

Keterangan: Mengambil rincian akun yang terkait dengan kunci API yang diberikan.

2. Dapatkan Semua Barang

Endpoint: GET https://wisnyemil.my.id/api/items/all

Keterangan: Mengambil semua item yang terkait dengan kunci API yang disediakan.

3. Dapatkan Detail Barang

Endpoint: GET https://wisnyemil.my.id/api/items/item

Keterangan: Mengambil rincian item tertentu berdasarkan ID item dan kunci API yang diberikan.

4. Validasi Pembelian

Endpoint: POST https://wisnyemil.my.id/api/purchases/validation

Keterangan: Memvalidasi kode pembelian dan mengembalikan rincian tentang pembelian jika valid.

Authentication

Navigate to Workspace Settings

Pengguna harus terlebih dahulu masuk ke akun mereka di platform. Kemudian, mereka dapat membuka bagian "Pengaturan" di ruang kerja mereka.

Temukan Bagian Kunci API

Dalam pengaturan ruang kerja, pengguna harus mencari bagian yang diberi label khusus "Kunci API" atau "Akses API".

Hasilkan atau Ambil Kunci API

Di bagian ini, pengguna dapat membuat kunci API baru atau mengambil kunci yang sudah ada jika kunci tersebut telah dibuat sebelumnya. Jika ada pilihan untuk membuat kunci baru, pengguna dapat mengkliknya untuk membuat kunci API baru.

Salin Kunci API

Setelah kunci API dibuat atau diambil, pengguna akan dapat melihatnya ditampilkan di layar. Mereka cukup mengeklik tombol atau ikon di samping kunci untuk menyalinnya ke clipboard.

Gunakan Kunci API

Setelah kunci API disalin, pengguna kini dapat menggunakannya untuk mengautentikasi permintaan mereka saat mengakses titik akhir API platform. Biasanya, mereka perlu menyertakan kunci API sebagai bagian dari header atau parameter permintaan, tergantung pada mekanisme autentikasi API.

Amankan Kunci API

Penting untuk mengingatkan pengguna agar menjaga kunci API mereka tetap aman dan tidak membagikannya secara publik. Mereka harus menghindari hardcoding kunci API dalam kode sisi klien atau membagikannya dalam repositori yang dapat diakses publik. Sebaliknya, mereka harus mempertimbangkan untuk menyimpan kunci API secara aman pada aplikasi sisi server mereka dan menggunakan kontrol akses yang sesuai.

Dapatkan Detail Akun

Mengambil detail akun yang terkait dengan kunci API yang diberikan

Endpoint

GET
https://wisnyemil.my.id/api/account/details

Parameters

  • api_key: Your API key (Diperlukan)

Responses

Success Response:

{
    "status": "success",
    "data": {
        "name": {
            "firstname": "John",
            "lastname": "Doe",
            "full_name": "John Doe"
        },
        "username": "johndoe",
        "email": "john.doe@example.com",
        "balance": 100.00,
        "currency": "IDR",
        "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"
    }
}

Error Response:

{
    "status": "error",
    "msg": "Invalid request"
}

Dapatkan Semua Item

Mengambil semua item yang terkait dengan kunci API yang diberikan

Endpoint

GET
https://wisnyemil.my.id/api/items/all

Parameters

  • api_key: Your API key (Diperlukan)

Responses

Success Response:

{
    "status": "success",
    "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", // Ini tidak termasuk untuk item audio
                "preview_video": "https://example.com/video.mp4", // Ini hanya berlaku untuk item video
                "preview_audio": "https://example.com/audio.mp3", // Ini hanya berlaku untuk item audio
                "screenshots": [ // Ini hanya disertakan jika item memiliki tangkapan layar
                    "https://example.com/screenshot1.jpg",
                    "https://example.com/screenshot2.jpg"
                ],
            },
            "price": {
                "regular": 19.99,
                "extended": 29.99
            },
            "currency": "IDR",
            "published_at": "2024-04-27T12:00:00Z"
        },
        {
            // Next item...
        }
    ]
}

Error Response:

{
    "status": "error",
    "msg": "Tidak ada item yang ditemukan"
}

Dapatkan Detail Barang

Mengambil rincian item tertentu berdasarkan ID item dan kunci API yang diberikan.

Endpoint

GET
https://wisnyemil.my.id/api/items/item

Parameters

  • api_key: Your API key (Diperlukan)
  • item_id: ID item yang akan diambil (Diperlukan)

Responses

Success Response:

{
    "status": "success",
    "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", // Ini tidak termasuk untuk item audio
            "preview_video": "https://example.com/video.mp4", // Ini hanya berlaku untuk item video
            "preview_audio": "https://example.com/audio.mp3", // Ini hanya berlaku untuk item audio
            "screenshots": [ // Ini hanya disertakan jika item memiliki tangkapan layar
                "https://example.com/screenshot1.jpg",
                "https://example.com/screenshot2.jpg"
            ],
        },
        "price": {
            "regular": 19.99,
            "extended": 29.99
        },
        "currency": "IDR",
        "published_at": "2024-04-27T12:00:00Z"
    }
}

Error Response:

{
    "status": "error",
    "msg": "Barang Tidak Ditemukan"
}

Validasi Pembelian

Memvalidasi kode pembelian dan mengembalikan rincian tentang pembelian jika valid.

Endpoint

POST
https://wisnyemil.my.id/api/purchases/validation

Parameters

  • api_key: Your API key (Diperlukan).
  • purchase_code: Kode pembelian untuk memvalidasi (Diperlukan).

Responses

Success Response:

{
    "status": "success",
    "data": {
        "purchase": {
            "purchase_code": "abcdefghijklmnopqrstuvwxyz123456789",
            "license_type": "Regular",
            "price": 19.99,
            "currency": "IDR",
            "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", // Ini tidak termasuk untuk item audio
                    "preview_video": "https://example.com/video.mp4", // Ini hanya berlaku untuk item video
                    "preview_audio": "https://example.com/audio.mp3", // Ini hanya berlaku untuk item audio
                    "screenshots": [ Ini hanya disertakan jika item memiliki tangkapan layar
                        "https://example.com/screenshot1.jpg",
                        "https://example.com/screenshot2.jpg"
                    ],
                },
                "price": {
                    "regular": 19.99,
                    "extended": 29.99
                },
                "currency": "IDR",
                "published_at": "2024-04-27T12:00:00Z"
            },
            "supported_until": "2024-04-27T12:00:00Z", // Ini tidak akan ada jika dukungan dinonaktifkan atau tidak didukung
            "downloaded": false,
            "date": "2024-04-27T12:00:00Z"
        }
    }
}

Error Response:

{
    "status": "error",
    "msg": "Kode pembelian tidak valid"
}