هسته یونیوم
حسابها و تنظیمات دریافت
فهرست حسابهای متصل، تست credential و تنظیمات مهم دریافت update.
credential چیست؟
credential همان حساب پیامرسان متصلشده به یونیوم است. API keyهای Bot API معمولاً به یکی از همین credentialها وصل میشوند.
مسیرهای مهم
| مسیر | کاربرد |
|---|---|
GET /platforms |
فهرست پلتفرمهای قابل استفاده |
GET /platforms/credentials |
فهرست حسابهای متصل کاربر |
GET /platforms/credentials/{credential_id} |
جزئیات یک credential |
POST /platforms/credentials/{credential_id}/test |
تست سلامت credential |
PATCH /platforms/credentials/{credential_id}/settings |
تنظیمات دریافت update |
DELETE /platforms/credentials/{credential_id} |
حذف یا غیرفعالسازی credential |
مثال فهرست credentialها
curl "https://api.uniom.ir/platforms/credentials" \
-H "Authorization: Bearer <JWT>"
تنظیمات دریافت update
برخی deploymentها برای credential تنظیمات جداگانهای مثل اینها دارند:
| تنظیم | اثر عملی |
|---|---|
include_self_updates |
updateهای ارسالشده توسط خود حساب را هم عبور میدهد |
include_channel_updates |
channel_post و edited_channel_post را وارد جریان میکند |
include_channel_update_recovery |
recovery برای updateهای کانال را فعال میکند |
include_deleted_updates |
eventهای حذف پیام را هم دریافت میکنید |
قبل از روشنکردن هر گزینه، ببینید consumer شما واقعاً آن eventها را handle میکند یا نه.
تست credential
اگر ارسال یا دریافت درست کار نمیکند، قبل از blame کردن Bot API این checkها را بزنید:
- خود credential فعال است؟
- حساب مقصد logout یا invalid نشده؟
- API key به credential درست وصل است؟
- تنظیمات دریافت update با workflow شما هماهنگ است؟