HTTP 402 — پرداخت لازم است
یک خطای کلاینت 4xx: درخواست نحو نادرستی دارد یا قابل اجرا نیست.
پرداخت لازم است
برای استفادهٔ آینده رزرو شده؛ گاهی برای APIهای دارای دروازهٔ پرداخت بهکار میرود.
معنای آن
در اصل برای سیستمهای پرداخت دیجیتال در نظر گرفته شده بود؛ رزرو شده و استاندارد نشده، ولی توسط برخی APIها برای اعلام لزوم پرداخت استفاده میشود.
چه زمانی استفاده شود
توسط برخی APIها برای نشان دادن اتمام سهمیه یا لزوم یک طرح پولی استفاده میشود.
سایر کدهای 4xx
درباره کدهای وضعیت HTTP
این راهنمای کدهای وضعیت HTTP تمام کدهای پاسخ استاندارد از محدوده اطلاعاتی 1xx تا خطاهای سرور 5xx را پوشش میدهد. هر مدخل کد عددی، عبارت دلیل معیار آن و یک خلاصه یکخطی را نشان میدهد، و کل فهرست را میتوان بر اساس شماره، نام یا معنا جستجو کرد؛ 301، Unauthorized و timeout همگی نتیجه مطلوب را مییابند؛ یا بر اساس کلاس پاسخ فیلتر کرد.
هر کد به صفحه اختصاصی خودش باز میشود با توضیحی کامل: اینکه وضعیت واقعاً چه معنایی دارد، چه زمانی باید در APIها و برنامههای خودتان از آن استفاده کنید، آیا پاسخهای آن کد بهطور پیشفرض قابل کش هستند یا نه، و RFCای که آن را تعریف میکند. کدهای مرتبط از همان کلاس در پایین صفحه پیوند داده شدهاند، بنابراین مقایسه 401 با 403 یا 301 با 308 تنها یک کلیک زمان میبرد.
پنج کلاس، سریعترین مدل ذهنی برای خواندن هر پاسخی هستند: 1xx یعنی درخواست در حال ادامه است، 2xx یعنی موفقیت، 3xx یعنی هدایت مجدد، 4xx یعنی خطا از سمت کلاینت بوده و 5xx یعنی سرور شکست خورده است. این راهنما دقیقاً حول همین ساختار سازماندهی شده است.
نحوه استفاده از کدهای وضعیت HTTP
- یک کد، عبارت دلیل یا کلیدواژه در کادر جستجو تایپ کنید؛ برای مثال 404، Not Found یا redirect.
- از فیلتر کلاس برای محدودکردن فهرست به کدهای اطلاعاتی، موفقیت، هدایت مجدد، خطای کلاینت یا خطای سرور استفاده کنید.
- صفحه هر کد را باز کنید تا معنای آن، زمان استفاده، قابلیت کش پیشفرض و RFC تعریفکننده آن را بخوانید.
- بخش کدهای مرتبط را برای مقایسه همسایهها از همان کلاس بررسی کنید.
- از دکمه کپی برای برداشتن کد جهت گزارش باگ، تست یا مشخصات API استفاده کنید.