Алдааны кодууд
HTTP статус ба машины `code` бүрийн утга.
Алдаа бүр: {"error": "<хүний унших тайлбар>", "code": "<машины код>"}. Код нэмэгдэж болно, нэр солигдохгүй.
| HTTP | code | Утга |
|---|---|---|
| 401 | missing_api_key · invalid_api_key | Толгой алга / түлхүүр буруу эсвэл хүчингүй |
| 403 | subscription_inactive · module_inactive | Багц дууссан / багцад developer_api модуль алга |
| 429 | rate_limited | Минутын лимит |
| 429 | private_reply_daily_cap | POST /v1/comments/:id/private-reply: энэ Page өнөөдрийн private reply-ийн дээд хязгаарт (COMMENT_DM_DAILY_CAP, default 200) хүрсэн — Улаанбаатарын шөнө дундад шинэчлэгдэнэ. Юу ч илгээгдээгүй |
| 429 | private_reply_commenter_window | POST /v1/comments/:id/private-reply: энэ коммент бичсэн хүн сүүлийн 7 хоногт аль хэдийн private reply авсан. Юу ч илгээгдээгүй |
| 400 | text_required · invalid_conversation_id · too_many_buttons · invalid_button · tag_unsupported · image_url_https … | Validation — юу ч илгээгдээгүй |
| 400 | invalid_body · invalid_before · webhook_url_invalid | Body JSON биш / before RFC3339 биш / webhook URL нийтийн https хаяг биш |
| 404 | conversation_not_found · comment_not_found · webhook_not_found · workspace_not_found | Энэ workspace-д байхгүй |
| 409 | outside_messaging_window · recipient_unavailable · channel_disconnected · private_reply_used | Meta татгалзсан (24ц цонх, блок, токен) |
| 502 | send_failed · upstream_error | Meta/Telegram-ийн бусад алдаа (error-т эх текст) |
| 500 | internal · persist_failed | Түлхүүр шалгах үеийн дотоод алдаа / мессеж илгээгдсэн ч бүртгэгдээгүй — дахин бүү илгээ |
| 503 | webhook_unavailable | Webhook-ийн нууцыг энэ серверт хадгалах боломжгүй — дараа дахин оролдоно |
| 404 | flow_not_found · session_not_found · run_not_found | Flow invoke (Flow) — энэ workspace-ийн идэвхтэй api flow / хүлээж буй session / API гүйлт биш |
| 410 · 409 | session_expired · session_busy · idempotency_in_progress · idempotency_response_unavailable | Flow invoke: session 1ц өнгөрсөн / зэрэг continue / ижил түлхүүр гүйж байна / хадгалсан хариу 16KB-аас их (run_id-аар унш) |
| 422 | flow_not_invokable · idempotency_key_reuse | Flow-д headless-д зөвшөөрөгдөөгүй node / ижил түлхүүр өөр body-той |
| 429 | daily_invoke_cap · concurrency_limited | Flow invoke: workspace-д өдөрт 2,000 / зэрэг 4 (Retry-After: 1) |
| 503 | safe_mode | META_OUTBOUND_SAFE_MODE асаалттай — Meta-гийн осол/шалгалтын үед private reply платформ даяар түр зогссон. Дараа дахин оролдоно |
Private reply-ийн хоёр хязгаар (429 private_reply_*) нь коммент авто-DM, post-commerce, bulk reply-тэй НЭГ тоолуур хуваалцана: амжилттай POST /v1/comments/:id/private-reply нь коммент дээр dm_sent (эсвэл өмнө нь нийтэд хариулсан бол both_sent) гэж бүртгэгдэж өдрийн хязгаарт тоологдоно. Хязгаар нь минутын rate_limited-ээс тусдаа — Retry-After толгойгүй.
Flow invoke-ийн бүрэн жагсаалт: Flow → Алдааны кодууд.