SakuraAPI Official REST API Documentation (v1.0)

ឯកសារបច្ចេកទេស API សម្រាប់ Developer

មគ្គុទ្ទេសក៍សមាហរណកម្ម (Integration) សម្រាប់ភ្ជាប់ប្រព័ន្ធ Top-up ហ្គេមស្វ័យប្រវត្តិតាមរយៈ RESTful API ទៅកាន់ Website, Discord Bot, ឬ Telegram Bot របស់អ្នកយ៉ាងងាយស្រួល។

Swagger UI (សាកល្បង Live)ទទួលយក API Key

Base URL

https://sakuraapi.lol/api/v1

ល្បឿនបញ្ចូល

< 3.0 វិនាទី (Instant Auto)

សុវត្ថិភាពទិន្នន័យ

SHA-256 Bearer Token

Rate Limit

100 Requests / នាទី

ជ្រើសរើសភាសាកូដគំរូ (Code Language):

បញ្ជីមាតិកា (Navigation)

១. ចាប់ផ្ដើមរហ័ស (Overview)២. ការផ្ទៀងផ្ទាត់ (Authentication)៣. ឆែក Player ID (Check ID)៤. បញ្ជាទិញ Top-up (Create Order)៥. បញ្ជីហ្គេម & ស្តុក (Games Catalog)៦. កូដកំហុស (Error Responses)

១

ដំណើរការទូទៅ (How SakuraAPI Works)

របៀបដំណើរការប្រព័ន្ធ Top-up ហ្គេមស្វ័យប្រវត្តិតាមរយៈ API

SakuraAPI ផ្ដល់ជូននូវ Gateway សម្រាប់តំណាងចែកចាយ (Resellers) ធ្វើការកុម្ម៉ង់បញ្ចូលពេជ្រ និង UC ទៅក្នុងគណនីអតិថិជនដោយស្វ័យប្រវត្តិតាមរយៈ HTTP REST requests 100% គ្មានការរង់ចាំដោយដៃ។

ជំហានទាំង ៣ ដើម្បីចាប់ផ្ដើមសមាហរណកម្ម (Integration Steps)៖

បង្កើត API Key៖ ចូលទៅកាន់ទំព័រ API Access ដើម្បីបង្កើត Production Live API Key ផ្ទាល់ខ្លួន។
ផ្ទៀងផ្ទាត់ Player ID៖ ហៅ Endpoint POST /api/v1/games/check-id ដើម្បីបញ្ជាក់ឈ្មោះ In-game Name របស់អតិថិជន។
បង្កើត Order Top-up៖ ហៅ Endpoint POST /api/v1/orders ដើម្បីកាត់ទឹកប្រាក់ក្នុងកាបូប និងបញ្ជូនពេជ្រចូលភ្លាមៗ។

២

ការផ្ទៀងផ្ទាត់សិទ្ធិ (Authentication)

ប្រើប្រាស់ Bearer Token ក្នុង HTTP Header លើគ្រប់ API Requests

រាល់ API Request ទាំងអស់ដែលផ្ញើមកកាន់ SakuraAPI ត្រូវតែភ្ជាប់មកជាមួយ API Key របស់អ្នកនៅក្នុង HTTP Header Authorization៖

Authorization: Bearer sk_live_your_api_key_hereStandard Header

កូដគំរូពិនិត្យគណនី Reseller (curl)៖

curl -X GET https://sakuraapi.lol/api/v1/reseller/me \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json"

POST/api/v1/games/check-id

Auto Username Validator

ប្រើប្រាស់ Endpoint នេះដើម្បីឆែកស្វែងរកឈ្មោះ In-game Name របស់តួអង្គហ្គេម មុនពេលអតិថិជនចុចទិញ ដើម្បីកាត់បន្ថយបញ្ហាក្នុងការវាយខុស ID ឬ Server ID។

ប៉ារ៉ាម៉ែត្រក្នុង Request Body (JSON)៖

Field	Type	Required	Description
game	string	Yes	កូដសម្គាល់ហ្គេម (ឧ. `mobile-legends`, `free-fire`)
userid	string	Yes	Player ID ឬ User ID របស់អ្នកលេង
serverid	string	Optional	Zone ID (តម្រូវការចាំបាច់សម្រាប់តែ Mobile Legends និង Genshin)

កូដគំរូ Request (curl)៖

curl -X POST https://sakuraapi.lol/api/v1/games/check-id \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "game": "mobile-legends",
    "userid": "1473883595",
    "serverid": "14309"
  }'

ការឆ្លើយតបជោគជ័យ (HTTP 200 OK)៖

{
  "success": true,
  "data": {
    "valid": true,
    "username": "SakuraMaster99",
    "region": "Cambodia (Asia)",
    "gameTitle": "Mobile Legends: Bang Bang",
    "userId": "1473883595",
    "serverId": "14309",
    "message": "Player ID verified successfully"
  }
}

POST/api/v1/orders

Instant Top-up Gateway

បង្កើត Order បញ្ចូលពេជ្រដោយស្វ័យប្រវត្តិ។ ប្រព័ន្ធនឹងកាត់ទឹកប្រាក់ក្នុងកាបូប Reseller Balance ភ្លាមៗ និងផ្ញើការបញ្ចូលទៅ Provider ក្នុងរយៈពេលក្រោម 3 វិនាទី។ ប្រសិនបើតួអង្គមិនត្រឹមត្រូវ ប្រព័ន្ធនឹង Auto-Refund បង្វិលលុយចូលគណនីវិញភ្លាមៗ 100%។

Field	Type	Required	Description
game	string	Yes	កូដហ្គេម (ឧ. `mobile-legends`)
product_code	string	Yes	កូដកញ្ចប់ពេជ្រ (ឧ. `mlbb-86`)
userid	string	Yes	Player ID របស់អតិថិជន
serverid	string	Optional	Zone ID (សម្រាប់ MLBB / Genshin)
reseller_order_id	string	Yes	លេខសម្គាល់ Order ផ្ទាល់ខ្លួនរបស់អ្នក (ការពារការបញ្ជាទិញស្ទួន Idempotency)

កូដគំរូ Request (curl)៖

curl -X POST https://sakuraapi.lol/api/v1/orders \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "game": "mobile-legends",
    "product_code": "mlbb-86",
    "userid": "1473883595",
    "serverid": "14309",
    "reseller_order_id": "ORD-20260930-001"
  }'

ការឆ្លើយតបជោគជ័យ (HTTP 201 Created)៖

{
  "success": true,
  "data": {
    "order_id": "SK-20260930-8849",
    "reseller_order_id": "ORD-20260930-001",
    "game": "Mobile Legends: Bang Bang",
    "product": "86 Diamonds",
    "amount": "1.45",
    "currency": "USD",
    "status": "SUCCESS",
    "created_at": "2026-09-30T12:00:00.000Z"
  }
}

GET/api/v1/games

Live Stock & Products

ទាញយកបញ្ជីហ្គេម និងកញ្ចប់ពេជ្រទាំងអស់ដែលកំពុងដំណើរការ រួមទាំងតម្លៃ Reseller Cost ដើម្បីដាក់បញ្ចូលលើ Website ឬ Telegram Bot របស់អ្នកដោយស្វ័យប្រវត្តិ។

កូដគំរូ Request (curl)៖

curl -X GET https://sakuraapi.lol/api/v1/games \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

កូដកំហុសទូទៅ (Error Codes & Responses)

រចនាសម្ព័ន្ធនៃកំហុសស្តង់ដារដែលប្រព័ន្ធអាចបញ្ជូនត្រឡប់មកវិញ

SakuraAPI ប្រើប្រាស់ទម្រង់ JSON ស្តង់ដាររួមមួយសម្រាប់រាល់ Error Responses ដើម្បីងាយស្រួលចាប់ក្នុង Try/Catch block របស់អ្នក៖

HTTP Status	Error Code	មូលហេតុ & ដំណោះស្រាយ (Khmer Explanation)
401 Unauthorized	INVALID_API_KEY	API Key មិនត្រឹមត្រូវ ផុតកំណត់ ឬត្រូវបានលុបចោល (Revoked)។
402 Payment Required	INSUFFICIENT_BALANCE	សមតុល្យក្នុងកាបូប Reseller មិនគ្រប់គ្រាន់សម្រាប់កុម្ម៉ង់កញ្ចប់នេះឡើយ។ សូមបញ្ចូលសមតុល្យបន្ថែម។
409 Conflict	DUPLICATE_ORDER	លេខសម្គាល់ `reseller_order_id` នេះត្រូវបានដំណើរការរួចរាល់ហើយ មិនអាចបញ្ជូនស្ទួនបានទេ។
429 Too Many Requests	RATE_LIMITED	ចំនួន Requests លើសពីកូតាកំណត់ 100 requests / នាទី។ សូមពន្យារពេលបន្តិចមុនហៅម្ដងទៀត។