បំពេញឯកសារ REST API សម្រាប់គ្រប់គ្រងម៉ាស៊ីនមេ VPS, ដែន, DNS, ការបម្រុងទុក និងច្រើនទៀត។
API របស់ VPS.org អនុញ្ញាតឱ្យអ្នកគ្រប់គ្រងគ្រប់ទិដ្ឋភាពទាំងអស់នៃហេដ្ឋារចនាសម្ព័ន្ធបង្ហោះ VPS របស់អ្នកដោយកម្មវិធី រួមទាំងម៉ាស៊ីនមេ ដែន កំណត់ត្រា DNS ការបម្រុងទុក និងរូបថតអេក្រង់។
សំណើ API ទាំងអស់តម្រូវឱ្យមានការផ្ទៀងផ្ទាត់ភាពត្រឹមត្រូវដោយប្រើ Bearer token។ អ្នកអាចបង្កើត API token របស់អ្នកពីការកំណត់គណនីរបស់អ្នកនៅ admin.vps.org/account/developers/.
curl -X GET https://admin.vps.org/api/v1/servers/ \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"import requests
url = "https://admin.vps.org/api/v1/servers/"
headers = {
"Authorization": "Bearer YOUR_API_TOKEN",
"Content-Type": "application/json"
}
response = requests.get(url, headers=headers)
print(response.json())const response = await fetch('https://admin.vps.org/api/v1/servers/', {
method: 'GET',
headers: {
'Authorization': 'Bearer YOUR_API_TOKEN',
'Content-Type': 'application/json'
}
});
const data = await response.json();
console.log(data);និមិត្តសញ្ញានីមួយៗមានសិទ្ធិរបស់ខ្លួនផ្ទាល់ដូចជា servers: list ឬ dns: * ។ សំណើដែលត្រូវការសិទ្ធិដែលនិមិត្តសញ្ញាមិនមានត្រូវបានបដិសេធដោយ 403 និងវាល required_ permission ដែលដាក់ឈ្មោះសិទ្ធិដែលបាត់ ។ សេចក្ដីយោងសិទ្ធិ
សំណើដែលបានផ្ទៀងផ្ទាត់ភាពត្រឹមត្រូវមានដែនកំណត់ទៅ 1000 ក្នុងមួយម៉ោងក្នុងមួយគណនី ។ សំណើដែលមិនបានផ្ទៀងផ្ទាត់ភាពត្រឹមត្រូវមានដែនកំណត់ទៅ 100 ក្នុងមួយម៉ោងក្នុងមួយអាសយដ្ឋាន IP ។ សំណើដែលលើសពីដែនកំណត់ទទួលបាន 429 ជាមួយបឋមកថាព្យាយាមម្ដងទៀតបន្ទាប់ពីផ្ដល់ចំនួនវិនាទីរង់ចាំ ។ គ្មានបឋមកថាដែនកំណត់អត្រាត្រូវបានផ្ញើលើការឆ្លើយតបដែលជោគជ័យ ។
បញ្ជីចំណុចបញ្ចប់ត្រឡប់វត្ថុមួយជាមួយនឹងចំនួនបន្ទាប់ មុន និងលទ្ធផល ២៥ ធាតុក្នុងមួយទំព័រ ។ ទំព័រឆ្លងកាត់ដើម្បីផ្លាស់ទីរវាងទំព័រ ឬតាមដាន URL បន្ទាប់រហូតដល់វាទទេ ។ បញ្ជីម៉ាស៊ីនបម្រើក៏ទទួលយក page_ size រហូតដល់ ១០០ ។
{
"count": 84,
"next": "https://admin.vps.org/api/v1/backups/?page=2",
"previous": null,
"results": [ ... ]
}API ប្រើប្រាស់លេខកូដស្ថានភាព HTTP ស្តង់ដារ ដើម្បីបង្ហាញពីភាពជោគជ័យ ឬបរាជ័យ៖
| លេខកូដស្ថានភាព | សេចក្ដីពិពណ៌នា |
|---|---|
200 |
ជោគជ័យ - សំណើបានបញ្ចប់ដោយជោគជ័យ |
201 |
បានបង្កើត - ធនធានត្រូវបានបង្កើតដោយជោគជ័យ |
400 |
សំណើមិនល្អ - ប៉ារ៉ាម៉ែត្រមិនត្រឹមត្រូវ ឬសំណើមានទម្រង់មិនត្រឹមត្រូវ |
202, 204 |
Accepted and queued (202), or deleted with no response body (204) |
402 |
ការទូទាត់ចាំបាច់: គ្មានវិធីសាស្រ្តទូទាត់លើឯកសារ, ថ្លៃសេវាមិនបង់ប្រាក់ឬការអនុញ្ញាតមុនកាតដែលមិនទទួលយក |
403 |
បានហាមឃាត់ ៖ បាត់តួអក្សរមិនត្រឹមត្រូវ ឬផុតកំណត់ ឬគ្មានសិទ្ធិដែលត្រូវការ ។ ការផ្ទៀងផ្ទាត់ភាពត្រឹមត្រូវដែលបានបរាជ័យក៏ត្រឡប់ ៤០៣ ដែរ មិនមែន ៤០១ ។ |
404 |
រកមិនឃើញ - ធនធានមិនមានទេ |
409 |
ប៉ះទង្គិច ៖ ឧទាហរណ៍ ការប្ដូរទំហំកំពុងតែដំណើរការហើយ សមត្ថភាពមិនគ្រប់គ្រាន់ ឬការដំឡើងកំពុងរត់ហើយ |
429 |
សំណើច្រើនពេក - លើសដែនកំណត់អត្រា |
500 |
កំហុសម៉ាស៊ីនមេខាងក្នុង - មានអ្វីមួយខុសប្រក្រតីនៅខាងយើង |
503 |
សេវាមិនអាចប្រើបាន ៖ បញ្ហាបណ្ដោះអាសន្ន ។ ព្យាយាមម្ដងទៀត គោរពព្យាយាមម្ដងទៀតបន្ទាប់ពីវាត្រូវបានផ្ញើ ។ |
តួកំហុសគឺ JSON ។ ភាគច្រើនមានវាលលម្អិត ឬវាលកំហុស ពេលខ្លះមានសារ កំហុសធ្វើឲ្យមានសុពលភាពរាយបញ្ហាតាមឈ្មោះវាល ។
រកមើលឯកសារ API របស់យើងតាមប្រភេទ៖
បង្កើត ពិនិត្យ ថាមពល ប្ដូរទំហំ និងលុបម៉ាស៊ីនបម្រើ កំណត់ពាក្យសម្ងាត់ root ឡើងវិញ កំណត់ DNS ត្រឡប់ រត់ពាក្យបញ្ជា និងគ្រប់គ្រងកូនសោ SSH ។
មើលឯកសាររាយបម្រុងទុកម៉ាស៊ីនបម្រើរបស់អ្នក ចាប់ផ្ដើមបម្រុងទុកថ្មី និងស្ដារម៉ាស៊ីនបម្រើពីបម្រុងទុក ។
មើលឯកសារយករូបថតដែលមានស្លាករបស់ម៉ាស៊ីនបម្រើ រាយពួកវា និងលុបពួកវា ។
មើលឯកសារទាញយកផែនការ VPS និងព័ត៌មានតម្លៃដែលមាន។ ទទួលបានព័ត៌មានលម្អិតអំពីធនធាន តម្លៃ និងភាពអាចរកបាន។
មើលឯកសាររាយបញ្ជីប្រព័ន្ធប្រតិបត្តិការ និងកំណែដែលអ្នកអាចដំឡើងបាន ដូចជា Ubuntu, Debian, Rocky Linux, CentOS Stream, Fedora និង Alpine ។
មើលឯកសារពិនិត្យមើលភាពអាចរកបាន, ចុះឈ្មោះនិងដែនថ្មី, និងកំណត់ម៉ាស៊ីនបម្រើឈ្មោះនិងស្វ័យប្រវត្តិ-ថ្មី.
មើលឯកសារបង្កើតតំបន់ DNS និងបង្កើត, ធ្វើបច្ចុប្បន្នភាពនិងលុប A, A, CNAME, MX, TXT, SRV, CAA និងកំណត់ត្រាផ្សេងទៀតរបស់ពួកគេ។
មើលឯកសារយកទម្រង់គណនី និងព័ត៌មានតួអក្សរ API & # 160; ។ កំណត់អត្តសញ្ញាណគណនីដែលតួអក្សរជារបស់វា និងពិនិត្យមើលសិទ្ធិរបស់វា & # 160; ។
មើលឯកសារដកសន្លឹកបៀរបស់អ្នក, ការណែនាំ, គណៈកម្មការនិងការទូទាត់ទៅក្នុងរបាយការណ៍ផ្ទាល់ខ្លួនរបស់អ្នក, ផ្លាស់ប្តូរការកំណត់ការទូទាត់និងសំណើការទូទាត់.
មើលឯកសារAPI នេះក៏មានចំណុចបញ្ចប់សម្រាប់ការបញ្ជូនកម្មវិធី (/ api / v1 / deploy-configs / និង / api / v1 / deployments /) ។ ពួកគេមិនបានរៀបរាប់នៅលើទំព័រទាំងនេះនៅឡើយទេ; សេចក្ដីយោងអន្តរកម្មរាយបញ្ជីចំណុចបញ្ចប់ទាំងអស់, បង្កើតពី API រស់ ។
បើកសេចក្ដីយោង API អន្តរកម្មប្រសិនបើអ្នកមានសំណួរ ឬត្រូវការជំនួយជាមួយ API សូមកុំស្ទាក់ស្ទើរក្នុងការទាក់ទងមកយើងខ្ញុំ៖