Hatalar

Bütün hatalar aynı biçimdedir: { "hata": { "kod", "mesaj", "belge", … } }. mesaj Türkçedir ve değişebilir; yazılımınız kod'a bakmalıdır. belge o kodun bu sayfadaki adresidir. Her yanıtta X-YHA-Istek başlığı vardır; destek isterken bu değeri verin.

dogrulama_hatasi

400 · Gönderilen bilgilerde hata var.

Parametre ya da gövde geçersiz; alanlar ve alan_kodlari hangi alanın neden reddedildiğini söyler (ör. imlec_gecersiz).

anahtar_gecersiz

401 · API anahtarı geçersiz.

Anahtar biçimi bozuk ya da böyle bir anahtar yok. Aynı adresten çok sayıda geçersiz anahtar 429 ve geçici yasakla sonuçlanır.

anahtar_gerekli

401 · Bu uç API anahtarı ister.

Authorization: Bearer yha_canli_… başlığı yok ya da oturum jetonu gönderildi.

anahtar_iptal

401 · Bu API anahtarı iptal edildi.

İptal hemen geçerlidir ve geri alınamaz; YHA Abone'den yeni anahtar üretin.

anahtar_ortami_uyusmuyor

401 · Anahtarın ortamı bu adresle uyuşmuyor.

Canlı anahtar deneme ortamında, deneme anahtarı canlıda çalışmaz; dogru_adres doğru kökü söyler.

anahtar_suresi_doldu

401 · Bu API anahtarının süresi doldu.

Döndürmede geçiş süresi bitti ya da son kullanma tarihi geçti; yeni anahtarı kullanın.

abonelik_askida

403 · Kurumun aboneliği askıda.

Askı kalkınca anahtarlar kendiliğinden çalışır.

abonelik_yok

403 · Kurumun sürmekte olan bir aboneliği yok.

Abonelik sona erdi ya da hiç açılmadı.

ag_disi

403 · İstek bu anahtarın izinli ağ adreslerinden gelmiyor.

Anahtarın IP listesi doluysa istek yalnızca bu bloklardan kabul edilir.

arsiv_derinligi_disi

403 · Bu içerik paketinin arşiv derinliğinin dışında.

en_eski paketinizin izin verdiği en eski anı söyler.

deneme_kisiti

403 · Bu işlem deneme hesabında kapalı.

Deneme aboneliğinde dış çıkışlar kapalıysa canlı anahtar içerik alamaz; geliştirme için deneme ortamını kullanın.

gelistirici_yalnizca_deneme

403 · Geliştirici anahtarı yalnızca deneme ortamında çalışır.

Haber yazılımı firmasına gönderilen anahtar (yha_deneme_…, geliştirici) canlı adreste kullanıldı. https://deneme.<alan>/v1 kökünü kullanın.

kanal_paketinde_yok

403 · Paketinizde bu kanal açık değil.

Kurumun geçerli paketlerinin hiçbirinde bu çıkış türü (kanal) izinli değil.

kapsam_yok

403 · Bu anahtarın bu uç için kapsamı yok.

kapsam gereken kapsamı söyler (ör. icerik.indir).

paket_disi

403 · Bu içerik paketinde yok.

İçerik paketinizin dışında; gövde kapsam_farki taşır, başlığı taşımaz.

bulunamadi

404 · İstenen kayıt bulunamadı.

Kimlik ya da numara yok.

eklenti_yok

404 · Bu eklentinin yayımlanmış sürümü yok.

Güncelleme ucunda bilinmeyen eklenti kodu ya da seçilen kanalda yayımlanmış sürüm yok.

kabul_edilemez

406 · Accept: text/event-stream gerekli.

/v1/olaylar yalnızca sunucu gönderimli olay akışı verir.

adim_hazir_degil

409 · Bu adım henüz yayılmadı.

Sınamanın bu adımının içeriği henüz yayılmadı; önceki adımı tamamlayın ya da …/ilerle çağırın.

entegrasyon_kaldirildi

409 · Bu entegrasyon kaldırıldı.

Anahtarın bağlı olduğu entegrasyon YHA Abone'den kaldırılmış. Bağlantıyı yeniden kurmak için yeni bir entegrasyon açın.

entegrasyon_uyusmuyor

409 · Bildirimdeki entegrasyon bu anahtarın entegrasyonu değil.

PUT /v1/entegrasyon gövdesindeki entegrasyon_id anahtarın bağlı olduğu entegrasyonu göstermiyor. Kimliği gövdeden çıkarın ya da kurulum kodundaki kimliği kullanın.

icerik_iptal

409 · Bu içerik iptal edildi ya da servisten geri çekildi.

İptal edilen içeriğin dosyası verilmez; yayından kaldırın.

kapsam_disi

409 · Bu iş bu sürümde açık değil.

Örneğin cikis.yonet kapsamı ya da uyumluluk biçimleri.

kota_doldu

409 · Bu ayki indirme kotası doldu.

Aylık indirme kotası (fotoğraf ve video) doldu.

kuresel_degil

409 · Bu içerik 360° değil.

Görüntüleyici yanıtı (/v1/varliklar/:id/goruntuleyici) yalnızca 360° fotoğraf ve videoda verilir (Faz 20).

sinama_bitti

409 · Sınama bitti.

Bitmiş ya da süresi dolmuş sınamaya rapor, onay ya da ilerleme gönderilemez.

sinama_suruyor

409 · Bu anahtarın süren bir uyumluluk sınaması var.

Anahtar başına aynı anda bir sınama yürür; sinama_id süren sınamayı gösterir. Bitirin ya da süresinin dolmasını bekleyin.

govde_cok_buyuk

413 · İstek gövdesi çok büyük.

Dış yazma uçlarında gövde en çok 32 KB olabilir.

es_zamanli_baglanti_siniri

429 · Aynı anda açık akış bağlantısı sınırı dolu.

Anahtar başına açık anlık akış ve MCP bağlantısı sınırlıdır.

gunluk_sinir_doldu

429 · Bugünkü API sınırı doldu.

sifirlanma_zamani Türkiye saatiyle gece yarısıdır.

yavasla

429 · Çok fazla istek. Biraz bekleyip yeniden deneyin.

Retry-After ve tekrar_deneme_saniye kadar bekleyin; sinir hangi sınır olduğunu söyler.

sunucu_hatasi

500 · Sunucuda beklenmeyen bir hata oluştu.

Kısa süre sonra yeniden deneyin; sürerse X-YHA-Istek değeriyle bildirin.