Əsas məzmuna keç

Pulsuz HTTP Status Kodları İstinadı

Bütün HTTP status kodları üçün axtarışlı istinad — hər birinin nə demək olduğu, nə zaman istifadə olunduğu və ümumi səbəblər. 100-dən 511-ə qədər.

Bir dəfə yükləndikdən sonra oflayn işləyir

61 status kodu

100

Davam edin

Server sorğu başlıqlarını almışdır və müştəri gövdə ilə davam etməlidir.

Expect: 100-continue olan sorğular üçün istifadə olunur. Server qarşı tərəfin sorğu yaxşı alındığını bildirir. Müasır veb-tətbiqlərdə nadir hallarda görülür.

RFC 9110 ↗
101

Protokollar Dəyişdirilir

Server müştərinin tələb etdiyi protokollara keçir.

Ən çox WebSocket yüksəltmələri üçün istifadə olunur — müştəri Upgrade: websocket istəyir və server 101 ilə cavab verir.

RFC 9110 ↗
102

İşlənir

Server sorğunu almışdır və işləməkdədir, lakin hələ cavab yoxdur.

Uzun əməliyyatlar zamanı müştəri vaxtının sona çatmasını qorumaq üçün WebDAV aralıq cavabı. Köhnəlmişdir — müasır serverlər bunu göndərməməlidir.

RFC 2518 ↗
103

Erkən İpuçları

Son cavabdan əvvəl göndərilən ön açılan başlıqlar.

Serverlərin son cavab hazırlanarkən Link başlıqlarını (yükləmə/əvvəlcədən bağlantı) göndərməsinə imkan verir, beləliklə brauzerləri kritik əsətləri daha tez yükləməyə başlaya bilər.

RFC 8297 ↗
200

OK

Sorğu uğurlu oldu.

Standart uğur cavabı. Məna HTTP metodundan asılıdır: GET → resurs qaytarılır, POST/PUT → əməliyyat tamamlanır.

RFC 9110 ↗
201

Yaradıldı

Yeni resurs uğurla yaradıldı.

POST-dan sonra əlverişli. Cavab yeni resursun URL-ə işarə edən Location başlığını ehtiva etməlidir.

RFC 9110 ↗
202

Qəbul edildi

Sorğu işlənmə üçün qəbul edildi, lakin işlənmə tamamlanmamışdır.

Asinxron əməliyyatlar üçün — server işi cərgəyə salmışdır. Müştəri vəziyyət nöqtəsini sorğulamalı və ya daha sonra yenidən yoxlamalıdır.

RFC 9110 ↗
203

Qeyri-Rəsmi Məlumat

Cavab çevrilən vəkil tərəfindən dəyişdirildi.

Sorğu uğurlu oldu, lakin aralı (keşləmə və ya çevrilən vəkil kimi) mənbə serverdən yükü dəyişdirdi — məsələn, şəkilləri yenidən sıxlaşdırma. Əməliyyatda nadir.

RFC 9110 ↗
204

Məzmun Yoxdur

Sorğu uğurlu oldu ancaq cavab yəhəri yoxdur.

Çoğunlukla DELETE əməliyyatları və ya cavab yəhər-dən qayıtmayan PUT yeniləmələri üçün istifadə olunur. Müştəri cari səhifədən uzaqlaşmamalıdır.

RFC 9110 ↗
205

Məzmunu Sıfırla

Sorğu uğurlu oldu; müştəri sənəd baxışını sıfırlamalıdır.

204 kimi, cavab yəhəri qaytarılmır — ancaq müştəriyə sorğunu yaratmış formu və ya baxışı sıfırlaması əlavə olaraq deyilir (məs. sonrakı giriş üçün form sahələrini təmizləyin).

RFC 9110 ↗
206

Qismən Məzmun

Server yalnız resursin bir hissəsini çatdırıb.

Range sorğusuna cavab. Video pleylərləri və yükləmə menecerləri tərəfindən dayanmış yükləmələri davam etdirmək və ya böyük faylları axını üçün istifadə olunur.

RFC 9110 ↗
207

Çox-Status

Cavab yəhəri bir neçə əməliyyat üçün bir neçə vəziyyət kodunu ehtiva edir.

WebDAV: XML yəhəri bir neçə alt-əməliyyatın nəticəsini müstəqil şəkildə bildirər — məs. bəziləri uğurlu olan və bəziləri uğursuz olan kütləvi köçürmə.

RFC 4918 ↗
208

Artıq Bildirildi

Koleksiyonun üzvləri cavabda daha əvvəl sadalandı.

WebDAV: 207 Çox-Status cavabları daxilində istifadə olunur, cərgələrin eyni koleksiyanın üzvlərini təkrar-təkrar verməkdən qaçmaq üçün.

RFC 5842 ↗
226

IM İstifadə Edildi

Cavab resursa tətbiq olunan nümunə manipulyasiyalarının nəticəsidir.

Delta kodlaşdırması: server tam resurs əvəzinə əvvəlki versiyaya qarşı bir fərq qaytarır, bant genişliyini təqfir edir. Çox nadir hallarda həyata keçirilir.

RFC 3229 ↗
300

Çox Seçim

Resursin bir neçə təmsili mövcuddur.

Server bir neçə seçim təqdim edir (məs. fərqli formatlar və ya dillər) və müştəri birini seçməlidir. Nadir hallarda istifadə olunur, çünki avtomatik məzmun danışıqları ümumiyyətlə bunu idarə edir.

RFC 9110 ↗
301

Daimi Olaraq Köçdü

Resurs daimi olaraq yeni URL-ə köçdü.

Daimi URL dəyişiklikləri üçün istifadə edin — arama mühərrikləri indeksini yenilələyəcəklər. SEO səlahiyyəti yeni URL-ə keçir.

RFC 9110 ↗
302

Tapıldı (Müvəqqəti Yönləndirmə)

Resurs müvəqqəti olaraq fərqli URL-dədir.

Yönləndirmənin daimi olmadığını göstərir. Keşləmə 301-dən daha az ağır olur. 'Login lazımdır, /login-ə yönləndirilib' kimi şeylər üçün istifadə edin.

RFC 9110 ↗
303

Başqa Bax

GET istifadə edərək fərqli URL-ə yönləndir.

POST təqdimləri sonra istifadə olunur — cavab "POST işiniz uğurlu oldu, nəticə üçün bu GET URL-ə baxın" deyir. Brauzerləri həmişə yeni URL-ə GET edər.

RFC 9110 ↗
304

Dəyişdirilmədi

Keşlənmiş versiya hələ də etibarlıdır; onu istifadə edin.

Şərti sorğuya cavab (If-None-Match və ya If-Modified-Since başlıqları ilə). Bant genişliyini təqfir edir — heç bir cavab yəhəri qaytarılmır.

RFC 9110 ↗
307

Müvəqqəti Yönləndirmə

302 kimi ancaq orijinal HTTP metodunu saxlayır.

Orijinal POST idi, yönləndirmə də POST istifadə edir. Metod saxlanması məsələləri olduqda 302-yə müasır alternativ.

RFC 9110 ↗
308

Daimi Yönləndirmə

301 kimi ancaq orijinal HTTP metodunu saxlayır.

Yönləndirmədən sonra POST sorğularının POST olaraq qalması istənildiyi zaman 301-in müasır əvəzləyicisi.

RFC 9110 ↗
400

Əhli Harekat Sorğu

Server sorğunu əhli harekat sintaksisi səbəbindən başa düşə bilmədi.

Ümumi səbəblər: yəhərdə əhli harekat JSON, etibarsız sorğu parametrləri və ya itkin tələb sahələri. Sorğu yəhəri və başlıqlarını yoxlayın.

RFC 9110 ↗
401

Qeyri-İcazəli

Kimlik doğrulama tələb olunur və sağlanmamışdır.

Müştəri kimlik doğrulama kimlik məlumatını daxil etməlidir (Authorization başlığı, fəlakət, token). 'Qeyri-İcazəli' yanlış bir termin — əslində 'tətiqsiz' mənsub.

RFC 9110 ↗
402

Ödəmə Tələb Olunur

Gələcəklə istifadə üçün ayrılmışdır — bəzən ödənişli API səviyyələri üçün istifadə olunur.

Əvvəlcə rəqəmsal ödənişlər üçün nəzərdə tutulmuşdur. Müasır istifadə: API-lər bəzən istifadəçi ödənişli kvotasını aşdığı zaman 402 qaytarırlar.

RFC 9110 ↗
403

Qadağan

Müştəri kimləşdirilmişdir ancaq icazəsi yoxdur.

401-dən fərqli — istifadəçi DAXİL LOGİN, lakin onların hesabının bu resurs üçün icazəsi yoxdur. Rol/icazə mənətiqini yoxlayın.

RFC 9110 ↗
404

Tapılmadı

Tələb olunan resurs mövcud deyil.

Ya URL yanlışdır, ya resurs silinib, ya da heç vaxt mövcud olmayıb. Serverləri bəzən 403-ün daha doğru olduğunu gizlətmək üçün 404 qaytarırlar.

RFC 9110 ↗
405

Metodun İcazəsi Yoxdur

Bu resurs üçün istifadə olunan HTTP metodu icazə verilmir.

Məsələn, yalnız POST qəbul edən nöqtəyə GET sorğusu. Cavab icazə verilən metodları sadalayan Allow başlığını ehtiva etməlidir.

RFC 9110 ↗
406

Qəbul Edilməz

Heç bir təmsilçi müştərinin Accept başlıqlarına uyğun gəlmir.

Müştəri məzmun tipi, dil və ya kodlaşdırmayı tələb etdi (Accept, Accept-Language, Accept-Encoding vasitəsi ilə) server satisfaksiya verə bilməz. Çox server ciddi danışıqları keçib birincil məzmunu qaytarırlar.

RFC 9110 ↗
407

Vəkil Kimlik Doğrulaması Tələb Olunur

Müştəri əvvəl proxy ilə təsdiqləməlidir.

401 kimi, ancaq vəkil tərəfindən verilir: müştəri Proxy-Authorization kimlik məlumatını göndərməlidir. Şəxsi şəbəkələrdə autentifikasiyalı vəkillərlə görülür.

RFC 9110 ↗
408

Sorğunun Vaxt Limiti Keçildi

Server sorğunu gözləməkdə zaman limiti keçdi.

Müştəri sorğu gövdəsini göndərməkdə çox uzun vaxt aldı və ya bağlantı boş qaldı. Sorğuyu yenidən cəhd edin.

RFC 9110 ↗
409

Konflikt

Sorğu resursun cari vəziyyəti ilə ziddiyyət təşkil edir.

Tipik olaraq eyni zamanda redaktə konfliktləri və ya duplikat resurs yaratma üçün qaytarılır (məsələn, artıq mövcud olan e-poçtla istifadəçi yaratmaq).

RFC 9110 ↗
410

Silindi

Resurs silindi və geri dönməyəcək.

404-dən daha güclü — server açıq şəkildə bilir ki, resurs ƏVVƏL mövcud idi, lakin daimi olaraq silinib. Axtarış mühərrikləri indeksdən çıxaracaqlar.

RFC 9110 ↗
411

Uzunluq Tələb Olunur

Server Content-Length başlığını tələb edir.

Sorğu Content-Length başlığı olmadığından rədd edildi və server bilinməyən ölçüdə gövdələri rədd edir. Başlığı əlavə edin və yenidən cəhd edin.

RFC 9110 ↗
412

Ön Şərt Yerinə Yetirilmədi

Sorğu başlıqlarındakı şərt yerinə yetirilmədi.

If-Match və ya If-Unmodified-Since kimi şərti başlıqlar uğursuz olduqda qaytarılır — tipik olaraq optimistik sıçrama: başqası son versiyandan bəri resursu dəyişdi. Yenidən alın və yenidən cəhd edin.

RFC 9110 ↗
413

Yük Çox Böyükdür

Sorğu gövdəsi serverin ölçü limitini aşır.

Böyük faylları yükləyərkən yaygın. Server konfigürasyonu (nginx, apache) maksimum gövdə ölçüsü təyin edir. Serverin konfigürasyonunu yoxlayın.

RFC 9110 ↗
414

URI Çox Uzundur

Sorğu URL-i serverin uzunluq limitini aşır.

Adətən çox uzun sorğu sətirlərindən (məsələn, GET-də məlumat kodlaşdırılması) qaynaqlanır. POST gövdəsinə keçin və ya serveri kontrolə alırsınızsa limitini artırın.

RFC 9110 ↗
415

Dəstəklənməyən Media Tipi

Server göndərilən Content-Type-i idarə edə bilməz.

Məsələn, application/xml-i yalnız application/json qəbul edən serverə göndərmək. Content-Type başlığını düzgün təyin edin.

RFC 9110 ↗
416

Diapazon Qəbul Edilə Bilməz

İstənilən bayt diapazonı resursun ölçüsündən kənardadır.

Range başlığı faylda olmayan bir hissə istəyir — məsələn, faylın sonundan sonra yükləməni təkrarlamaq. Cavab Content-Range ilə faktiki ölçüsü daxil etməlidir.

RFC 9110 ↗
417

Gözlənti Yerinə Yetirilmədi

Server Expect başlığının tələblərini yerinə yetirə bilməz.

Server Expect: 100-continue-i dəstəkləmədiyi zaman göndərilir. Bəzi müştərilər böyük POST-lərdə bu başlığı varsayılan olaraq göndərir; deaktiv etmək adətən xətaları həll edir.

RFC 9110 ↗
418

Mən bir çay qabıyam

Server çay qabı olduğu üçün qəhvə hazırlamaq olar.

1998-dən gələn April Fool-lar şakası (RFC 2324). Bəzi real API-lər bunu şakalar və ya köhnə uçqun nöqtələrini qeyd etmək üçün istifadə edir. Produksiyada istifadə üçün deyil.

RFC 2324 ↗
421

Səhv Yönəldilmiş Sorğu

Sorğu buna cavab verə bilməyən serverə göndərildi.

HTTP/2 bağlantısı yenidən istifadə ilə yaygın: sorğu hədəf hostadına konfiqurasiya edilməmiş serverə çatdı. Müştəri yeni bağlantıda yenidən cəhd etməlidir.

RFC 9110 ↗
422

Emal Edilə Bilməyən Məzmun

Sorğu sintaksik cəhətdən düzgün, lakin semantik cəhətdən səhvdir.

Məsələn, JSON düzgün şəkildə parse olundu, lakin tələb olunan sahə çatışmır və ya sahə dəyəri diapazondan çıxırdı. REST API doğrulama cavablarında yaygın.

RFC 9110 ↗
423

Qilitlənib

Resurs qilitlənib.

WebDAV: mənbə və ya məqsəd resursu başqa müştəri tərəfindən qilitlənib, buna görə əməliyyat davam edə bilməz. Suitkasenin açılmasını gözləyin və ya düzgün jetoni ilə təşkil edin.

RFC 4918 ↗
424

Asılı Uğursuzluq

Sorğu əvvəlki asılı sorğunun uğursuzluğuna görə uğursuz oldu.

WebDAV: asılı əməliyyatların zəncirində, əvvəlki hərəkət uğursuz oldu, buna görə bu heç də yerinə yetirilmədi. Root səbəbə görə əvvəlki uğursuzluğu araşdırın.

RFC 4918 ↗
425

Çox Tez

Server təkrar sorğunun riskini almayan sorğunu emal etməyi rədd edir.

TLS 1.3 0-RTT (erkən məlumat) ilə bağlı: server mümkün təkrar sorğuyu emal etmə riskini almayacaq. Müştəri əl sıxılması tamamlandıqdan sonra yenidən cəhd etməlidir.

RFC 8470 ↗
426

Yeniləşdirmə Tələb Olunur

Müştəri fərqli bir protokola keçməlidir.

Server cari protokol üstündən sorğuya xidmət etməyi rədd edir, lakin yeniləşdirmədən sonra — cavab Upgrade başlığını tələb olunan protokolu adlandırır.

RFC 9110 ↗
428

Ön Şərt Tələb Olunur

Server sorğunun şərti olmasını tələb edir.

Server şərti başlıqları tələb edir (If-Match kimi) itirilmiş yeniləşdirmə konfliktlərini qoymaq üçün. Resursu alın, onun ETag-ini tutun və If-Match ilə yenidən göndərin.

RFC 6585 ↗
429

Çox Çox Sorğu

Müştəri dərəcə məhdudiyyətinə tətbiq olunur.

Yavaşlayın. Cavab Nə vaxt yenidən cəhd etməyə görə Retry-After başlığını daxil etməlidir. Sorğu kvotası olan API-lər ilə yaygın.

RFC 6585 ↗
431

Sorğu Başlıq Sahələri Çox Böyükdür

Başlıqlar server tərəfindən emal etmək üçün çox böyükdür.

Ya bir başlıq ya da cəmi başlıq ölçüsü limitini aşır — əksər hallarda ləkəli kukilər. Kukiləri təmizləyin və ya tətbiqinizdə saxlananları azaldın.

RFC 6585 ↗
451

Hüquqi Səbəblərdən Əlçatmaz

Hüquqi tələblərə görə əlçatış rədd olundu.

Resurs hüquqi səbəblərdən — senzura, məhkəmə əmrləri və ya regional qanunvericilik bloklanıb. Nömrə Fahrenheit 451 romanına işarədir.

RFC 7725 ↗
500

Daxili Server Xətası

Server gözlənilməyən şərait ilə qarşılaşdı.

Server tərəfində xətalar üçün ümumi bir qapama. Server qeydlərini yoxlayın, həqiqi səbəb: idarə olunmayan istisna, məlumat bazası xətası və s.

RFC 9110 ↗
501

Tətbiq Edilmədi

Server istənilən funksionalığı dəstəkləmir.

Məsələn, server HTTP metodunu tanımır. Praktikada nadir — daha tez-tez 405 görəcəksiniz.

RFC 9110 ↗
502

Pis Gateway

Gateway kimi işləyən server, yuxarıdakı serverədən pis cavab aldı.

Mikro xidmət arxitekturalarında yaygın. Yük balanslaşdırıcı və ya əks proxy backend xidmətindən səhv cavab aldı.

RFC 9110 ↗
503

Xidmət Əlçatmaz

Server müvəqqəti olaraq sorğunu idarə edə bilməz.

Yaxud texniki sebi ilə deaktiv, yaxud yüklənmiş. Cavab Retry-After başlığını daxil etməlidir. Tez-tez yerləşdirmə zamanı qaytarılır.

RFC 9110 ↗
504

Gateway Zaman Limitini Keçdi

Gateway serveri yuxarıdakı cavabı gözləməkdə zaman limitini keçdi.

Backend xidməti kifayət qədər tez cavab vermədi. Yuxarıdakı xidmət sağlamlığını və zaman kəsilmə konfigürasyonlarını yoxlayın.

RFC 9110 ↗
505

HTTP Versiyası Dəstəklənmir

Server sorğuda istifadə olunan HTTP versiyasını dəstəkləmir.

Sorğunun əsas HTTP versiyası server tərəfindən dəstəklənmir. Müasır müştəriler ilə demək olar ki heç vaxt görülmür.

RFC 9110 ↗
506

Variant Də Müzakirə Edir

Server məzmun müzakirəsi uyğunsuzluğu var.

Şəffaf məzmun müzakirəsi bir dövrəyə girdi: seçilmiş variant özü-özünü müzakirə etməyə konfiqurasiya edilib. Server konfigürasyonu xətasını göstərir.

RFC 2295 ↗
507

Qeyri-Kafi Yer

Server disk yerində qalmayıb.

WebDAV-xas əsl, lakin bəzən ümumi serverlərdən istifadə olunur. Server sorğunu depo məhdudiyyətlərinə görə saxlaya bilməyəcəyi anlamına gəlir.

RFC 4918 ↗
508

Dövrə Aşkarlanıb

Server sorğunu emaliyyat zamanı sonsuz dövrə aşkarladı.

WebDAV: Depth: infinity sorğusunun emalı bir dövrəyə girdi (məsələn, dairəvi bağlantılar). Əməliyyat dayandırıldı.

RFC 5842 ↗
510

Genişləndirilmədi

Sorğuya daha çox genişlənmələr tələb olunur.

Köhnə HTTP Extension Framework-dən: server sorğuya cavab vermədən əvvəl daha çox məlumat lazımdır. Müasır vebdə praktiki olaraq istifadə olunmur.

RFC 2774 ↗
511

Şəbəkə Təsdiqləməsi Tələb Olunur

Müştəri şəbəkə əlçatışı əldə etməlidir.

Asırlıq portallar tərəfindən (otel/aeroport WiFi) istifadəçinin xarici saytlara daxil olmadan əvvəl şəbəkəyə daxil olması lazımını göstərmək üçün istifadə olunur.

RFC 6585 ↗

Ümumi istifadələr

  • API Dizaynı üçün ReferansREST API-ləri dizayn edərkən, hər cavab üçün doğru status kodunu seçin.
  • Xəta Kodlarını Tez BaxınSizin app çaşqın HTTP xətası qaytardığında, bu həqiqətən nə deməkdir.
  • HTTP Statı Kodlarını ÖyrəninHTTP və REST öyrənən tələbə və işçilər üçün hərtərəfli referans.
  • İncident Zamanı Sürətli Referansİncidentin Zamanı Üretim, tez baxın hər status kodu nə deməkdir.
  • API Sənədləşdirmə Üçün ReferansAPI sənədləşdirmə yazarkən, qaytardığınız status kodlarının etibarlı təsvirlərinə bağlantı verin.

Necə İşləyir

Bu alət beş sinifi (1xx–5xx) əhatə edən 63 HTTP status kodunun sabit kodlanmış bir axtarış cədvəli ətrafında qurulmuş istifadəçi-tərəfli bir istinaddır, hər biri onu müəyyən edən RFC nömrəsi ilə annotasiya edilib. Server çağırışı yoxdur, xarici API yoxdur, şəbəkə sorğusu yoxdur — bütün süzgəcləmə və göstəriş JavaScript-in daxili massiv və sətir metodlarından istifadə edərək brauzerdə baş verir.

  1. 1
    Axtarış cədvəli yüklənir
    63 IANA-qeydiyyatlı status kodunun tam dəsti bu alətə birbaşa bir JavaScript massivi kimi qoşulub, hər giriş rəqəmsal kodu, kanonik ingilis adını, kateqoriya sinfini və onu müəyyən edən konkret RFC-ni (məsələn, əksər HTTP/1.1 kodları üçün RFC 9110, 429 Too Many Requests üçün RFC 6585, 418 I'm a Teapot üçün RFC 2324) daşıyır.
  2. 2
    Süzgəc yaddaşda işləyir
    Yazdıqca, ya da bir kateqoriya süzgəci seçdikcə, JavaScript-in Array.filter-i String.includes istifadə edərək sorğunuzu status kodu rəqəmi, kanonik ad, üstəlik həm qısa, həm də uzun təsvir sətirlərinə qarşı yaddaşdakı siyahı üzərində uyğunlaşdırır — debounce gecikməsi yoxdur, server gediş-gəlişi yoxdur.
  3. 3
    Detallar RFC keçidi ilə genişlənir
    Hər nəticə bir HTML details/summary elementi kimi render olunur. Bir girişi genişləndirmək uzun-forma izahı və rfc-editor.org-da mötəbər RFC-yə birbaşa bir keçidi üzə çıxarır, ona görə istənilən kod üçün dəqiq spesifikasiya mətnini oxuya bilərsiniz.
  4. 4
    Dərin keçidlər və mübadilə buferi kopyalanması
    Bir girişi açmaq URL heşini kod nömrəsinə yeniləyir (məsələn, #404), səhifəni paylaşıla bilən və əlfəcin-dostu edərək. Kopyala düyməsi kanonik sətri (məsələn, '404 Not Found') brauzerin navigator.clipboard API-si vasitəsilə mübadilə buferinə yazır.

Əlaqəli Alətlər

Tez-tez Verilən Suallar