Hatalar

Her hata aynı yapıdadır ve değişmeyen bir code değeri taşır. Mantığınızı bu koda göre kurun; mesaj metni insanlar için yazılmıştır ve ifadesi değişebilir.

{ "error": { "code": "invalid_key", "message": "That API key does not exist." } }

Bazı hatalar bu ikisinin yanında ek alanlar da taşır: hatalı parametre için parameter, ne kadar bekleneceği için retry_after, tükenen kota için limit ve used.

Tüm kodlar

Durum	Kod	Ne zaman
400	`missing_query`	`query` boş ya da hiç yok.
400	`unknown_format`	`format` altı biçimden biri değil.
400	`unknown_column`	`columns` var olmayan bir alan içeriyor.
400	`format_not_available`	Satır döndürülmeyen bir yerde düz biçim istendi.
400	`per_page_too_large`	`per_page`, planınızın satır sınırını aşıyor. Sınır, hata yanıtında belirtilir.
400	`invalid_json`	POST gövdesi geçerli bir JSON değil.
401	`missing_key`	`Authorization: Bearer` başlığı yok.
401	`invalid_key`	Anahtar hiçbir hesaba ait değil.
403	`plan_required`	Hesabın ücretli planı yok.
404	`unknown_endpoint`	Böyle bir yol yok. Bilinen yollar hata yanıtında listelenir.
405	`method_not_allowed`	API salt okunurdur. GET kullanın ya da JSON gövdesiyle POST gönderin.
429	`too_many_requests`	Dakikada ondan fazla istek geliyor (API ve MCP birlikte sayılır).
429	`quota_exceeded`	Günlük arama hakkı tükendi.
429	`snippet_quota_exceeded`	Günlük kod parçacığı hakkı tükendi. Parçacıksız arama yine çalışır.

Her biri için ne yapmalı

400 - isteğiniz hatalı ve tekrarlamak işe yaramaz. Hangi parametrenin hatalı olduğunu parameter alanı gösterir.
401, 403 - sorun anahtarınızda ya da planınızda. Bir şey değişmeden yeniden denemeye değmez.
429 too_many_requests - retry_after saniye bekleyin ve tekrarlayın. Kotadan hiçbir şey düşülmedi.
429 quota_exceeded - günlük hak bir sonraki UTC gece yarısında yenilenir; bunun ne kadar sonra olduğunu retry_after gösterir. Daha erken denemek işe yaramaz.
5xx - sorun bizde. Bekleme süresini giderek artırarak yeniden deneyin.

Hatalar ve biçimler

Hatalar JSON olarak döner; format=xml istendiyse XML olarak. Düz biçimlerde bir hatayı ifade edecek yapı yoktur; bu yüzden csv isteyen başarısız bir istek JSON alır. Yani CSV okuyan bir istemci, 200 yanıtına benzeyen her gövdenin satırlardan oluştuğunu varsaymamalı, durum kodunu kontrol etmelidir.

Kodları bu sayfayı okumadan öğrenmek

GET /, yukarıdaki tüm kodları anlamlarıyla birlikte JSON olarak listeler. Anahtar gerektirmez; böylece kimse tarayıcı açmadan, tüm kodları tanıyan bir istemci yazılabilir.

curl https://api.publicwww.com/

Sonraki Kümeler