API للموزّعين

نقطة نهاية واحدة ونموذج بالحقلين 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مفتاحك
actionservices
الطلب
curl -X POST https://telegos.app/api/v2 \
  -d key=YOUR_KEY \
  -d action=services
الاستجابة
[
  {
    "service": 101,
    "name": "Telegram Members · CIS",
    "type": "Default",
    "category": "Telegram Members",
    "rate": "0.90",
    "min": "50",
    "max": "10000",
    "refill": true,
    "cancel": true
  }
]
إنشاء طلب
يخصم التكلفة من الرصيد فورًا ويُرجع رقم الطلب.
الحقلالقيمة
keyمفتاحك
actionadd
serviceمعرّف الخدمة من action=services
linkرابط القناة أو المنشور أو الملف الشخصي
quantityكمية الطلب ضمن min…max
الطلب
curl -X POST https://telegos.app/api/v2 \
  -d key=YOUR_KEY \
  -d action=add \
  -d service=101 \
  -d link=https://t.me/example \
  -d quantity=500
الاستجابة
{
  "order": 23501
}
طلب بالتغذية التدريجية (drip-feed)
الحقول نفسها مع حقلين إضافيين: عدد مرات التشغيل والفاصل بينها. هنا quantity هي كمية التشغيلة الواحدة، ويُخصم المبلغ عن جميع التشغيلات.
الحقلالقيمة
runsعدد مرات التشغيل
intervalالفاصل بين التشغيلات بالدقائق
الطلب
curl -X POST https://telegos.app/api/v2 \
  -d key=YOUR_KEY \
  -d action=add \
  -d service=101 \
  -d link=https://t.me/example \
  -d quantity=100 \
  -d runs=5 \
  -d interval=60
الاستجابة
{
  "order": 23502
}
حالة الطلب
start_count هو العدّاد عند البدء، و remains هو ما لم يُسلَّم بعد.
الحقلالقيمة
keyمفتاحك
actionstatus
orderرقم الطلب
الطلب
curl -X POST https://telegos.app/api/v2 \
  -d key=YOUR_KEY \
  -d action=status \
  -d order=23501
الاستجابة
{
  "charge": "0.4500",
  "start_count": "3572",
  "status": "In progress",
  "remains": "157",
  "currency": "USD"
}
حالة عدة طلبات
حتى 100 رقم في الاستعلام الواحد. الاستجابة كائن مفاتيحه أرقام الطلبات: الرقم غير الموجود يأتي مع error ولا يؤثر في البقية.
الحقلالقيمة
keyمفتاحك
actionstatus
ordersأرقام مفصولة بفواصل
الطلب
curl -X POST https://telegos.app/api/v2 \
  -d key=YOUR_KEY \
  -d action=status \
  -d orders=23501,23502,999999
الاستجابة
{
  "23501": {
    "charge": "0.4500",
    "start_count": "3572",
    "status": "Completed",
    "remains": "0",
    "currency": "USD"
  },
  "23502": {
    "charge": "0.9000",
    "start_count": "1204",
    "status": "In progress",
    "remains": "300",
    "currency": "USD"
  },
  "999999": {
    "error": "Incorrect order ID"
  }
}
التعويض
متاح حيث تُرجع الخدمة refill: true. يُتابَع تقدّم التعويض بإجراء منفصل refill_status حسب رقمه.
الحقلالقيمة
keyمفتاحك
actionrefill / refill_status
orderرقم الطلب — لـ refill
refillرقم التعويض — لـ refill_status
الطلب
curl -X POST https://telegos.app/api/v2 \
  -d key=YOUR_KEY \
  -d action=refill \
  -d order=23501
الاستجابة
{
  "refill": 412
}
الإلغاء
متاح حيث تُرجع الخدمة cancel: true. تُعاد أموال الطلبات الملغاة إلى الرصيد.
الحقلالقيمة
keyمفتاحك
actioncancel
ordersأرقام مفصولة بفواصل
الطلب
curl -X POST https://telegos.app/api/v2 \
  -d key=YOUR_KEY \
  -d action=cancel \
  -d orders=23501,23502
الاستجابة
[
  { "order": 23501, "cancel": 1 },
  { "order": 23502, "cancel": { "error": "Incorrect order ID" } }
]
الرصيد
الحقلالقيمة
keyمفتاحك
actionbalance
الطلب
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: لذا تحقّق من جسم الاستجابة لا من حالتها. في الإجراءات المجمّعة يكون الخطأ داخل عنصره الخاص ولا يلغي بقية العناصر.
الاستجابة
{
  "error": "Incorrect request"
}