Telegram Stars API
بِع Telegram Stars وPremium داخل بوتك أو متجرك أو تطبيقك. واجهة HTTPS API واحدة، ورصيد واحد مشترك مع بوت StarKerak والموقع.
ماذا يفعل API
- POST /api/v1/check-username — التحقق من المستلم والحصول على رمز تحقق قصير الأجل
- POST /api/v1/stars/buy و/api/v1/premium/buy — إنشاء الطلبات (Idempotency-Key مطلوب)
- GET /api/v1/order/{id} و/api/v1/orders — الحالات والسجل
- GET /api/v1/prices و/api/v1/account ومحفظة USD وفواتير USDT
تستخدم المصادقة ترويسة X-API-Key. تُنشأ المفاتيح في لوحة التحكم ولا تنتهي صلاحيتها حتى تلغيها.
مصمّم للإنتاج
يحمل كل طلب Idempotency-Key الخاص بك، لذا لا تؤدي إعادة المحاولة إلى خصم مزدوج. يمنع التحقق من المستلم الدفع لأسماء مستخدمين غير موجودة. حد المعدل هو 10 طلبات في الثانية لكل مفتاح.
تُدفع جميع الطلبات من رصيد USD (currency=USD؛ يُعامل UZS كـ USD). مرّر max_usd لتحديد سقف السعر الذي تقبله.
الشفافية
يحصل كل طلب مكتمل على TxId مُسجَّل في السجل العام لـ PayStars، لتتمكن أنت وعملاؤك من التحقق من التسليم بشكل مستقل.
سعر Fragment، 0% (الموقع: 5%)
تُسعَّر طلبات مفتاح API من رصيد USD بسعر Fragment المباشر 0% (الموقع: 5%)؛ وتكلفة طلبات الموقع والتطبيق المصغّر هي Fragment — على الموقع يُعرض المبلغ الدقيق قبل الدفع. احصل على السعر عبر POST /usd/quote وحدد سقفه بـ max_usd. التفاصيل في صفحة Fragment API.
الأسئلة الشائعة
هل توجد بيئة تجريبية؟
استخدم طلبات حقيقية صغيرة (50 Stars) أثناء الدمج؛ يجعل مفتاح منع التكرار إعادة المحاولة آمنة.
ما اللغات المدعومة؟
أي لغة تدعم HTTPS. راجع البدايات السريعة لـ Python وNode.js وPHP.
هل تنتهي صلاحية مفاتيح API؟
لا. تبقى المفاتيح صالحة حتى تلغيها في لوحة التحكم.
هل يمكنني الدفع بـ USD؟
نعم — اشحن رصيد USD بـ USDT (TON أو BEP20 أو TRC20) وأرسل currency=USD.
Related pages
هل أنت مستعد للطلب؟
سجّل الدخول عبر Telegram — رصيد StarKerak يعمل على الموقع وفي WebApp وعبر API.
