İçeriğe geç
TR
API anahtarı al
Belgeleri incele

API başvurusu

Hatalar ve durum kodları

Başarısız bir talebin nedenini bulun ve onu düzeltmeye karar verin, bekleyin veya yeniden deneme.

Bu sayfada

HTTP statüsü kodları

HTTP statüsü ile başlayın, sonra belirli sebep için hata kodu ve mesajı okuyun.

Durum durumuAnlam AnlamıYapılacak işlem
400Invalid isteğiKaynağı düzeltin, gerekli alanları, parametre türleri veya yanıt başlıkları yeniden denemeden önce.
401Kimlik doğrulama başarısız olduX-API-Key'u kontrol edin. Geç bir anahtar değiştirmek veya geri çekilmek; aynı anahtarı tekrarlamak yardımcı olmayacaktır.
402Yetersiz kredilerdeHesap bakiyesini kontrol edin. Kredi ekleyin veya hesap sahibinin tekrar göndermeden önce erişimi çözmesine izin verin.
403Erişim inkarı reddedildiAnahtarın kaynak izinlerini ve hesabı veya abonelik durumunu kontrol edin.
404bulunamadıURL, iş ID ve hesabı kontrol edin. İzin verilen hesabınızın veya kaynaklarının dışındaki işler de 404'yu geri döndürebilir.
406Yanıt türü kabul edilemezAccept: application/json veya text/plain. Markdown ile X-Respond-With: işaret.
409Hazır değil / çatışmaSonuç olarak, mevcut işi tam olana kadar anket yapın. Diğer uç noktaları için, vücutta açıklanan çatışmayı çöz.
410Sonuç süresi sona ermiştiKurtarılan bir kopyasını kullanın. Sonuç URL, sona ermiş bir sonucu geri getiremez.
422Invalid girişi / başarısız işRaporlanan alanları düzeltin. Sonuç olarak, job.error: başarısız bir iş getirmenin başarılı bir sonucu yoktur.
429Limit ulaştıRetry-After veya retry_after için bekleyin. Talep oranını azaltır; tam bir bekleme süresi için, mevcut işleri finish'ya bekleyin.
500 / 502 / 503 / 504Hizmet veya upstream başarısızlık başarısızlıkRetry, sınırlanmış gerile okur. Bir POST veya teslim süresi için, tekrar göndermeden önce iş kabul edilip kabul edilip alın.

Bir hata yanıtını okuyun

API hataları JSON'u standart metin talep ettiğinizde kullanır. Vücut uç nokta ile farklıdır. HTTP statüsü ve kodu mevcut olduğunda; sorunu açıklamak için mesaj veya detay kullanın.

Sorgu hataları genellikle hata ve mesaj içerir; kod isteğe bağlıdır. Kimlik hataları success: false yerine error: true kullanabilir.

400 · application/json
{
  "error": true,
  "code": "unsupported_representation",
  "message": "X-Respond-With supports markdown. Omit the header for the original result fields."
}

Inspect durumu, Başlıklar ve Vücut

curl --include'u tüm üçünü görmek için kullanın. Bu örnek, anahtarınızı ücretsiz bir hesap okuma ile kontrol eder; bir sorgu göndermez. FLASHDATA_API_KEY'u ilk önce çevrenizde ayarlayın.

Bir yanıt · cURL / Bash
curl --include --silent --show-error --max-time 20 \
  'https://api.flashdata.dev/v2/api-access/identity' \
  --header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY}" \
  --header 'Accept: application/json'

Yeniden deneme ne zaman

Tekrarlanan POST başka bir ücretli sorgu oluşturabilir. Ağ zaman aşımı ilk isteğin reddedildiğini kanıtlamaz. İş ID değerini alır almaz kaydedin.

Durum durumuSonraki eylem
Invalid girişi, anahtar, izin veya dengeDur. İstek veya hesap durumunu yeniden denemeden önce düzeltin; bu hatalarda döngüsüz.
429 bir bekleme ipucu ileHonor Retry-After (saniyeler veya HTTP tarihi), veya JSON retry_after değeri saniyede. Her ikisi de mevcutsa, daha uzun gecikme kullanın.
Talep: 429 / geçici 5xx / ağ hatasıAynı GET’yu yeniden deneyin. Beklenmeyen bir ipucu olmadan, jitter ile artan gecikmeleri kullanın, maksimum bir deneme hesabı ve zaman sınırı.
POST zamanout veya belirsiz 5xxMevcut iş ID'u tut ve statüsünü kontrol edin. Eğer ID alınsaydı, tekrar göndermeye karar vermeden önce iş tarihini kontrol edin.

Bir arka plan işi kontrol edin

HTTP 200 statü uç noktasından okuma başarılı olduğu anlamına gelir. Görevin başarılı olup olmadığını bilmek için job.status'u kontrol edin. JOB_ID'u mevcut işinize ayarlayın; bu komut bir yedek göndermez.

job.statusYapılacak işlem
pending / processingBekle, sonra aynı işi anket yapın. Sonuç olarak, 409'u tamamlanmaya kadar döndürür.
completedErişim ve sonucu kurtarmak. Orijinal JSON sonuçları bir 302 depolama yönlendirmesini döndürür; formatlı sonuçlar doğrudan bir vücut döndürür.
failedjob.error'u ankete bırakın. Sonuç uç noktası 422'u başarısız bir iş için kod result_not_ready ile döndürür.
İş durumunu okuyun · cURL / Bash
curl --fail-with-body --silent --show-error --max-time 30 \
  "https://api.flashdata.dev/v2/jobs/${JOB_ID:?Set JOB_ID}" \
  --header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY}" \
  --header 'Accept: application/json'

Yanıt-format hataları

Durum / kodFix Fix
400 · unsupported_representationX-Respond-With'u işaret etmek veya başlığı kaldırmak için ayarlayın.
406 · not_acceptableAccept'u application/json veya text/plain'ye ayarlayın; bir karset belirtse UTF-8'u kullanın.

Bir istekle yardım alın

Son noktayı gönderin, UTC timestamp, HTTP statüsü, hata kodu ve talep veya iş ID. API anahtarlarını, jetonları ve rapordan URLs'u imzaladı.