رمزهای وضعیت HTTP

درحال مشاهده اسناد Apigee Edge هستید.
به اسناد Apigee X بروید. اطلاعات

پیام‌های خطای پاسخ Edge API شامل کد وضعیت HTTP و پیام خطا است.

برای مثال، اگر بخواهید نهاد حافظه نهانی با نامی یکسان با حافظه نهانی موجود ایجاد کنید، پاسخ این است:

HTTP/1.1 409 Conflict
{
  "code": "messaging.config.beans.CacheAlreadyExists",
  "message": "Cache duplicate_cache already exists in environment test",
  "contexts": []
}

جدول زیر رایج‌ترین کدهای وضعیت HTTP و معنای آن‌ها در Apigee Edge را خلاصه می‌کند.

رمز وضعیت HTTP شرح
‫2xx انجام شد. تماس با API موفقیت‌آمیز بود. ‫HTTP 204 نشان می‌دهد که پاسخ بدون محتوا ارسال شده است، معمولاً به این دلیل که عملیات «حذف» موفقیت‌آمیز بوده است.
401 غیر مجاز. اطلاعات اعتباری که برای درخواست استفاده می‌کنید اجازه‌های لازم برای انجام این عملیات را ندارد. نقش‌های حساب مورد استفاده را درستی‌سنجی کنید.
403 ممنوع. ترکیب نام کاربری و گذرواژه‌ای که استفاده می‌کنید برای سازمانی که مشخص کرده‌اید معتبر نیست. برای آزمایش اعتبارنامه‌هایتان، به سیستم login.apigee.com/login وارد شوید. اگر به حساب نیاز دارید، ثبت‌نام کنید.

مطمئن شوید که از اعتبارنامه‌های صحیح برای سازمانتان استفاده می‌کنید و املای آن را دوباره بررسی کنید.
404 یافت نشد. تأیید کنید که نشانی وب درخواست به‌درستی نوشته شده باشد و میانای برنامه‌سازی کاربردی که می‌خواهید به آن دسترسی پیدا کنید وجود داشته باشد. برای مثال، مطمئن شوید که سعی نمی‌کنید به نسخه اشتباهی از یک API دسترسی پیدا کنید. همچنین ‫404 نمی‌توان کارگزار را برای میزبان شناسایی کرد: <نام میزبان مجازی> و نشانی وب: <مسیر> را ببینید.
405 روش مجاز نیست. روش پشتیبانی‌نشده‌ای را مشخص کردید. برای مثال، از فعل GET برای فراخوانی API استفاده کرده‌اید که به فعل POST نیاز دارد.
409 تعارض. نشان‌دهنده تعارض با یک نهاد موجود است. برای مثال، تلاش کرده‌اید حافظه نهانی را بااستفاده از نامی که ازقبل وجود دارد ایجاد کنید.
415 نوع رسانه پشتیبانی نمی‌شود. معمولاً، این خطا در درخواست‌های POST یا PUT زمانی رخ می‌دهد که سرصفحه Content-type HTTP روی مقدار اشتباه تنظیم شده باشد. برای مثال، اگر موارد زیر را در میانای برنامه‌سازی کاربردی که فقط از JSON پشتیبانی می‌کند ارسال کنید، خطای HTTP 415 برگردانده می‌شود: 
$ curl https://api.company.com/v1/json_service
  -X POST
  -H "Content-type:text/xml"
  -d '<SomeXML>'

برای درخواست‌های GET، به‌جای سرصفحه Content-type از سرصفحه Accept استفاده کنید.
429 بیش‌ازحد درخواست وجود دارد. نرخ حد مجاز در خط‌مشی‌های «سهمیه» یا «جلوگیری از جهش» فراتر رفته است. کد وضعیت پیش‌فرض فعلی برای فراتر رفتن از حد نرخ ۵۰۰ است، اما ممکن است در آینده پیش‌فرض به ۴۲۹ تغییر کند. برای اطلاعات درباره نحوه تغییر ۵۰۰ به ۴۲۹، خط‌مشی «جلوگیری از جهش» و خط‌مشی «سهمیه» را ببینید.
۵۰۰ ۵۰۰ خطای سرور داخلی را ببینید.
502 ‫۵۰۲ دروازه نادرست را ببینید.
۵۰۳ ‫۵۰۳ سرویس دردسترس نیست را ببینید.
504 ‫۵۰۴ اتمام مهلت دروازه را ببینید.