អ្នកផ្តល់សេវាដែលឆបគ្នានឹង PerfectPanel API

ភ្ជាប់បន្ទះរបស់អ្នកទៅ BEE-TH.COM

ឯកសារយោងដែលត្រៀមរួចជាស្រេចសម្រាប់ការផលិតសម្រាប់សេវាកម្មនាំចូល ការបញ្ជាទិញ តាមដានការដឹកជញ្ជូន ស្នើសុំការលុបចោល និងការអានសមតុល្យប្រាក់បាតរបស់អ្នក។

ចូលដើម្បីទទួលបានសោ API បង្កើតគណនី

វិធីសាស្ត្រ 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 ដូចគ្នា ហើយត្រឡប់ទិន្នន័យសេវាកម្មដូចគ្នា។

bash

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 និងការការពារហេដ្ឋារចនាសម្ព័ន្ធនៅតែអនុវត្ត។

រក្សាសោឯកជន។ រក្សាទុកវានៅក្នុងការសម្ងាត់ខាងម៉ាស៊ីនមេ ឬអថេរបរិស្ថាន។ កុំដាក់វានៅក្នុងកម្មវិធីរុករកតាមអ៊ីនធឺណិត JavaScript ឃ្លាំងសាធារណៈ រូបថតអេក្រង់ ឬសារគាំទ្រ។

SERVICES

បញ្ជីសេវាកម្ម

នាំចូលសេវាកម្ម និងតម្លៃជាក់លាក់សម្រាប់សមាជិកបច្ចុប្បន្នដែលមានក្នុងគណនីនេះ។

POSThttps://api.bee-th.com/api/v2action=services

ប៉ារ៉ាម៉ែត្រ	ប្រភេទ	ការពិពណ៌នា
key	string	លេខកូដ API សមាជិក BEE-TH.COM ឯកជនរបស់អ្នក។
action	"services"	ត្រូវតែជាសេវាកម្មតម្លៃតាមព្យញ្ជនៈ។

bash

curl -X POST "https://api.bee-th.com/api/v2" \
  -d "key=$BEE_TH_API_KEY" \
  -d "action=services"

ការឆ្លើយតបឧទាហរណ៍

json

[
  {
    "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,
    "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,
    "cancel": false,
    "category": "บริการ Instagram ประเทศไทย",
    "categoryEn": "บริการ Instagram ประเทศไทย"
  }
]

សេវាកម្មគឺជាលេខសម្គាល់អចិន្ត្រៃយ៍ដែលត្រូវបានបែងចែកដោយ BEE-TH.COM និងមិនអាស្រ័យលើលេខសម្គាល់អ្នកផ្តល់សេវាទេ។ ប្រភេទ និងប្រភេទEn មានក្រុមសេវាកម្ម។ អត្រា អប្បបរមា និងអតិបរមាគឺជាលេខ JSON ខណៈពេលដែល dripfeed បំពេញបន្ថែម និងលុបចោលការបោះពុម្ពផ្សាយសមត្ថភាពសេវាកម្មដែលមានប្រសិទ្ធភាព។

រាល់ការស្នើសុំត្រឡប់តម្លៃសមាជិកចុងក្រោយ ដែនកំណត់ និងបញ្ជីសេវាកម្មដែលមានដោយមិនចាំបាច់ប្រើឃ្លាំងសម្ងាត់ឆ្លើយតប។ ប្រព័ន្ធ Downstream អាចស្ទង់មតិសកម្មភាពសេវាកម្មដើម្បីធ្វើសមកាលកម្មទិន្នន័យ។ ប្រេកង់បោះឆ្នោត និងថាតើការត្រួតពិនិត្យការធ្វើសមកាលកម្មត្រូវបានបើកអាស្រ័យលើអាដាប់ទ័រខាងក្រោម។

ADD

បន្ថែមការបញ្ជាទិញ

បង្កើតការបញ្ជាទិញសម្រាប់សេវាកម្មដែលបានបោះផ្សាយ ហើយដកប្រាក់កាបូបសមាជិកដោយប្រើតម្លៃជាក់លាក់របស់សមាជិកបច្ចុប្បន្ន។

POSThttps://api.bee-th.com/api/v2action=add

ប៉ារ៉ាម៉ែត្រ	ប្រភេទ	ការពិពណ៌នា
key	string	លេខកូដ API សមាជិក BEE-TH.COM ឯកជនរបស់អ្នក។
action	"add"	ត្រូវតែជាតម្លៃបន្ថែមតាមព្យញ្ជនៈ។
service	integer	លេខសម្គាល់សេវាកម្មជាលេខអចិន្ត្រៃយ៍បានប្រគល់មកវិញដោយសកម្មភាពសេវាកម្ម។
link	URL	គោលដៅសាធារណៈ URL សម្រាប់ទំព័រ ប្រកាស ប្រវត្តិរូប ឬប្រព័ន្ធផ្សព្វផ្សាយ។
quantity	integer	ទាមទារសម្រាប់សេវាកម្មលំនាំដើម។ ចំនួនទឹកប្រាក់ដែលបានស្នើសុំត្រូវតែស្ថិតនៅក្នុងកម្រិតអប្បបរមា និងអតិបរមានៃសេវាកម្ម។
comments	string	ទាមទារសម្រាប់សេវាកម្មមតិយោបល់ផ្ទាល់ខ្លួន។ ផ្ញើមតិយោបល់មួយក្នុងមួយជួរ; បរិមាណត្រូវបានគណនាពីបន្ទាត់មិនទទេ។

សេវាកម្មលំនាំដើម

bash

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"

សេវាកម្មយោបល់ផ្ទាល់ខ្លួន

bash

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មតិទីពីរ'

json

{
  "order": 9001
}

សម្រាប់មតិយោបល់ផ្ទាល់ខ្លួន សូមលុបចោលបរិមាណ ហើយផ្ញើមតិយោបល់ជាអត្ថបទដាច់ដោយឡែកពីបន្ទាត់ថ្មី។ BEE-TH.COM កាត់បន្ទាត់ទទេ ហើយប្រើចំនួនបន្ទាត់ដែលនៅសល់ជាបរិមាណបញ្ជាទិញ។

ព្យាយាមម្តងទៀតបន្ទាប់ពីការដឹកជញ្ជូនបរាជ័យ នៅពេលអ្នកប្រាកដថាគ្មានលេខបញ្ជាទិញត្រូវបានប្រគល់មកវិញទេ។ សម្រាប់ការរួមបញ្ចូលដែលតម្រូវឱ្យមានការព្យាយាមឡើងវិញដោយមានការធានា សូមប្រើចំណុចបញ្ចប់នៃការបញ្ជាទិញ REST ។

STATUS

ស្ថានភាពបញ្ជាទិញ

អានការបញ្ជាទិញមួយ ឬរហូតដល់ 100 ការបញ្ជាទិញដែលជាកម្មសិទ្ធិរបស់ម្ចាស់សោ API ។

POSThttps://api.bee-th.com/api/v2action=status

ប៉ារ៉ាម៉ែត្រ	ប្រភេទ	ការពិពណ៌នា
key	string	លេខកូដ API សមាជិក BEE-TH.COM ឯកជនរបស់អ្នក។
action	"status"	ត្រូវតែជាស្ថានភាពតម្លៃព្យញ្ជនៈ។
order	integer	លេខបញ្ជាទិញ BEE-TH.COM មួយ។ កុំផ្ញើជាមួយការបញ្ជាទិញ។
orders	string	លេខលំដាប់ដែលបំបែកដោយសញ្ញាក្បៀស រហូតដល់ 100។ កុំផ្ញើរួមគ្នាជាមួយការបញ្ជាទិញ។

ផ្ញើទាំងការបញ្ជាទិញឬការបញ្ជាមិនដែលបានទាំងពីរ។ ការឆ្លើយតបការបញ្ជាទិញច្រើនត្រូវបានចុចដោយលេខបញ្ជាទិញដែលបានស្នើសុំ។

bash

# ការបញ្ជាទិញតែមួយ
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"

json

{
  "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 ដែលសេវាកម្មរបស់ពួកគេផ្សាយពាណិជ្ជកម្មលុបចោល៖ ពិត។

POSThttps://api.bee-th.com/api/v2action=cancel

ប៉ារ៉ាម៉ែត្រ	ប្រភេទ	ការពិពណ៌នា
key	string	លេខកូដ API សមាជិក BEE-TH.COM ឯកជនរបស់អ្នក។
action	"cancel"	ត្រូវតែជាតម្លៃព្យញ្ជនៈបោះបង់។
orders	string	លេខលំដាប់ដែលបំបែកដោយសញ្ញាក្បៀសដើម្បីលុបចោល រហូតដល់ 100។

bash

curl -X POST "https://api.bee-th.com/api/v2" \
  -d "key=$BEE_TH_API_KEY" \
  -d "action=cancel" \
  -d "orders=9001,9002"

json

[
  {"order": 9001, "cancel": 1},
  {"order": 9002, "cancel": {"error": "Error calling provider"}}
]

បោះបង់៖ 1 មានន័យថាសំណើលុបចោលត្រូវបានទទួលយក។ វាអាចនៅតែរង់ចាំខណៈពេលដែលអ្នកផ្តល់សេវាខាងលើ ឬក្រុមប្រតិបត្តិការ BEE-TH.COM បញ្ចប់វា។ បន្តស្ថានភាពលំដាប់បោះឆ្នោតសម្រាប់លទ្ធផលចុងក្រោយ។

BALANCE

សមតុល្យអ្នកប្រើប្រាស់

ត្រឡប់សមតុល្យកាបូបសមាជិកដែលមានជាខ្សែទសភាគជាប្រាក់បាត។

POSThttps://api.bee-th.com/api/v2action=balance

ប៉ារ៉ាម៉ែត្រ	ប្រភេទ	ការពិពណ៌នា
key	string	លេខកូដ API សមាជិក BEE-TH.COM ឯកជនរបស់អ្នក។
action	"balance"	ត្រូវតែជាតុល្យភាពតម្លៃព្យញ្ជនៈ។

bash

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"

json

{
  "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	សេវាកម្ម ឬស្ថានភាពការបញ្ជាទិញបច្ចុប្បន្នមិនអនុញ្ញាតឱ្យលុបចោលទេ។

API អនុវត្តតាមកិច្ចសន្យាកំហុស MeeLike៖ សោមិនត្រឹមត្រូវ ឬកំហុសអាជីវកម្មដែលទាក់ទងនឹងការបញ្ជាទិញត្រឡប់ HTTP 200 ជាមួយនឹងវាលកំហុស សំណើសុពលភាពត្រឡប់ HTTP 400 ជាមួយនឹងស្ថានភាព សារ ត្រាពេលវេលា និងផ្លូវ វិធីសាស្ត្រដែលមិនគាំទ្រត្រឡប់ HTTP 404 ហើយជម្រើសត្រឡប់ HTTP 204 ។

PHP

បំពេញឧទាហរណ៍ PHP

ម៉ាស៊ីនភ្ញៀវតូចនេះរក្សាការផ្ទៀងផ្ទាត់ TLS បើកដំណើរការ ប្រើការតភ្ជាប់ និងសំណើអស់ពេល ហើយបោះចោលនៅពេលដែល API ត្រឡប់កំហុស។

php

<?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}	អានលំដាប់មួយ។

bash

curl "https://test.moviesfree-th.com/api/v1/member/services?locale=km" \
  -H "Authorization: Bearer $BEE_TH_API_KEY"

curl -X POST "https://test.moviesfree-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 តួអក្សរ។ ការប្រើវាឡើងវិញនឹងត្រឡប់ការបញ្ជាទិញដើមជំនួសឱ្យការសាកថ្មពីរដង។

ស្រោមសំបុត្រជោគជ័យ

json

{
  "success": true,
  "data": {},
  "error": null
}

ត្រូវការជំនួយក្នុងការផ្ទៀងផ្ទាត់ការរួមបញ្ចូល ឬការឆ្លើយតបដែលមិនរំពឹងទុកមែនទេ? ទាក់ទងផ្នែកគាំទ្រ

ភ្ជាប់បន្ទះរបស់អ្នកទៅ BEE-TH.COM

ភ្ជាប់ជាបីជំហាន

បង្កើតកូនសោរបស់អ្នក។

កំណត់រចនាសម្ព័ន្ធបន្ទះរបស់អ្នក។

ដំណើរការការធ្វើតេស្តផ្សែង

ផ្ទៀងផ្ទាត់រាល់សំណើ

វដ្តជីវិតសំខាន់ៗ

ដែនកំណត់អត្រា

បញ្ជីសេវាកម្ម

ការឆ្លើយតបឧទាហរណ៍

បន្ថែមការបញ្ជាទិញ

សេវាកម្មលំនាំដើម

សេវាកម្មយោបល់ផ្ទាល់ខ្លួន

ស្ថានភាពបញ្ជាទិញ

តម្លៃស្ថានភាព

បោះបង់ការបញ្ជាទិញ

សមតុល្យអ្នកប្រើប្រាស់

កំហុសប្រើប្រាស់ទម្រង់ JSON ដែលអាចព្យាករណ៍បាន។

បំពេញឧទាហរណ៍ PHP

កម្រិតខ្ពស់ REST API

ការផ្ទៀងផ្ទាត់អ្នកកាន់

សាកល្បងដោយសុវត្ថិភាព

ស្រោមសំបុត្រជោគជ័យ