واجهة API

الأساسيات

العنوان الأساسي

https://api.turkishvps.com/v1

المصادقة

أرسل الرمز في الترويسة Authorization: Bearer YOUR_TOKEN. أنشئه من اللوحة في قسم المطورين ثم مفاتيح API.

الرموز

حتى 10 رموز لكل حساب، ويمكن إلغاء أي منها متى شئت.

حد الطلبات

120 طلبًا في الدقيقة لكل حساب.

الفوترة

تُدفع الخوادم المطلوبة عبر الواجهة من رصيد محفظتك كما في اللوحة.

التنسيق

الطلبات والردود بصيغة JSON. أرسل الترويسة Accept: application/json.

طلبك الأول

اعرض الباقات المتاحة، واستخدم معرّف الباقة عند الطلب.

curl https://api.turkishvps.com/v1/plans \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json"

طلب خادم

يجب أن تتكون كلمة مرور root من 8 إلى 12 حرفًا وتتضمن حرفًا صغيرًا وحرفًا كبيرًا ورقمًا وأحد الرموز ! # + $ * -.

curl -X POST https://api.turkishvps.com/v1/servers \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"plan_id": 17, "os_id": 5, "label": "web-1", "root_password": "Str0ng#Pass"}'

نقاط الوصول

الحساب والكتالوج

الخوادم

المحفظة والفواتير

تذاكر الدعم

الأخطاء

يعيد الطلب الفاشل حالة 4xx مع رد JSON فيه رسالة، وتُعرض أخطاء التحقق لكل حقل.

HTTP/1.1 422 Unprocessable Content
{
  "message": "The root password field format is invalid.",
  "errors": { "root_password": ["The root password field format is invalid."] }
}