Hata kodları ve istemci kararları

HTTP durumunu, makine kodunu ve alan bilgisini birlikte değerlendirin; güvenli yeniden denemeyi doğru seçin.

Son güncelleme: 2026-11-10

Bu sayfada

Hata zarfını okuyun v1 kimlik, kapsam ve girdi kodları Anahtar ve yönetim kodları Lisans ve kurulum kodları Düzenleme ve önizleme çakışmaları Çıktı, OGC ve webhook kodları Uca özgü diğer hata kodları HTTP hatasından ayrı sonuç ve uyarı kodları WMS XML hata kodları Doğrulama, ağ hatası ve yeniden deneme

Hata zarfını okuyun

v1 hatalarında detail, kod ve alan alanları bulunur. detail okunabilir metin veya istek doğrulama hatalarında dizi olabilir. Özel makine kodu verilmemiş bir ret, kod: "hata" olarak döner. İstemci önce HTTP durumuna, sonra kod ve alan değerlerine bakmalıdır.

{
  "detail": "İşlem kimliği gerekli.",
  "kod": "alan",
  "alan": "request_id"
}

Bu temsili yanıt, v1 düzenlemede işlem kimliği eksik olduğunda 400 durumuyla kullanılır. alan bazen null, bazen alan adı veya işlem konumu olabilir. Metindeki belirli bir sözcüğe göre otomatik karar vermeyin.

Çerezli uygulama uçlarında hata gövdesi aynı ek alanları her zaman içermez. OGC WMS parametre hataları XML dönebilir; kimlik hataları ortak JSON zarfını korur. Gövdeyi ayrıştırmadan Content-Type başlığını kontrol edin.

v1 kimlik, kapsam ve girdi kodları

`kod`	HTTP	Anlamı	İstemci adımı
`anahtar`	401	Anahtar eksik, geçersiz, iptal edilmiş veya kullanılamıyor.	Güvenli anahtar yapılandırmasını kontrol edin; aynı sırla sürekli tekrar etmeyin.
`oturum`	401	İşlemin gerektirdiği kullanıcı oturumu yok.	İlgili oturum akışını yenileyin; v1 için Bearer kullanın.
`yetki`	403	Güncel kullanıcı yetkisi işlemi karşılamıyor.	Rol ve proje erişimini kontrol edin.
`kapsam`	403	Anahtarın yazma kapsamı yok.	Yetkili kullanıcıyla uygun kapsamlı anahtar oluşturun.
`kapsam`	400	Anahtar oluşturma kapsamı geçersiz.	`oku` veya `oku` ve `yaz` dizisini gönderin.
`bulunamadi`	404	Kayıt yok veya erişim kapsamında değil.	Kimliği ve proje kapsamını yenileyin; varlık tahmini yapmayın.
`alan`	400	Parametre, kimlik, kutu veya zorunlu işlem alanı geçersiz.	`alan` değerindeki girdiyi düzeltin.
`modul_kapali`	403	Okunmak veya yazılmak istenen modül kapalı.	Projenin etkin modüllerini kontrol edin.
`modul_yetkisi`	403	Üyeliğin modül yazma izni yok.	Proje üyeliğini yetkili yöneticiyle değerlendirin.
`bolge_disi`	403	Kayıt yazılabilir bölgenin dışında.	İşlem kapsamını izinli bölgeyle eşleştirin.
`bolge_kapsam_disi`	403	İşlem veya kayıt bölge kısıtlı üyeliğe uygun değil.	Uygun yetkiyle çalışın; geometrik konumu tek ölçüt saymayın.
`bolge_yok`	403	Üyeliğin işaret ettiği bölge bulunamıyor.	Üyelik kapsamını düzeltin.
`sinir`	429	İstek sayacı yeni isteği reddetti.	`Retry-After` saniyesini bekleyin.
`hata`	Duruma bağlı	Özel kod verilmemiş hata; şema reddi, yöntem veya kayıt çakışması dahil.	HTTP durumu ve `detail` türüne göre işlem yapın.

modul_kapali özel işlemlerde başka bir ret durumu ile de gelebilir; tablo v1 ortak okuma/yazma kapısının davranışını özetler. Ucun döndürdüğü gerçek HTTP durumu esas alınır.

Anahtar ve yönetim kodları

`kod`	HTTP	Anlamı ve yapılacak işlem
`kurum_yok`	400	Hesabın anahtar oluşturabileceği kurum yok; kurum kullanıcısını kontrol edin.
`anahtar_sinir`	400	Etkin anahtar sınırına ulaşıldı; kullanılmayan anahtarları inceleyin.
`bitis`	400	Anahtar bitiş zamanı geçersiz; saat dilimini ve gelecekteki anı düzeltin.
`kurum_askida`	403	Kurum yönetim işlemleri askıda; yetkili kurum yöneticisine bildirin.
`uyelik_yetkisi`	403	Üyelik yönetimi için proje yöneticisi yetkisi gerekir.
`erisim_yetkisi`	403	Projenin erişim seçimini değiştirmeye yetki yok.
`surum_cakismasi`	409	Üyelik sürümü değişti; güncel üyeliği okuyup yeniden değerlendirin.

Lisans ve kurulum kodları

`kod`	HTTP	Anlamı ve yapılacak işlem
`lisans_salt_okunur`	403	Lisans veya kullanım koşulu yazmaya izin vermiyor; lisans durumunu okuyun.
`lisans_sinif_yok`	403	İşlemin kurulum lisans sınıfı tanınmıyor; kurulumu yöneten kişiye bildirin.
`kontrol_merkezi`	403	İşlem merkezi kurum yönetimine ait; proje API anahtarıyla tekrar etmeyin.
`saat_donem`	503	Saat dönemi nedeniyle işlem tamamlanamadı; sistem saatini ve kurulum durumunu inceleyin.
`bicim`, `alan`, `imza`, `eslesme`	400	Lisans dosyasının biçimi, alanı veya doğrulaması uygun değil; dosyayı ve hedef kurulumu kontrol edin.
`kurulum`	400	Dosya veya işlem bu kurulumla eşleşmiyor.
`cakisma`, `seq`	409	Aynı lisans kimliği farklı içerikle kullanılmış veya işlem sırası eski; yeniden yüklemeden mevcut kaydı inceleyin.

Aynı kod farklı alt akışlarda farklı HTTP durumu taşıyabilir. Örneğin fazla büyük lisans zarfı bicim ile 413, bilinmeyen kurulum anahtarı anahtar ile 404 dönebilir. kod değerini tek başına durum kodunun yerine kullanmayın.

Düzenleme ve önizleme çakışmaları

`kod`	HTTP	Anlamı ve yapılacak işlem
`version`, `surum`	409	Kayıt sürümü değişti; kaydı yeniden okuyun.
`dogrulama_eski`	409	Tasarımın doğrulaması güncel değil; yeniden doğrulayın.
`cakisma`, `cakisma_yeni`	409	Tasarım ve taban arasında çözülmesi gereken değişiklik var.
`ihlal`	409	Yayın veya bağlantı kuralları sonucu uygulanamıyor; raporu düzeltin.
`fark_bos`	409	Yayınlanacak tasarım farkı yok; kapsamı inceleyin.
`tasarim_kilitli`, `saha_acik`	403	Tasarım veya saha durumunda bu düzenleme yolu kapalı; uygun iş akışına dönün.
`tasarim_durum`	409	İstenen tasarım eylemi mevcut durumla uyumlu değil.

Genel v1 /edit sürüm çatışması veya farklı ops ile aynı request_id tekrarı, özel kod bulunmadığında 409 ve hata olarak dönebilir. Bütün çakışmaların version kodu taşıyacağını varsaymayın. Eski sürümü artırıp aynı değişikliği otomatik göndermeyin.

Çıktı, OGC ve webhook kodları

`kod`	HTTP	Anlamı ve yapılacak işlem
`parametre`	400	Çıktı biçimi veya seçim geçersiz; `alan` bilgisini düzeltin.
`cikti_sinir`	400	Çıktı kapsamı satır veya düğüm sınırına takıldı; kapsamı daraltın.
`cikti_mesgul`	409	Üretim sürüyor; daha sonra tekrar deneyin.
`cikti_sure`	409	Üretim süre bütçesinde tamamlanamadı; kapsamı daraltın.
`cikti_boyut`	409	Dosya veya paket boyu uygun değil; kapsamı daraltın.
`ogc_kapali`	404	OGC yayını bu kurulumda kapalı.
`crs_desteklenmiyor`	400	Seçilen koordinat sistemi ilanda yok; koleksiyonun `crs` listesini kullanın.
`webhook_kapali`	404	Webhook yönetimi bu kurulumda kapalı.
`webhook_url`, `webhook_hedef`	400	Hedef adres biçimi veya ağ erişim kuralı uygun değil; `url` alanını kontrol edin.
`webhook_sinir`	400	Etkin abonelik sınırına ulaşıldı; kurum aboneliklerini inceleyin.

Uca özgü diğer hata kodları

Aşağıdaki dizin, bu belge kapsamındaki uçların kaynakta açıkça tanımladığı diğer hata kodlarını tamamlar. HTTP sütununda aynı kod için birden fazla durum bulunabilir. Alan sütunu kaynakta görülen alan adlarını veya İlgili alan ifadesini gösterir; —, alanın verilmediği ya da null olduğu durumdur. Alt alan ve dizi konumu çalışma sırasında belirlenebilir.

Bu kodlar uygulama uçlarında da görülebilir; listedeki bir kodun bulunması aynı ucun v1 anahtarı kabul ettiği anlamına gelmez. Kimlik türünü uç referansından okuyun. Genel istisnalar için ortak hata zarfı ve HTTP durumu uygulanır.

Kod dizini: A–D

Kod	HTTP	Alan	Anlamı ve istemci adımı
`aday`	409	—	Tek işlemde yeniden değerlendirilen devre kapsamı büyük; işlemi anlamlı parçalara ayırın.
`alanlar`	400	`alanlar`, `request_id`, `yeniden`	Ölçüm uygulamasındaki alan seçimi uygun değil; gönderilen alanları ve işlem kimliğini kontrol edin.
`ara_uc`	409	—	Kablo işlemi bir devrenin ara çapasını değiştiriyor; devre çapasını önce değerlendirin.
`aralik`	400	İlgili alan	Sayısal değer veya dalga boyu izinli aralığın dışında; ilgili alanı düzeltin.
`arsiv`	409	—	Arşivli projede bu tasarım veya saha işlemi yapılamaz; proje durumunu kontrol edin.
`asbuilt_acik`	409	—	İş paketinde açık yapım sonrası çalışma var; mevcut çalışmanın durumunu sonuçlandırın.
`ayni_kisi`	403	—	Tasarımı gönderen kişinin onayına izin verilmiyor; yetkili farklı inceleyenle ilerleyin.
`baglanti`	409	—	Taşınacak kablo ucunda mevcut bağlantılar var; bağlantı kaldırmanın kapsamını değerlendirin.
`bagli_degil`	409	—	Teknik yol güncellenemiyor; kayıtlı bağlantı ve çapaları kontrol edin.
`bbox`	400	`bbox`	Saha paketi için kutu geçersiz; dikdörtgen sınırını düzeltin.
`birim`	400	`birim`	Ölçüm birimi ölçüm türüne uymuyor; güç ve kayıp birimlerini ayırın.
`bolge_gecersiz`	400	`bolge_ids`	Üyelik bölge listesi geçersiz; proje alanlarını ve tekilliği kontrol edin.
`bolunemez`	400, 409	`length_m`, İlgili alan	Kablo değeri veya konumu bölmeye uygun değil; alanı düzeltip yeniden önizleyin.
`cakisan_bant`	400	İlgili alan	Optik profilin dalga boyu bantları çakışıyor; aralıkları düzeltin.
`capa_belirsiz`	400	`capa`	Ölçüm yönü başlangıç çapasını belirlemiyor; uygun çapa seçin.
`celisik`	400	`olcum`	Ölçüm seçimiyle ayrıca gönderilen mesafe veya çapa çelişiyor; girdileri ayırın.
`crs_uyusmazligi`	400	`file`	Dosyadaki katmanların koordinat sistemleri uyuşmuyor veya belirsiz; aynı koordinat sistemine kaydedin ya da katmanları ayrı aktarın.
`cihaz`	403	`cihaz_id`	Saha paketinin cihaz kimliği uyuşmuyor; doğru paket ve cihaz kaydını kullanın.
`cozum_gecersiz`	400	`cozumler`	Tasarım çakışması için seçim uygun değil; geçerli seçimleri yeniden kaydedin.
`dal_dal`	400	—	Mevcut tasarımdan yeni tasarım açılamıyor; ana projeden başlayın.
`deger`	400	`deger`	SOR uçtan uca kayıp değeri uygun değil; uygulanacak değeri kontrol edin.
`degistirilemez`	400	`hesap`, `props`	Optik hesap değiştirilemez; güncel veri için hesap oluşturma akışını kullanın.
`devre`	400	`devreler`	Devre seçimi geçersiz; ilgili projedeki devre kimliklerini kontrol edin.
`dis`	409	—	Cihazı taşımak dış bağlantıları etkiliyor; bağlantıları önce değerlendirin.
`dosya`	400	`dosya`	Dosya üst verisi geçersiz; dosyanın kayıt ve hedef bilgilerini kontrol edin.
`dosya_bos`	400	`dosya`	Yüklenen dosyada içerik yok; doğru dosyayı seçin.
`dosya_boyut`	413	`dosya`	Ek dosyası boyutu kabul edilmiyor; uygun boyutta dosya hazırlayın.
`dosya_bozuk`	409	`dosya`	Dosya kaydı veya içerik özeti uyuşmuyor; mevcut içeriği doğrulayıp yeniden yükleyin.
`dosya_okunamadi`	400	`file`	Vektör dosyası okunamadı; kaynak dosyayı ve seçilen aktarım biçimini kontrol edin.
`dosya_tur`	400	`dosya`	Dosya adı, türü veya içerik denetimi uygun değil; desteklenen dosyayı hazırlayın.
`dosya_tutma`	403	`dosya`	Saklanan ölçüm dosyaları kurulumun tutma koşuluna takıldı; depolamayı yöneticiyle değerlendirin.
`dosya_yok`	404	`dosya`	Ölçüm veya ek dosyası bulunamadı; kayıt ve saklama alanını kontrol edin.
`dugum_yok`	404	`dugum`	Çıktı düğümü projede bulunamadı; düğüm kapsamını yenileyin.
`durum`	400	`durum`	Süzme veya kayıt durum seçimi geçersiz; ilgili ucun durum değerlerini kullanın.

Kod dizini: E–K

Kod	HTTP	Alan	Anlamı ve istemci adımı
`eksik`	400	İlgili alan	Birlikte gereken optik profil alanları eksik; ilgili alan grubunu tamamlayın.
`erisim_gecersiz`	400	`erisim`	Proje erişim seçimi uygun değil; kurum veya üyelik seçimini kullanın.
`eslem_yok`	409	`esleme`, `fiber_item.props`, İlgili alan	Tasarımın kayıt başvurusu ana projeyle eşlenemiyor; fark raporundaki başvuruları düzeltin.
`f1_tahmin`	409	—	Kablo işlemi metraj tahminini okunamaz hale getiriyor; boy, pay ve dikey değerleri düzeltin.
`fark`	409	—	Kablo veya devre değerleri uyuşmuyor; farkları inceleyip işlemi yeniden değerlendirin.
`fiyat`	400	İlgili alan	Birim fiyat geçerli sonlu sayı değil; fiyat ve ondalık bilgisini düzeltin.
`format_desteklenmiyor`	400	`file`	Dosya biçimi veya gerekli okuyucu bu kurulumda kullanılamıyor; belgelenen aktarım biçimiyle yeniden hazırlayın.
`gecersiz`	409	İlgili alan	Bölünecek kaydın sayısal alanı okunamıyor; alanı düzeltin veya anlamlı biçimde temizleyin.
`gelecek`	400	İlgili alan	Ölçüm tarihi gelecekte; kaynak tarihi ve saat dilimini kontrol edin.
`geometri`	400	—	Hat veya nokta geometrisi işleme uygun değil; geometriyi düzeltin.
`govde`	400	`format`, `govde`	Gövde veya çıktı biçimi uygun değil; ilgili ucun nesne yapısını kullanın.
`gun`	400	`kod`	Acil lisans kodundaki gün değeri kod türüne uygun değil; kodu sağlayan yetkiliyle doğrulayın.
`guzergah`	409	—	Kablo işlemi güzergâh kaydını tutarsızlaştırıyor; segment sırası ve tekrarları kontrol edin.
`hedef`	400	`hedef`, `hedef.cable`, `hedef.devre`, `hedef.end`, `hedef.eq`, `hedef.n`, `hedef.side`	Ölçüm hedefinin türü, kayıt kimliği veya uç bilgisi geçersiz; hedefi yeniden okuyun.
`hedef_yok`	400, 404	`hedef`, `id`	Ek veya eki bağlayacak kayıt bulunamıyor; proje içindeki hedefi kontrol edin.
`hesap`	400, 409	`type`	Optik hesap bu yolla oluşturulamıyor veya işlemle uyumsuz; hesap akışını kontrol edin.
`hesap_bag`	400	`hesap_id`	Ölçüm seçilen hesapla aynı devre veya port kapsamında değil; hedef ve hesabı eşleştirin.
`ior`	400	`ior`	Grup kırılma indisi uygun değil; ölçümdeki değeri ve izinli aralığı kontrol edin.
`is_paketi_durum`	409	—	İş paketi durumu istenen eyleme izin vermiyor; durum akışını kontrol edin.
`istek_kimligi`	409	`request_id`	Saha işlemi kimliği önceki kayıtla uyuşmuyor; aynı işin kaydedilen sonucunu inceleyin.
`iz`	409	—	Kablo işlemi iz uzunluğunu okunamaz hale getiriyor; boy ve pay girdilerini düzeltin.
`kablo_uclari`	400	`kablo_uclari`	Ölçüm anındaki kablo uçlarını sunucu kaydeder; istemciden değiştirmeyin.
`kalem`	400	`kalemler`	Birim fiyat kalemleri eksik veya geçersiz; tam kalem tablosunu gönderin.
`kapsam_gecersiz`	400	`kapsam`	İş paketi kapsamı geçersiz; kapsam kayıtlarını ve liste biçimini düzeltin.
`kaynak_ad`	400	`ad`	Veri kaynağının adı boş, geçersiz veya kullanımda; uygun ad seçin.
`kaynak_kullanimda`	409	`kaynak`	Kaynağın henüz yayınlanmamış aktarımı var; mevcut tasarımın sonucunu değerlendirin.
`kaynak_yok`	404	`kaynak`	Veri kaynağı bulunamadı; kaynak listesini yenileyin.
`kesik`	409	—	Kablonun kesik lif kaydı işleme uygun değil; liflerin devam ve kesik durumlarını inceleyin.
`kopuk`	409	—	Seçilen devre yolu topolojide yürünemiyor; yolu veya kayıtlı bağlantıları düzeltin.
`kopya`	400	`kopya`	Kütüphane kopyası yalnız yeni profil oluştururken verilir; güncellemeden çıkarın.
`korunamaz`	409	`length_m`, `paylar`, `slack_m`	Kablo bölme mevcut boy veya pay bilgisini koruyamıyor; önizlemedeki alanları düzeltin.
`kota`	400	`acil_azami`	Lisansın acil uzatma hakkı kullanılamıyor; lisans durumunu inceleyin.
`kullanici_yok`	404	`user_id`	Üyelik kullanıcısı bulunamadı; kurum kullanıcı listesini yenileyin.
`kullanildi`	400	`seq`	Acil kod kullanılmış veya daha yeni işlem var; mevcut lisans sırasını kontrol edin.
`kullanim_bicim`	400	`kablo/cihaz`	Kablo veya cihaz kullanım sorgusu uygun değil; sorgu nesnelerini düzeltin.

Kod dizini: L–P

Kod	HTTP	Alan	Anlamı ve istemci adımı
`lif_bantlar`	400	İlgili alan	Kablo optik profilinde gerekli lif bandı tablosu yok; uygun profil seçin.
`lif_olcum`	409	`olcum`	İşlem lif ölçümünün fiziksel kapsamını değiştiriyor; ölçümün hedefini önce değerlendirin.
`lisans`	400	`license_id`	Etkin lisans bu acil kodla eşleşmiyor veya yok; lisans kimliğini kontrol edin.
`mac`	400	`kod`	Acil lisans kodunun doğrulaması bu lisans, kurulum veya tarih için geçerli değil; doğru kurulum kodunu kontrol edin.
`mesgul`	503	—	Sunucu işlemi şu anda başlatamıyor; yanıttaki `Retry-After` değerini bekleyin ve yazmanın sonucunu doğrulayın.
`metin`	400	İlgili alan	Metin alanı türü veya uzunluğu uygun değil; ilgili alanı düzeltin.
`metraj`	409	`length`, `lifler.L_m`	Metraj hesabında okunamayan boy oluşuyor; geometri, pay ve profil değerlerini düzeltin.
`min_max`	400	İlgili alan	Alt ve üst değerlerin sırası veya eşitsizliği uygun değil; aralığı düzeltin.
`modul_gecersiz`	400	`moduller`	Üyeliğin modül listesi geçersiz; etkin ve tekrarsız modülleri gönderin.
`negatif`	409	`slack_m`, `vertical_m`	Kablo birleştirme için pay veya dikey boy negatif; kaynak değerleri düzeltin veya anlamlı biçimde temizleyin.
`nitelik`	400	`kayip_niteligi`, `nitelik`	Optik profil veya kayıp niteliği geçersiz; ilgili alanın izinli seçimini kullanın.
`nm`	400	`nm`	Dalga boyu değeri geçersiz; ölçüm aralığına uygun tam sayı kullanın.
`not_gerekli`	400	`notu`	Karar veya ret gerekçesi eksik; açıklamayı tamamlayın.
`olay`	400	`olay`	SOR olay numarası seçilmemiş veya olay mesafesi okunamıyor; olay listesini kontrol edin.
`olcum`	404	`olcum`	Ölçüm veya bağlı devre bulunamadı; ölçüm hedefini yeniden okuyun.
`optik`	409	—	İşlem optik kayıtların bütünlük koşulunu bozuyor; hesap ve profil başvurularını inceleyin.
`optik_secim`	409	—	Projede zaten bir optik profil seçimi var; yeni kayıt açmadan mevcut seçimi okuyup düzenleyin.
`paket`	400	`paket`	Proje paketi yapısı uygun değil; dosyayı ve hedef boş proje koşulunu kontrol edin.
`paket_acik`	409	—	Cihazda proje için açık saha paketi var; mevcut paketin durumunu kontrol edin.
`paket_buyuk`	413	`bbox`	Saha alanındaki kayıt sayısı kabul edilmiyor; çalışma alanını küçültün.
`paket_durum`	409	—	Paket durumunda bu işlem yapılamıyor; kapatma ve inceleme sırasını kontrol edin.
`paket_sayi`	400	İlgili alan	Proje paketindeki sayısal değer okunamıyor; kaynak kaydı düzeltin.
`paket_sinir`	400	—	Etkin saha paketi sayısı kurulum sınırına ulaştı; mevcut paketleri inceleyin.
`paket_sure`	409	`sure`	Proje paketi işlemi süre bütçesinde tamamlanamadı; kapsamı daraltın.
`para`	400	`para`	Para birimi kodu uygun değil; geçerli üç harfli kodu gönderin.
`pay_dugum`	400	`paylar`	Konumlu payın düğüm listesi geçersiz veya tekrarlı; bağlı düğümleri düzeltin.
`pay_toplami`	409	`paylar`	Konumlu pay toplamı kablonun toplam payıyla uyuşmuyor; değerleri birlikte düzeltin.
`politika`	409	—	İşlem proje politikasında reddediliyor; ihlal raporunu inceleyin.
`politika_bayt`	409	—	Politika kaydının boyu kabul edilmiyor; taban ve istisnaları gözden geçirin.
`politika_bicim`	409	—	Paketin fiber politikası okunamıyor; kaynak politika kaydını düzeltin.
`politika_sinir`	409	—	Politika taban veya istisna kapsamı kabul edilmiyor; ihlalleri ve istisnaları azaltın.
`proje_buyuk`	409, 413	—	Tasarım veya saha için proje kapsamı kabul edilmiyor; kapsamı küçültün.

Kod dizini: R–T

Kod	HTTP	Alan	Anlamı ve istemci adımı
`ref`	400	`kopya`, İlgili alan	Optik profil başvurusu yok veya türü uygun değil; mevcut profil kimliğini kullanın.
`referans`	400	`referans`	Optik ölçümün referans yöntemi uygun değil; ilgili türün izinli yöntemini seçin.
`rezerv`	409	—	Kabloların lif rezervleri uyuşmuyor; kayıtları inceleyip rezerv kararını düzeltin.
`risk_bicim`	400	`d`	Ortak risk sorgusunun devre seçimi uygun değil; kimlik listesini düzeltin.
`rol_tavan`	400	`rol`	Proje rolü kurum rolünün izin verdiğini aşıyor; uygun üyelik rolü seçin.
`saat_araligi`	400	`sistem_saati_araligi`	Sistem saati düzeltme dosyasının aralığında değil; saat ve dosyayı kontrol edin.
`sablon`	409	—	Birleştirilecek kabloların tahsis şablonları uyuşmuyor; lif tahsislerini inceleyin.
`saha_yetki`	403	—	Saha paketi işlemine yetki yok; paket sahibi ve yönetici kapsamını kontrol edin.
`sayfa`	400	`limit`	Sayfalama boyu uygun değil; ilgili ucun sayfa alanını düzeltin.
`sayi`	400	`quality.accuracy_m`, İlgili alan	Sayısal alan türü uygun değil; metin veya mantıksal değer yerine sayı gönderin.
`secili_capa`	400	`yol_sec`, `yollar`	Devre çapası değişirken birincil yol yeniden seçilmeli; çapa ve yol seçimini birlikte değerlendirin.
`secili_yenile`	400	`yol`	Seçili yol bu yenileme akışıyla değiştirilemez; yeniden yönlendirme akışını kullanın.
`sinif`	409	—	Birleştirilecek liflerin sınıf istisnaları uyuşmuyor; sınıf kararını düzeltin.
`sonlu`	400	İlgili alan	Sayısal değer sonlu değil veya okunamıyor; ilgili sayıyı düzeltin.
`sonlu_degil`	409	İlgili alan	İşlem sonucu okunabilir sonlu sayı üretmiyor; hesap girdilerini kontrol edin.
`sor`	400	`sor`	SOR özet alanını sunucu oluşturur; istemciden değiştirmeyin.
`sor_yok`	400	`olcum`, `sor`	Ayrıştırılmış SOR özeti yok; dosya ile ayrıştırma durumunu ayrı kontrol edin.
`sure`	409	`sure`	Kaynak farkı işlemi süre bütçesinde tamamlanmadı; kapsamı daraltın.
`tarih`	400	İlgili alan	Ölçüm tarihi biçimi geçersiz; tarih alanını düzeltin.
`tasarim_acik`	409	—	Etkin tasarım varken ana projede bu arşivleme veya silme yapılamaz; tasarım durumunu değerlendirin.
`tasarim_ayar`	400	`settings.tasarim`	Tasarım onay ayarı geçersiz; tanımlı ayar alanını kullanın.
`tasarim_dal`	400	—	Tasarımda bu proje ayarı değiştirilemez; ana projedeki yönetim akışını kullanın.
`tasarim_gecersiz`	400	`tasarim_id`	İş paketine bağlanacak kaynak tasarım geçersiz; tasarım kimliğini kontrol edin.
`tasarim_sinir`	400	—	Etkin tasarım sayısı kabul edilmiyor; mevcut tasarımları inceleyin.
`tasarim_yetki`	403	—	Tasarım veya iş paketi işlemine yetki yok; proje yönetim rolünü kontrol edin.
`tasarim_yetkisi`	403	`settings.tasarim`	Tasarım onay ayarını değiştirme yetkisi yok; kurum yöneticisine başvurun.
`tek_tarafli`	409	İlgili alan	Birleştirilecek kablolarda aynı boy alanı birlikte bulunmuyor; değerleri tutarlı hale getirin.
`toplam`	409	İlgili alan	Birleşik kablonun toplam değeri okunamıyor; kaynak kablo değerlerini düzeltin.
`toplu_sinir`	400	`devreler`	Toplu devre seçimi kabul edilmiyor; devre kapsamını küçültün.
`tur`	400	`tur`, `type`, İlgili alan	Optik kayıt veya profil türü uygun değil; beklenen türü seçin.

Kod dizini: U–Z

Kod	HTTP	Alan	Anlamı ve istemci adımı
`ucuca_yok`	400	`deger`	SOR dosyasında uçtan uca kayıp yok; olmayan ölçüm değerini uygulamayın.
`uyelik_gereksiz`	400	`user_id`	Kurum yöneticisi için ayrıca proje üyeliği oluşturulmaz; rolü kontrol edin.
`uyelik_yok`	404	`user_id`	Üyelik kaydı bulunamadı; güncel proje üyelerini okuyun.
`uyumsuz`	409	İlgili alan	Kablo birleştirme lif tahsisini değiştiriyor; uyuşmayan öznitelikleri düzeltin.
`x_baglanti`	409	—	Birleştirme düğümündeki bağlantılar beklenen eşleşmeyle uyumlu değil; ek şemasını inceleyin.
`yedek_sinir`	400	`sira`, `yollar`	Yedek yol sayısı veya sırası uygun değil; yedek yol listesini düzeltin.
`yedek_var`	400	`yol_secim`	Seçim değişmeden önce mevcut yedek yollar değerlendirilmeli; bağımlı yolları kontrol edin.
`yeterlilik`	400	İlgili alan	Optik profil değerleri alıcı koşuluyla uyuşmuyor; verici, alıcı ve kayıp aralığını birlikte düzeltin.
`yok`	404	İlgili alan	Kablo veya cihaz bulunamadı; ilgili proje kimliğini kontrol edin.
`yol_bicim`	400	`ad`, `kisit`, `sira`, `yol_ara`, `yol_sec`, `yol_secim`, `yollar`	Birincil veya yedek yol seçiminin biçimi geçersiz; yol alanlarını düzeltin.
`yol_gecersiz`	409	—	Seçili yol kayıtlı topolojide yürünemiyor; bağlantı zincirini düzeltin.
`yol_islem`	400	`entity`, `yol`, `yol_sec`	Aynı istekte uyumsuz yol işlemleri var; tek bir yol seçimi niyeti gönderin.
`yol_uzun`	409	—	Devre yolunun eleman kapsamı kabul edilmiyor; teknik yol tasarımını inceleyin.
`yon`	400	`yon`	Ölçüm yönü değeri uygun değil; ilgili ölçüm türünün yön seçimini kullanın.
`zincir`	409	—	Kablolar aynı yönde uç uca bağlı değil; uç ve çizim yönlerini kontrol edin.

HTTP hatasından ayrı sonuç ve uyarı kodları

Aşağıdaki değerler hata HTTP durumunun yerine geçmez. Başarılı bir yanıtın içindeki ayrıştırma durumu, hesap sonucu veya uyarı listesinde bulunabilir. Üst yanıtın HTTP durumunu ayrıca okuyun; bu satırlar için sabit bir HTTP hata durumu tanımlanmaz.

Kod	Bulunduğu alan	Anlamı ve istemci adımı
`kapali`	`sor_durum.kod`	SOR ayrıştırma bu kurulumda kapalı; dosyanın kaydedilmesini ayrıştırma başarısı saymayın.
`sor_bicim`	`sor_durum.kod`	SOR başlığı, blok yapısı veya sayısal alan okunamadı; kaynak dosyayı yeniden doğrulayın.
`sor_blok_eksik`	`sor_durum.kod`	Ayrıştırma için gereken blok yok; ölçüm cihazından tam dosyayı alın.
`sor_ior`	`sor_durum.kod`	Grup kırılma indisi uygun değil; ölçüm dosyasındaki indisi kontrol edin.
`sor_sinir`	`sor_durum.kod`	Dosya veya ayrıştırılan içerik kabul edilen kapsamı aşıyor; uygun ölçüm dosyasını hazırlayın.
`sor_sure`	`sor_durum.kod`	Ayrıştırma süre içinde tamamlanmadı; dosyayı ve ayrıştırma durumunu inceleyin.
`sor_surum`	`sor_durum.kod`	SOR sürümü desteklenmiyor; desteklenen ölçüm dosyası biçimini kullanın.
`okunamaz`	Optik hesap sonucu `kod`	Hesap, lif kaybı veya ölçüm değeri değerlendirilemiyor; sonuç nedenini ve kaynak değerleri düzeltin.
`sonlu_degil`	Optik hesap sonucu `kod`, `alan`	Hesap sonucu sonlu sayıyla gösterilemiyor; ilgili girdileri inceleyin. HTTP retlerinde aynı kod yukarıdaki anlamıyla da kullanılabilir.
`segment_okunamadi`	Güzergâh `uyarilar[].kod`	Segmentin uç veya boy bilgisi okunamıyor; segment verisini düzeltin.
`turetilmis_boy`	Güzergâh `uyarilar[].kod`	Segment boyu bölme işleminden türetilmiş; bunu bağımsız saha ölçümü olarak değerlendirmeyin.
`zemin_yok`	Segment `uyarilar[].kod`	Zemin tanımı bulunamadı; karar için gereken zemin bilgisini tamamlayın.
`buyuk_sayi`	Çıktı `uyarilar[].kod`, `alan`	Çıktıda büyük sayı metin olarak korunuyor; hücreyi otomatik sayıya dönüştürmeden değerlendirin.
`raf`	Çıktı `uyarilar[].kod`, `alan`	Raf yerleşiminde çakışma veya yükseklik aşımı var; ilgili kabin kaydını inceleyin.

WMS XML hata kodları

WMS parametre hataları JSON kod alanı yerine XML içindeki ServiceException öğesinin code özniteliğini kullanır. Kimlik ve ortak erişim hataları için JSON zarfı geçerlidir.

XML kodu	HTTP	Alan	İstemci adımı
`InvalidParameterValue`	400	İstekteki ilgili WMS parametresi	Parametre adını, biçimini, koordinatları ve ilan edilen değerleri kontrol edin.
`LayerNotDefined`	400	`LAYERS`	Katman adını ve anahtarın proje kapsamını kontrol edin; güncel yetenek ilanını okuyun.

Doğrulama, ağ hatası ve yeniden deneme

İstek gövdesi, yol veya sorgu modeli uyuşmazsa 422 yanıtındaki detail dizisini okuyun. Dizide loc, msg ve type gibi alanlar bulunur. 400 ve 422 aynı gövdeyi tekrar göndermekle düzelmez. 401 ve 403 için kimlik/yetkiyi; 404 için kapsamı inceleyin. Bilmediğiniz bir kodda da HTTP hatasını başarı kabul etmeyin.

429 yanıtında oran eşiğini tahmin etmeyin; Retry-After bekleme süresini okuyun. Bu belge sayısal istek eşiği belirtmez. 503 yanıtını başarılı yazma saymayın; varsa yeniden deneme başlığını ve ortamın durumunu değerlendirin.

Ağ kesintisinde hiç HTTP yanıtı alınmaması, yazmanın yapılmadığını kanıtlamaz. Genel düzenlemede aynı request_id ve aynı ops ile sonuç doğrulaması yapın. Yeni bir işlem kimliğiyle kör tekrar aynı kaydı ikinci kez oluşturabilir. Bu tekrar kuralı bütün dosya yükleme ve özel POST uçlarına uygulanmaz.

Bu sözlük ortak entegrasyon retlerini ve belgelenen iş akışlarının kaynakta tanımlı karar kodlarını kapsar. Metni veya kodu çalışma sırasında üretilen genel istisnalar özel bir sabit kod eklemez; v1 bunları hata zarfıyla döndürür. Kurulum sürümü değiştiğinde yanıtın gerçek HTTP durumunu esas almaya devam edin. Sözleşme kuralları, Eşzamanlılık ve API referansı ile birlikte kullanın.