ภาพรวมเอกสารคู่มือการใช้งาน API

1. ดึงข้อมูลรายละเอียดบัญชี

Endpoint: GET https://devil-yqrm.website/api/account/details

คำอธิบาย: ดึงข้อมูลรายละเอียดบัญชีที่เชื่อมโยงกับรหัส API ที่คุณให้ไว้

2. ดึงข้อมูลรายการสินค้าทั้งหมด

Endpoint: GET https://devil-yqrm.website/api/items/all

คำอธิบาย: ดึงข้อมูลรายการสินค้าทั้งหมดที่เชื่อมโยงกับรหัส API ที่คุณให้ไว้

3. ดึงข้อมูลรายละเอียดของสินค้าแต่ละรายการ

Endpoint: GET https://devil-yqrm.website/api/items/item

คำอธิบาย: ดึงรายละเอียดของไอเทมที่ต้องการ โดยใช้ Item ID และ API key

4. ตรวจสอบการซื้อ

Endpoint: POST https://devil-yqrm.website/api/purchases/validation

คำอธิบาย: ตรวจสอบรหัสการซื้อและส่งรายละเอียดเกี่ยวกับการซื้อหากถูกต้อง

การยืนยันตัวตน

ไปที่หน้าตั้งค่า

เริ่มจากล็อกอินเข้าบัญชีของคุณ จากนั้นไปที่ส่วน "ตั้งค่า"

มองหาส่วน API Key

ในหน้าตั้งค่า ให้มองหาส่วนที่ชื่อว่า "API Key" หรือ "การเข้าถึง API"

สร้างหรือดู API Key

ในส่วนนี้ คุณสามารถสร้าง API Key ใหม่ หรือถ้าเคยสร้างไว้แล้ว ก็สามารถกลับมาดู Key เดิมได้

คัดลอก API Key

เมื่อสร้างหรือได้ API Key มาแล้ว คุณจะเห็น Key ปรากฏบนหน้าจอ สามารถคลิกที่ปุ่มหรือไอคอนข้าง ๆ Key เพื่อคัดลอกได้เลย

ใช้ API Key

เมื่อคัดลอก API Key แล้ว คุณสามารถนำไปใช้ยืนยันตัวตนในการเข้าถึง API ของแพลตฟอร์มได้ โดยจะต้องใส่ Key ในส่วนหัวของคำขอ (Request Header) หรือพารามิเตอร์ ขึ้นอยู่กับวิธีการยืนยันตัวตนของ API

เก็บ API Key ให้ปลอดภัย

สำคัญมาก! อย่าลืมเก็บ API Key ของคุณให้ปลอดภัย และอย่าเปิดเผยต่อสาธารณะ หลีกเลี่ยงการใส่ Key ไว้ในโค้ดฝั่ง Client หรือแชร์ในที่ที่ใคร ๆ ก็เข้าถึงได้ ควรเก็บ Key ไว้อย่างปลอดภัยในแอปพลิเคชันฝั่ง Server และควบคุมการเข้าถึงให้เหมาะสม

ดึงข้อมูลบัญชี

ดึงรายละเอียดบัญชีที่เชื่อมโยงกับ API key ที่ให้มา

Endpoint

GET
https://devil-yqrm.website/api/account/details

พารามิเตอร์

  • api_key: Your API key (required)

Responses

การตอบกลับสำเร็จ:

{
    "status": "success",
    "data": {
        "name": {
            "firstname": "John",
            "lastname": "Doe",
            "full_name": "John Doe"
        },
        "username": "johndoe",
        "email": "[email protected]",
        "balance": 100.00,
        "currency": "THB",
        "profile": {
            "heading": "Profile Heading",
            "description": "Profile Description",
            "contact": {
                "email": "[email protected]"
            },
            "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"
    }
}

การตอบกลับมีข้อผิดพลาด:

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

ดึงข้อมูลสินค้าทั้งหมด

ดึงข้อมูลสินค้าทั้งหมดที่เชื่อมโยงกับ API key ที่ระบุ

Endpoint

GET
https://devil-yqrm.website/api/items/all

พารามิเตอร์

  • api_key: Your API key (required)

Responses

การตอบกลับสำเร็จ:

{
    "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", // 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": "THB",
            "published_at": "2024-04-27T12:00:00Z"
        },
        {
            // Next item...
        }
    ]
}

การตอบกลับมีข้อผิดพลาด:

{
    "status": "error",
    "msg": "No Items Found"
}

ดึงข้อมูลรายละเอียดสินค้า

ดึงรายละเอียดของไอเทมที่ต้องการ โดยใช้ Item ID และ API key

Endpoint

GET
https://devil-yqrm.website/api/items/item

พารามิเตอร์

  • api_key: Your API key (required)
  • item_id: ID ของไอเทมที่ต้องการ (required)

Responses

การตอบกลับสำเร็จ:

{
    "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", // 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": "THB",
        "published_at": "2024-04-27T12:00:00Z"
    }
}

การตอบกลับมีข้อผิดพลาด:

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

ตรวจสอบการซื้อ

ตรวจสอบรหัสการซื้อและส่งรายละเอียดเกี่ยวกับการซื้อหากถูกต้อง

Endpoint

POST
https://devil-yqrm.website/api/purchases/validation

พารามิเตอร์

  • api_key: Your API key (required).
  • purchase_code: รหัสการซื้อเพื่อยืนยัน (required).

Responses

การตอบกลับสำเร็จ:

{
    "status": "success",
    "data": {
        "purchase": {
            "purchase_code": "abcdefghijklmnopqrstuvwxyz123456789",
            "license_type": "Regular",
            "price": 19.99,
            "currency": "THB",
            "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": "THB",
                "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"
        }
    }
}

การตอบกลับมีข้อผิดพลาด:

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