یک اندپوینت، یک فرم با فیلدهای 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 است: باید بدنهٔ پاسخ را بررسی کرد، نه وضعیت آن را. در عملیات دستهای، خطا داخل عنصر خودش قرار میگیرد و بقیه را لغو نمیکند.