مستندات آموزشی X-Time Bot API
API رسمی ربات X-Time امکان ارتباط کامل با سرور پیامرسان را فراهم میکند. این API به صورت HTTP در دسترس است و ساختاری مشابه پیامرسانهای مدرن دارد.
آدرس پایه API
/api/bot/<TOKEN>/<METHOD>
احراز هویت به صورت URL-based انجام میشود:
<botId>.<rawToken>
و نیازی به ارسال Header جداگانه نیست.
متدهای اصلی
GET getMe
دریافت اطلاعات هویتی ربات
POST sendMessage
ارسال پیام متنی با پشتیبانی از inline_keyboard و reply_keyboard
POST sendPhoto
ارسال تصویر همراه با caption
POST sendDocument
ارسال فایل یا مستندات
POST forwardMessage
فوروارد کردن پیام
POST editMessageText
ویرایش پیام ارسالی ربات
POST deleteMessage
حذف پیام ارسالی ربات
GET getUpdates
دریافت آپدیتها (Long Polling)
POST setWebhook
تنظیم Webhook
POST answerCallbackQuery
پاسخ به کلیک دکمههای شیشهای
Callback Query Flow
زمانی که کاربر روی دکمه Inline کلیک میکند، کلاینت Flutter درخواست را به مسیر زیر ارسال میکند:
POST /api/callback_query
سپس سرور یک update از نوع callback_query به webhook ربات ارسال میکند.
ربات باید با متد answerCallbackQuery پاسخ دهد تا Toast یا Alert نمایش داده شود.