عملیات

خطاها و عیب‌یابی

خطاهای رایج هنگام کار با API یونیوم و روش عیب‌یابی سریع.

قالب خطا

{
  "ok": false,
  "error_code": 400,
  "description": "Bad Request: chat not found"
}

خطا	علت معمول	اقدام پیشنهادی
`Unauthorized`	کلید API اشتباه، حذف‌شده یا منقضی	کلید را در پنل بررسی و در صورت نیاز دوباره بسازید
`chat not found`	مقصد قابل resolve نیست	`chat_id` را با همان پلتفرم هدف تست کنید
`Forbidden`	scope کافی نیست یا credential اجازه عملیات ندارد	scope کلید و وضعیت credential را بررسی کنید
conflict در `getUpdates`	polling هم‌زمان یا webhook فعال	یک worker نگه دارید یا webhook را حذف کنید
خطای webhook	endpoint شما 2xx نمی‌دهد یا secret اشتباه است	`getWebhookInfo` و لاگ تحویل webhook را بررسی کنید

برای بررسی درخواست‌های اخیر:

curl "https://api.uniom.ir/user/logs/api-requests?limit=20" \
  -H "Authorization: Bearer <JWT>"

برای webhook delivery:

curl "https://api.uniom.ir/user/logs/webhook-deliveries?limit=20" \
  -H "Authorization: Bearer <JWT>"

ابتدا getMe را با همان API key بزنید.
credential را از پنل یا GET /platforms/credentials/{id} بررسی کنید.
اگر ارسال پیام خطا دارد، با یک مقصد ساده مثل username شناخته‌شده تست کنید.
اگر دریافت پیام خطا دارد، مطمئن شوید هم‌زمان webhook و polling را فعال نکرده‌اید.
اگر webhook عقب افتاده، getWebhookInfo را ببینید و endpoint خود را با curl تست کنید.