អ្នកផ្តល់សេវាដែលឆបគ្នានឹង PerfectPanel API
ភ្ជាប់បន្ទះរបស់អ្នកទៅ BEE-TH.COM
ឯកសារយោងដែលត្រៀមរួចជាស្រេចសម្រាប់ការផលិតសម្រាប់សេវាកម្មនាំចូល ការបញ្ជាទិញ តាមដានការដឹកជញ្ជូន ស្នើសុំការលុបចោល និងការអានសមតុល្យប្រាក់បាតរបស់អ្នក។
- វិធីសាស្ត្រ HTTP
- POST
- ចំណុចបញ្ចប់ API
- https://api.bee-th.com/api/v2
- ឈ្មោះក្លែងក្លាយដែលត្រូវគ្នា។
- https://api.bee-th.com/api/v1
- ទម្រង់ឆ្លើយតប
- JSON
ចាប់ផ្តើម
ភ្ជាប់ជាបីជំហាន
ប្រើ API URL និងកូនសោដូចគ្នានៅក្នុង PerfectPanel ឬម៉ាស៊ីនភ្ញៀវណាដែលគាំទ្រទ្រង់ទ្រាយ API បន្ទះ SMM ទូទៅ។
- 1
បង្កើតកូនសោរបស់អ្នក។
បង្កើតគណនីមួយ បន្ទាប់មកបង្កើតសោ API ពី Profile ។ គន្លឹះពេញលេញត្រូវបានបង្ហាញតែម្តងប៉ុណ្ណោះ។
- 2
កំណត់រចនាសម្ព័ន្ធបន្ទះរបស់អ្នក។
បន្ថែមចំណុចបញ្ចប់ API ជាអ្នកផ្តល់សេវា URL នៅក្នុង PerfectPanel ហើយបិទភ្ជាប់សោ BEE-TH.COM API របស់អ្នក។
- 3
ដំណើរការការធ្វើតេស្តផ្សែង
ស្នើសុំសមតុល្យរបស់អ្នក បន្ទាប់មកនាំចូលសេវាកម្ម។ ការឆ្លើយតបសមតុល្យ JSON បញ្ជាក់ពីការតភ្ជាប់។
ប្រើ https://api.bee-th.com/api/v2 ជាចំណុចបញ្ចប់ចម្បង។ ប្រសិនបើបន្ទះអ្នកផ្តល់សេវាភ្ជាប់តាមរយៈ API កំណែ 1 សូមប្រើ https://api.bee-th.com/api/v1. ចំណុចបញ្ចប់ទាំងពីរប្រើគ្រាប់ចុច API ដូចគ្នា ហើយត្រឡប់ទិន្នន័យសេវាកម្មដូចគ្នា។
curl -X POST "https://api.bee-th.com/api/v2" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "key=$BEE_TH_API_KEY" \
-d "action=balance"សន្តិសុខ
ផ្ទៀងផ្ទាត់រាល់សំណើ
ផ្ញើកូនសោ API របស់អ្នកនៅក្នុងវាលទម្រង់ឈ្មោះកូនសោ។ គន្លឹះកំណត់គណនីសមាជិក តម្លៃ កាបូប និងការបញ្ជាទិញដែលប្រើដោយការស្នើសុំ។
វដ្តជីវិតសំខាន់ៗ
គ្រាប់ចុច API មួយអាចសកម្មក្នុងមួយគណនី។ ការបង្វិល ឬដកវាចេញភ្លាមៗ ធ្វើឱ្យសោពីមុនមានសុពលភាព។ BEE-TH.COM រក្សាទុកតែលេខកូដសម្ងាត់ប៉ុណ្ណោះ។
ដែនកំណត់អត្រា
action=services ត្រូវបានកំណត់ 120 សំណើក្នុងមួយនាទី សម្រាប់សមាជិក និង IP ប្រភពនីមួយៗ ដើម្បីការពារការនាំចូលកាតាឡុកញឹកញាប់ពេក។ balance, status, add និង cancel មិនប្រើដែនកំណត់ API តាមសមាជិកនេះទេ; queue backpressure និងការការពារហេដ្ឋារចនាសម្ព័ន្ធនៅតែអនុវត្ត។
SERVICES
បញ្ជីសេវាកម្ម
នាំចូលសេវាកម្ម និងតម្លៃជាក់លាក់សម្រាប់សមាជិកបច្ចុប្បន្នដែលមានក្នុងគណនីនេះ។
https://api.bee-th.com/api/v2action=services| ប៉ារ៉ាម៉ែត្រ | ប្រភេទ | ការពិពណ៌នា |
|---|---|---|
| key | string | លេខកូដ API សមាជិក BEE-TH.COM ឯកជនរបស់អ្នក។ |
| action | "services" | ត្រូវតែជាសេវាកម្មតម្លៃតាមព្យញ្ជនៈ។ |
curl -X POST "https://api.bee-th.com/api/v2" \
-d "key=$BEE_TH_API_KEY" \
-d "action=services"ការឆ្លើយតបឧទាហរណ៍
[
{
"service": 123,
"name": "ผู้ติดตาม Instagram — เสถียร",
"nameEn": "Instagram followers — stable",
"descriptionEn": "Stable delivery with refill support.",
"type": "Default",
"rate": 42,
"min": 100,
"max": 10000,
"dripfeed": false,
"refill": true,
"warrantyEnabled": true,
"warrantyDays": 30,
"cancel": true,
"category": "บริการ Instagram ประเทศไทย",
"categoryEn": "บริการ Instagram ประเทศไทย"
},
{
"service": 124,
"name": "ความคิดเห็นกำหนดเอง",
"nameEn": "Custom comments",
"descriptionEn": null,
"type": "Custom Comments",
"rate": 85,
"min": 10,
"max": 1000,
"dripfeed": false,
"refill": false,
"warrantyEnabled": false,
"warrantyDays": 0,
"cancel": false,
"category": "บริการ Instagram ประเทศไทย",
"categoryEn": "บริการ Instagram ประเทศไทย"
}
]សេវាកម្មគឺជាលេខសម្គាល់អចិន្ត្រៃយ៍ដែលត្រូវបានបែងចែកដោយ BEE-TH.COM និងមិនអាស្រ័យលើលេខសម្គាល់អ្នកផ្តល់សេវាទេ។ ប្រភេទ និងប្រភេទEn មានក្រុមសេវាកម្ម។ អត្រា អប្បបរមា និងអតិបរមាគឺជាលេខ JSON ខណៈពេលដែល dripfeed បំពេញបន្ថែម និងលុបចោលការបោះពុម្ពផ្សាយសមត្ថភាពសេវាកម្មដែលមានប្រសិទ្ធភាព។
រាល់ការស្នើសុំត្រឡប់តម្លៃសមាជិកចុងក្រោយ ដែនកំណត់ និងបញ្ជីសេវាកម្មដែលមានដោយមិនចាំបាច់ប្រើឃ្លាំងសម្ងាត់ឆ្លើយតប។ ប្រព័ន្ធ Downstream អាចស្ទង់មតិសកម្មភាពសេវាកម្មដើម្បីធ្វើសមកាលកម្មទិន្នន័យ។ ប្រេកង់បោះឆ្នោត និងថាតើការត្រួតពិនិត្យការធ្វើសមកាលកម្មត្រូវបានបើកអាស្រ័យលើអាដាប់ទ័រខាងក្រោម។
warrantyEnabled and warrantyDays publish the guarantee configured by the v2 Pumlike admin. Disabled guarantees return false and 0. Downstream sites use this policy but manage their own requests, approvals, rejections, and refill orders. These fields do not enable API refill requests and are separate from the existing refill capability.
ADD
បន្ថែមការបញ្ជាទិញ
បង្កើតការបញ្ជាទិញសម្រាប់សេវាកម្មដែលបានបោះផ្សាយ ហើយដកប្រាក់កាបូបសមាជិកដោយប្រើតម្លៃជាក់លាក់របស់សមាជិកបច្ចុប្បន្ន។
https://api.bee-th.com/api/v2action=add| ប៉ារ៉ាម៉ែត្រ | ប្រភេទ | ការពិពណ៌នា |
|---|---|---|
| key | string | លេខកូដ API សមាជិក BEE-TH.COM ឯកជនរបស់អ្នក។ |
| action | "add" | ត្រូវតែជាតម្លៃបន្ថែមតាមព្យញ្ជនៈ។ |
| service | integer | លេខសម្គាល់សេវាកម្មជាលេខអចិន្ត្រៃយ៍បានប្រគល់មកវិញដោយសកម្មភាពសេវាកម្ម។ |
| link | URL | គោលដៅសាធារណៈ URL សម្រាប់ទំព័រ ប្រកាស ប្រវត្តិរូប ឬប្រព័ន្ធផ្សព្វផ្សាយ។ |
| quantity | integer | ទាមទារសម្រាប់សេវាកម្មលំនាំដើម។ ចំនួនទឹកប្រាក់ដែលបានស្នើសុំត្រូវតែស្ថិតនៅក្នុងកម្រិតអប្បបរមា និងអតិបរមានៃសេវាកម្ម។ |
| comments | string | ទាមទារសម្រាប់សេវាកម្មមតិយោបល់ផ្ទាល់ខ្លួន។ ផ្ញើមតិយោបល់មួយក្នុងមួយជួរ; បរិមាណត្រូវបានគណនាពីបន្ទាត់មិនទទេ។ |
សេវាកម្មលំនាំដើម
curl -X POST "https://api.bee-th.com/api/v2" \
-d "key=$BEE_TH_API_KEY" \
-d "action=add" \
-d "service=123" \
--data-urlencode "link=https://example.com/post" \
-d "quantity=1000"សេវាកម្មយោបល់ផ្ទាល់ខ្លួន
curl -X POST "https://api.bee-th.com/api/v2" \
-d "key=$BEE_TH_API_KEY" \
-d "action=add" \
-d "service=124" \
--data-urlencode "link=https://example.com/post" \
--data-urlencode $'comments=មតិទីមួយ\nមតិទីពីរ'{
"order": 9001
}សម្រាប់មតិយោបល់ផ្ទាល់ខ្លួន សូមលុបចោលបរិមាណ ហើយផ្ញើមតិយោបល់ជាអត្ថបទដាច់ដោយឡែកពីបន្ទាត់ថ្មី។ BEE-TH.COM កាត់បន្ទាត់ទទេ ហើយប្រើចំនួនបន្ទាត់ដែលនៅសល់ជាបរិមាណបញ្ជាទិញ។
ព្យាយាមម្តងទៀតបន្ទាប់ពីការដឹកជញ្ជូនបរាជ័យ នៅពេលអ្នកប្រាកដថាគ្មានលេខបញ្ជាទិញត្រូវបានប្រគល់មកវិញទេ។ សម្រាប់ការរួមបញ្ចូលដែលតម្រូវឱ្យមានការព្យាយាមឡើងវិញដោយមានការធានា សូមប្រើចំណុចបញ្ចប់នៃការបញ្ជាទិញ REST ។
STATUS
ស្ថានភាពបញ្ជាទិញ
អានការបញ្ជាទិញមួយ ឬរហូតដល់ 100 ការបញ្ជាទិញដែលជាកម្មសិទ្ធិរបស់ម្ចាស់សោ API ។
https://api.bee-th.com/api/v2action=status| ប៉ារ៉ាម៉ែត្រ | ប្រភេទ | ការពិពណ៌នា |
|---|---|---|
| key | string | លេខកូដ API សមាជិក BEE-TH.COM ឯកជនរបស់អ្នក។ |
| action | "status" | ត្រូវតែជាស្ថានភាពតម្លៃព្យញ្ជនៈ។ |
| order | integer | លេខបញ្ជាទិញ BEE-TH.COM មួយ។ កុំផ្ញើជាមួយការបញ្ជាទិញ។ |
| orders | string | លេខលំដាប់ដែលបំបែកដោយសញ្ញាក្បៀស រហូតដល់ 100។ កុំផ្ញើរួមគ្នាជាមួយការបញ្ជាទិញ។ |
ផ្ញើទាំងការបញ្ជាទិញឬការបញ្ជាមិនដែលបានទាំងពីរ។ ការឆ្លើយតបការបញ្ជាទិញច្រើនត្រូវបានចុចដោយលេខបញ្ជាទិញដែលបានស្នើសុំ។
# ការបញ្ជាទិញតែមួយ
curl -X POST "https://api.bee-th.com/api/v2" \
-d "key=$BEE_TH_API_KEY" -d "action=status" -d "order=9001"
# ការបញ្ជាទិញច្រើន។
curl -X POST "https://api.bee-th.com/api/v2" \
-d "key=$BEE_TH_API_KEY" -d "action=status" -d "orders=9001,9002"{
"9001": {
"charge": "42",
"start_count": "1250",
"status": "In progress",
"remains": "600",
"currency": "THB"
},
"9002": {"error": "Incorrect order ID"}
}តម្លៃស្ថានភាព
| ស្ថានភាព | ការពិពណ៌នា |
|---|---|
| Pending | បានទទួលហើយ រង់ចាំការបញ្ជូន ឬដំណើរការ។ |
| Processing | ដាក់ស្នើ និងរៀបចំដោយអ្នកផ្តល់សេវា។ |
| In progress | ការដឹកជញ្ជូនកំពុងដំណើរការ។ |
| Completed | បរិមាណដែលបានស្នើរសុំពេញលេញត្រូវបានចែកចាយ។ |
| Partial | ផ្នែកនៃការបញ្ជាទិញត្រូវបានប្រគល់ជូន ហើយនៅសល់ដែលមិនទាន់បានប្រគល់ជូនត្រូវបានសងប្រាក់វិញ។ |
| Canceled | ការបញ្ជាទិញត្រូវបានលុបចោល ឬបរាជ័យ ហើយសមតុល្យដែលពាក់ព័ន្ធត្រូវបានបង្វិលសងវិញ។ |
CANCEL
បោះបង់ការបញ្ជាទិញ
ស្នើសុំការលុបចោលសម្រាប់ការបញ្ជាទិញសកម្មរហូតដល់ 100 ដែលសេវាកម្មរបស់ពួកគេផ្សាយពាណិជ្ជកម្មលុបចោល៖ ពិត។
https://api.bee-th.com/api/v2action=cancel| ប៉ារ៉ាម៉ែត្រ | ប្រភេទ | ការពិពណ៌នា |
|---|---|---|
| key | string | លេខកូដ API សមាជិក BEE-TH.COM ឯកជនរបស់អ្នក។ |
| action | "cancel" | ត្រូវតែជាតម្លៃព្យញ្ជនៈបោះបង់។ |
| orders | string | លេខលំដាប់ដែលបំបែកដោយសញ្ញាក្បៀសដើម្បីលុបចោល រហូតដល់ 100។ |
curl -X POST "https://api.bee-th.com/api/v2" \
-d "key=$BEE_TH_API_KEY" \
-d "action=cancel" \
-d "orders=9001,9002"[
{"order": 9001, "cancel": 1},
{"order": 9002, "cancel": {"error": "Error calling provider"}}
]បោះបង់៖ 1 មានន័យថាសំណើលុបចោលត្រូវបានទទួលយក។ វាអាចនៅតែរង់ចាំខណៈពេលដែលអ្នកផ្តល់សេវាខាងលើ ឬក្រុមប្រតិបត្តិការ BEE-TH.COM បញ្ចប់វា។ បន្តស្ថានភាពលំដាប់បោះឆ្នោតសម្រាប់លទ្ធផលចុងក្រោយ។
BALANCE
សមតុល្យអ្នកប្រើប្រាស់
ត្រឡប់សមតុល្យកាបូបសមាជិកដែលមានជាខ្សែទសភាគជាប្រាក់បាត។
https://api.bee-th.com/api/v2action=balance| ប៉ារ៉ាម៉ែត្រ | ប្រភេទ | ការពិពណ៌នា |
|---|---|---|
| key | string | លេខកូដ API សមាជិក BEE-TH.COM ឯកជនរបស់អ្នក។ |
| action | "balance" | ត្រូវតែជាតុល្យភាពតម្លៃព្យញ្ជនៈ។ |
curl -X POST "https://api.bee-th.com/api/v2" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "key=$BEE_TH_API_KEY" \
-d "action=balance"{
"balance": "1250.7500",
"currency": "THB"
}ការដោះស្រាយកំហុស
កំហុសប្រើប្រាស់ទម្រង់ JSON ដែលអាចព្យាករណ៍បាន។
ការឆ្លើយតបដែលឆបគ្នានឹង PerfectPanel ត្រឡប់វាលកំហុសជំនួសឱ្យការផ្ទុកដែលទទួលបានជោគជ័យ។ សកម្មភាពភាគច្រើនរាយការណ៍អំពីកំហុសលើការបញ្ជាទិញដែលរងផលប៉ះពាល់ ដូច្នេះធាតុផ្សេងទៀតនៅតែអាចទទួលបានជោគជ័យ។
| កំហុស | អត្ថន័យ |
|---|---|
| Invalid API key | សោបាត់ ខូចទ្រង់ទ្រាយ ដកហូត ឬមិនត្រូវគ្នានឹងសមាជិកសកម្ម។ |
| Too many requests | ដែនកំណត់អត្រាការអាន ឬការផ្លាស់ប្តូរបច្ចុប្បន្នត្រូវបានលើស។ |
| Invalid request parameters | សកម្មភាព ឬប៉ារ៉ាម៉ែត្រដែលត្រូវការរបស់វាមួយត្រូវបានបាត់ ឬខុសទម្រង់។ |
| Service not found | លេខសម្គាល់សេវាសាធារណៈមិនមាន ឬមិនមាន។ |
| Incorrect order ID | ការបញ្ជាទិញមិនមានទេ ឬជាកម្មសិទ្ធិរបស់សមាជិកផ្សេងទៀត។ |
| Insufficient balance | កាបូបមិនមានសមតុល្យប្រាក់បាតគ្រប់គ្រាន់ទេ។ |
| Invalid quantity | បរិមាណគឺលើសពីសេវាកម្មអប្បបរមា ឬអតិបរមា។ |
| Error calling provider | សេវាកម្ម ឬស្ថានភាពការបញ្ជាទិញបច្ចុប្បន្នមិនអនុញ្ញាតឱ្យលុបចោលទេ។ |
PHP
បំពេញឧទាហរណ៍ PHP
ម៉ាស៊ីនភ្ញៀវតូចនេះរក្សាការផ្ទៀងផ្ទាត់ TLS បើកដំណើរការ ប្រើការតភ្ជាប់ និងសំណើអស់ពេល ហើយបោះចោលនៅពេលដែល API ត្រឡប់កំហុស។
<?php
final class BeeThApi {
public function __construct(
private string $apiUrl,
private string $apiKey,
) {}
public function call(string $action, array $parameters = []): array {
$handle = curl_init($this->apiUrl);
curl_setopt_array($handle, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POSTFIELDS => http_build_query([
'key' => $this->apiKey,
'action' => $action,
...$parameters,
]),
CURLOPT_CONNECTTIMEOUT => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_SSL_VERIFYPEER => true,
CURLOPT_HTTPHEADER => ['Accept: application/json'],
]);
$body = curl_exec($handle);
if ($body === false) {
throw new RuntimeException(curl_error($handle));
}
$result = json_decode($body, true, flags: JSON_THROW_ON_ERROR);
if (isset($result['error'])) {
throw new RuntimeException((string) $result['error']);
}
return $result;
}
}
$api = new BeeThApi('https://api.bee-th.com/api/v2', getenv('BEE_TH_API_KEY'));
$services = $api->call('services');
$order = $api->call('add', [
'service' => 123,
'link' => 'https://example.com/post',
'quantity' => 1000,
]);
$commentOrder = $api->call('add', [
'service' => 124,
'link' => 'https://example.com/post',
'comments' => "First comment\nSecond comment",
]);
$status = $api->call('status', ['order' => $order['order']]);
$statuses = $api->call('status', ['orders' => '9001,9002']);
$cancellations = $api->call('cancel', ['orders' => '9001,9002']);REST API
កម្រិតខ្ពស់ REST API
ប្រើចំណុចប្រទាក់ REST សម្រាប់ការរួមបញ្ចូលម៉ាស៊ីនមេផ្ទាល់ខ្លួន ដែលទទួលបានអត្ថប្រយោជន៍ពីកូដស្ថានភាព HTTP ស្រោមសំបុត្រឆ្លើយតបស្រប និងការបង្កើតការបញ្ជាទិញដែលមិនមានសក្តានុពល។
| វិធីសាស្រ្ត | ចំណុចបញ្ចប់ | គោលបំណង |
|---|---|---|
| GET | /api/v1/member/services | រាយបញ្ជីសេវាកម្មដែលមាន |
| GET | /api/v1/member/balance | អានសមតុល្យកាបូប |
| POST | /api/v1/member/orders | បង្កើតការបញ្ជាទិញដែលមិនមានអំណាច |
| GET | /api/v1/member/orders/{orderNumber} | អានលំដាប់មួយ។ |
curl "https://bee-th.com/api/v1/member/services?locale=km" \
-H "Authorization: Bearer $BEE_TH_API_KEY"
curl -X POST "https://bee-th.com/api/v1/member/orders" \
-H "Authorization: Bearer $BEE_TH_API_KEY" \
-H "Idempotency-Key: merchant-order-2026-0001" \
-H "Content-Type: application/json" \
-d '{"serviceId":123,"targetUrl":"https://example.com/post","quantity":1000}'ការផ្ទៀងផ្ទាត់អ្នកកាន់
ផ្ញើលេខសោសមាជិកដូចគ្នានៅក្នុងការអនុញ្ញាត៖ Bearer <key> ។ ចំណុចបញ្ចប់ REST ត្រឡប់ HTTP 401, 403, 422, ឬ 429 នៅពេលដែលអាចអនុវត្តបាន។
សាកល្បងដោយសុវត្ថិភាព
រាល់សំណើបញ្ជាទិញ REST ត្រូវតែរួមបញ្ចូល Ideempotency-Key តែមួយគត់ដែលមានយ៉ាងហោចណាស់ 200 តួអក្សរ។ ការប្រើវាឡើងវិញនឹងត្រឡប់ការបញ្ជាទិញដើមជំនួសឱ្យការសាកថ្មពីរដង។
ស្រោមសំបុត្រជោគជ័យ
{
"success": true,
"data": {},
"error": null
}ត្រូវការជំនួយក្នុងការផ្ទៀងផ្ទាត់ការរួមបញ្ចូល ឬការឆ្លើយតបដែលមិនរំពឹងទុកមែនទេ? ទាក់ទងផ្នែកគាំទ្រ
