نقطة نهاية واحدة ونموذج بالحقلين key و action. متوافق مع API v2 القياسي للوحات SMM — وحدات المتاجر وأنظمة الفوترة الجاهزة تتصل دون أي تعديل.
بداية سريعة
العنوان
https://telegos.app/api/v2
الطريقة
POST
صيغة جسم الطلب
application/x-www-form-urlencoded
الاستجابة
JSON، ودائمًا برمز الحالة 200
يُمرَّر المفتاح في الحقل key ضمن جسم الطلب — أما الترويسة Authorization فلا تُستخدم هنا. يعمل حسابك برمز منفصل، لذا فإن إعادة تعيين المفتاح لا تُنهي جلستك في المتصفح.
قائمة الخدمات
تُرجع قائمة الأسعار كاملة: معرّف الخدمة id لـ action=add، والسعر لكل 1000، وحدود الكمية.
الحقل
القيمة
key
مفتاحك
action
services
الطلب
curl -X POST https://telegos.app/api/v2 \
-d key=YOUR_KEY \
-d action=services
curl -X POST https://telegos.app/api/v2 \
-d key=YOUR_KEY \
-d action=balance
الاستجابة
{
"balance": "19.61",
"currency": "USD"
}
حالات الطلبات
الحالة
المعنى
Pending
تم قبول الطلب وهو بانتظار إرساله إلى المزوّد
In progress
التنفيذ جارٍ
Processing
يُعالَج الطلب لدى المزوّد
Completed
تم تسليم الكمية بالكامل
Partial
تم تسليم جزء من الكمية، وأُعيد الباقي إلى الرصيد
Canceled
أُلغي الطلب وأُعيد المبلغ المخصوم
الأخطاء
يصل الخطأ بالرمز 200 نفسه ويتميّز بوجود الحقل error: لذا تحقّق من جسم الاستجابة لا من حالتها. في الإجراءات المجمّعة يكون الخطأ داخل عنصره الخاص ولا يلغي بقية العناصر.