استفاده از یونیوم از خارج کشور

اگر بیرون از ایران هستید یا سرویس شما روی سرورهایی خارج از ایران اجرا می‌شود، مسیریابی و فیلترینگ شبکه ممکن است روی uniom.ir اثر بگذارد. برای دسترسی پایدار و سریع‌تر، از دامنه بین‌المللی یونیوم استفاده کنید:

نکته: نام دامنه بین‌المللی یک i اضافه دارد: uniomi.ir (یعنی uniom-international).

چه زمانی از دامنه بین‌المللی استفاده کنیم

• سرور یا SDK شما خارج از ایران قرار دارد.
• در curl یا کلاینت‌های HTTP با خطای timeout یا عدم دسترسی به api.uniom.ir روبرو می‌شوید.
• می‌خواهید تأخیر شبکه را برای کاربران بین‌المللی کم کنید.

جایگزینی base URL

در همه نمونه‌های این مستندات، کافی است api.uniom.ir را با api.uniomi.ir جایگزین کنید. ساختار مسیرها و متدها کاملاً یکسان است:

# داخل ایران
curl -X POST "https://api.uniom.ir/bot<API_KEY>/sendMessage" \
  -H "Content-Type: application/json" \
  -d '{"chat_id": 12345, "text": "سلام از یونیوم"}'

# خارج از ایران (دامنه بین‌المللی)
curl -X POST "https://api.uniomi.ir/bot<API_KEY>/sendMessage" \
  -H "Content-Type: application/json" \
  -d '{"chat_id": 12345, "text": "Hello from Uniom"}'

پاسخ‌ها، کدهای خطا، و ساختار request دقیقاً مانند نسخه داخل ایران هستند. تنها تفاوت نام دامنه است.

تنظیم SDK و کتابخانه‌ها

اگر از SDK تلگرام یا کتابخانه‌ای استفاده می‌کنید که base URL سفارشی می‌پذیرد، آن را روی دامنه بین‌المللی قرار دهید:

• Bot API base URL: https://api.uniomi.ir/bot
• File download base URL: https://api.uniomi.ir/file/bot
• ورود و پنل: https://uniomi.ir/login و https://uniomi.ir/dashboard

برای راهنمای کامل جایگزینی base URL در SDKهای تلگرامی، صفحه مهاجرت از تلگرام به یونیوم را ببینید؛ همان گام‌ها اینجا هم کار می‌کنند، فقط دامنه را api.uniomi.ir بگذارید.

وب‌هوک و دریافت update

وب‌هوک‌ها نیز روی دامنه بین‌المللی کار می‌کنند. اگر سرور شما خارج از ایران است، تنظیم webhook روی api.uniomi.ir معمولاً پایدارتر است:

curl -X POST "https://api.uniomi.ir/bot<API_KEY>/setWebhook" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://your-server.example.com/webhook"}'

مشکلات رایج

• خطای timeout یا connection refused روی api.uniom.ir: به api.uniomi.ir سوییچ کنید.
• فایل دانلود نمی‌شود: base file URL را هم به https://api.uniomi.ir/file/bot تغییر دهید.
• خطای SSL یا DNS: مطمئن شوید کلاینت شما دامنه uniomi.ir را به‌درستی resolve می‌کند (مثلاً با dig api.uniomi.ir یا nslookup).

اگر پس از تغییر دامنه هم مشکل پابرجا بود، نشانی و کد خطا را در پشتیبانی یونیوم مطرح کنید.