Gambaran Umum Dokumen API

1. Dapatkan Detail Akun

Endpoint: GET https://lapakmarket.com/api/account/details

Deskripsi: Mengambil detail akun yang terkait dengan key API yang diberikan.

2. Dapatkan Semua Produk

Endpoint: GET https://lapakmarket.com/api/items/all

Deskripsi: Mengambil semua item yang terkait dengan key API yang diberikan.

3. Lihat Detail Produk

Endpoint: GET https://lapakmarket.com/api/items/item

Deskripsi: Mengambil detail suatu item tertentu berdasarkan ID item dan key API yang diberikan.

4. Validasi Pembelian

Endpoint: POST https://lapakmarket.com/api/purchases/validation

Deskripsi: Memverifikasi kode pembelian dan menampilkan detail pembelian tersebut jika kode tersebut valid.

Otentikasi

Buka Pengaturan Workspace

Pengguna harus terlebih dahulu login ke akun di platform tersebut. Setelah itu, mereka dapat membuka bagian “Pengaturan” di workspace.

Lihat Bagian Key API

Di dalam pengaturan workspace, pengguna harus mencari bagian yang secara khusus diberi label “Key API” atau “Akses API.”

Buat atau Ambil Key API

Di bagian ini, pengguna dapat membuat key API baru atau mengambil key yang sudah ada jika sebelumnya telah dibuat. Jika terdapat opsi untuk membuat key baru, pengguna dapat mengklik opsi tersebut untuk membuat key API baru.

Salin Key API

Setelah key API dibuat atau diambil, pengguna seharusnya dapat melihatnya ditampilkan di layar. Mereka cukup mengklik tombol atau ikon di sebelah key tersebut untuk menyalinnya ke clipboard.

Gunakan Key API

Setelah key API disalin, pengguna kini dapat menggunakan untuk mengautentikasi permintaan mereka saat mengakses endpoint API platform. Biasanya, mereka perlu menyertakan key API tersebut sebagai bagian dari header atau parameter permintaan, tergantung pada mekanisme otentikasi API yang digunakan.

Amankan Key API

Sangat penting untuk mengingatkan pengguna agar menjaga keamanan key API mereka dan tidak membagikan secara terbuka. Mereka sebaiknya menghindari penulisan key API secara langsung dalam kode sisi klien atau membagikan di repositori yang dapat diakses publik. Sebaliknya, mereka sebaiknya mempertimbangkan untuk menyimpan key API tersebut dengan aman di aplikasi sisi server mereka dan menerapkan kontrol akses yang sesuai.

Dapatkan Detail Akun

Mengambil detail akun yang terkait dengan key API yang diberikan

Endpoint


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

Parameter

api_key: Key API Anda (Wajib)

Respon

Respon Sukses:


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

Respon Kesalahan:


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

Dapatkan Semua Produk

Mengambil semua item yang terkait dengan key API yang diberikan

Fitur ini hanya berlaku untuk penulis dan tidak berlaku untuk pengguna biasa.

Endpoint


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

Parameter

api_key: Key API Anda (Wajib)

Respon

Respon Sukses:


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

Respon Kesalahan:


            {
    "status": "error",
    "msg": "Tidak ditemukan produk"
}

Lihat Detail Produk

Mengambil detail suatu item tertentu berdasarkan ID item dan key API yang diberikan.

Fitur ini hanya berlaku untuk penulis dan tidak berlaku untuk pengguna biasa.

Endpoint


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

Parameter

api_key: Key API Anda (Wajib)
item_id: ID produk akan diambil (Wajib)

Respon

Respon Sukses:


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

Respon Kesalahan:


            {
    "status": "error",
    "msg": "Item Not Found"
}

Validasi Pembelian

Memverifikasi kode pembelian dan menampilkan detail pembelian tersebut jika kode tersebut valid.

Fitur ini hanya berlaku untuk penulis dan tidak berlaku untuk pengguna biasa.

Endpoint


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

Parameter

api_key: Key API Anda (Wajib).
purchase_code: Kode pembelian harus diverifikasi (Wajib).

Respon

Respon Sukses:


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

Respon Kesalahan:


            {
    "status": "error",
    "msg": "Invalid purchase code"
}