Kaynak API'si 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.

alanlar ve alan_kodlari hangi alanın neden reddedildiğini söyler (ör. metin_gerekli, ek_gerekli, ek_turu_uyusmuyor, ilce_ile_uyusmuyor, kategori_gecersiz, dis_kimlik_bicimi, ozet_bicimi).

ozet_uyusmuyor

400 · Dosyanın özeti gönderide bildirilenle aynı değil.

Tamamlamadaki ozet (bütün dosyanın SHA-256'sı) gönderide bildirilen ekin özetiyle aynı olmalı.

anahtar_gecersiz

401 · API anahtarı geçersiz.

Anahtar biçimi bozuk, böyle bir anahtar yok ya da kaynak hesabı kapatılmış. 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.

anahtar_iptal

401 · Bu API anahtarı iptal edildi.

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

anahtar_ortami_uyusmuyor

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

Canlı anahtar deneme adresinde, 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.

Son kullanma tarihi geçti; yeni anahtar üretin.

ag_disi

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

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

gonderim_aboneligi_yok

403 · Kurumun yürürlükte bir gönderim aboneliği yok.

Ücretli kurumun gönderim aboneliği askıda, sona ermiş ya da hiç açılmamış.

kapsam_disi

403 · Bu anahtar bu uç için kullanılamaz.

Abone anahtarı Kaynak API'sinde, kaynak anahtarı abone API'sinde kullanılamaz; ya da anahtarın kapsamı (icerik.gonder, gonderi.durum) bu ucu açmıyor (kapsam).

kaynak_askida

403 · Kaynak hesabı askıda; gönderi yapılamaz.

Askı kalkınca anahtar kendiliğinden çalışır. Neden ajans tarafından bildirilir.

kaynak_kapali

403 · Kaynak hesabı kapatılmış.

Kapatılmış kaynak gönderi yapamaz.

sozlesme_yururlukte_degil

403 · Sözleşmeniz yürürlükte değil; gönderi yapamazsınız.

Serbest muhabir sözleşmesi YHA Gönderim'de imzalanınca gönderebilirsiniz.

bulunamadi

404 · İstenen kayıt bulunamadı.

Gönderi ya da ek yok ya da sizin değil.

dis_kimlik_cakisiyor

409 · Bu dış kimlikle başka içerikte bir gönderi var.

Aynı dis_kimlik başka bir gövdeyle yeniden geldi; gonderi_id var olan gönderiyi söyler. Aynı gövdeyle yinelenen istek 200 ve X-YHA-Tekrar: evet döner.

gecersiz_durum

409 · Kaydın durumu bu işleme izin vermiyor.

Örneğin artık dosya almayan gönderiye parça yüklemesi.

geri_cekilemez

409 · Gönderi incelemeye alınmış ya da karar verilmiş; geri çekilemez.

Yalnızca alındı (incelemeye alınmamış) ve yükleniyor durumundaki gönderi geri çekilir.

gonderim_siniri_doldu

409 · Kurumunuzun bu dönemki gönderim hakkı doldu.

sinir, kullanilan, donem_bitisi dönemi söyler; ek hak için ajansla görüşün.

govde_cok_buyuk

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

JSON gövdesi en çok 256 KB, parça en çok 8 MB; ek türüne göre dosya sınırı en_cok_mb.

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.