جمله «API وصل نمیشود» چند مشکل متفاوت است. اول کد وضعیت پاسخ را جدا کنید.
- ۴۰۱ یا ۴۰۳: توکن نیست، منقضی شده، یا این کاربر اجازه این مسیر را ندارد. هدر Authorization و گارد را ببینید.
- ۴۱۹: در درخواست از خود سایت، معمولاً CSRF یا انقضای نشست است. API توکنمحور نباید با کوکی نشست قاطی شود.
- ۴۲۲: Laravel داده را رد کرده. بدنه JSON خطا فیلدها را میگوید. این خطای سرور نیست.
- ۵۰۰: exception داخل کد است و باید در لاگ دیده شود.
- اگر مرورگر حتی پاسخ را نشان نمیدهد و کنسول از CORS میگوید، سرور مسیر را اجرا کرده ولی هدر اجازه را برنگردانده، یا درخواست پیشپرواز رد شده.
اشتباه رایج در اتصال دو سیستم
یک درخواست آزمایشی با Postman جواب میدهد و سیستم واقعی نه. فرق معمولاً در هدر، نوع بدنه (form بهجای JSON)، ساعت انقضای توکن، یا آدرسی است که محیط تولید به آن میزند. اتصال را باید با همان درخواستی تست کرد که سیستم مبدأ واقعاً میفرستد.
برای وصل کردن دو سیستم، صفحه توسعه و اتصال API محدوده کار را گفته است.