IndexNow API istek referansı
API’yi kullanarak IndexNow protokolü üzerinden bir veya birden fazla site sayfası URL’sini Yandex’e gönderebilirsiniz.
Bir sayfa gönderme
GET https://yandex.com/indexnow
? url=<String>
& key=<String>
& [keyLocation=<String>]
|
Parametre |
Tip |
Gerekli |
Açıklama |
|
|
Dize |
Evet |
Verileri göndermek istediğiniz sayfanın URL’si. RFC3986 standardına uygun olmalıdır. |
|
|
Dize |
Evet |
Site yönetim haklarını doğrulayan anahtar. Bir istek gönderdiğiniz zaman, arama motoru bu değeri dosya içeriğiyle eşleştirir. |
|
|
Dize |
Hayır |
Eğer site kök dizininde yer almıyorsa, anahtarı içeren dosyanın yolu. |
HTTP kodu 200 OK
content-type: application/json
Diğer yanıt kodları:
|
Kod |
Sebep |
Açıklama |
|
202 |
Kabul edildi |
Yeni bir anahtar doğrulama bekliyor. Anahtarın doğru olduğundan eminseniz, biraz bekleyin ve ardından birkaç başka adres gönderin. Kod 200 OK olarak değişirse, bu anahtarın doğrulandığı ve adreslerin gönderildiği anlamına gelir. Hala 202 kodunu görüyorsanız, anahtar henüz doğrulama sonrası veri tabanına eklenmemiştir. Bu durumda daha uzun süre beklemek gerekir. |
|
403 |
Geçersiz anahtar |
Anahtar yüklenemedi veya istekte belirtilen URL’lerle eşleşmiyor. |
|
405 |
Yönteme izin verilmiyor |
GET ve POST yöntemleri desteklenmektedir. |
|
422 |
Geçersiz anahtar konumu |
|
|
422 |
Geçersiz url |
İstek geçersiz bir URL içeriyor veya gönderilen anahtar bunu işlemek için uygun değil. |
|
422 |
Anahtar en az 8 karakter olmalıdır |
Anahtar 8 karakterden az içeriyor. |
|
422 |
Anahtar 128 karakterden uzun olmamalıdır |
Anahtar 128 karakterden fazla içeriyor. |
|
422 |
Anahtar a-Z 0-9 veya “-” içermelidir |
Anahtar geçersiz karakterler içeriyor. |
|
422 |
Anahtar sağlanmamış |
|
|
422 |
URL sağlanmamış |
İstekte |
|
429 |
Çok Fazla İstek Var |
Bir IP adresi için istek sayısı aşılmış. |
Birden fazla sayfa gönderme
POST https://yandex.com/indexnow
Birden fazla sayfa hakkında bilgi göndermek için JSON biçimini kullanın:
POST /indexnow HTTP/1.1
Content-Type: application/json; charset=utf-8
Content-Length: 286
Host: yandex.com{
"host": "www.example.com",
"key": "EdD8dkmdNLlxREi2LkhJjYOH2kyQbJqM3cBKT5fX",
"keyLocation": "https://www.example.com/myIndexNowKey63638.html",
"urlList": [
"https://www.example.com/url1",
"https://www.example.com/folder/url2",
"https://www.example.com/url3"
]
}
|
Parametre |
Tip |
Gerekli |
Açıklama |
|
|
Dize |
Evet |
Sitenizin URL’si. |
|
|
Dize |
Evet |
|
|
|
Dize |
Hayır |
Anahtar sitenin kök dizininde değilse, anahtarın yolunu belirtin. |
|
|
Dizi |
Evet |
Veri göndermek istediğiniz sayfaların URL’lerini (String) içerir. Bir istekte en fazla 10.000 URL gönderebilirsiniz. |
HTTP kodu 200 OK
content-type: application/json
Diğer yanıt kodları:
|
Kod |
Sebep |
Açıklama |
|
202 |
Kabul edildi |
Yeni bir anahtar doğrulama bekliyor. Anahtarın doğru olduğundan eminseniz, biraz bekleyin ve ardından birkaç başka adres gönderin. Kod 200 OK olarak değişirse, bu anahtarın doğrulandığı ve adreslerin gönderildiği anlamına gelir. Hala 202 kodunu görüyorsanız, anahtar henüz doğrulama sonrası veri tabanına eklenmemiştir. Bu durumda daha uzun süre beklemek gerekir. |
|
400 |
Geçersiz parametreler |
İstek gövdesinde gönderilen parametreler geçersiz. |
|
403 |
Geçersiz anahtar |
Anahtar yüklenemedi veya istekte belirtilen URL’lerle eşleşmiyor. |
|
405 |
Yönteme izin verilmiyor |
GET ve POST yöntemleri desteklenmektedir. |
|
422 |
Geçersiz anahtar konumu |
|
|
422 |
Geçersiz url |
İstek geçersiz bir URL içeriyor veya gönderilen anahtar bunu işlemek için uygun değil. |
|
422 |
Anahtar en az 8 karakter olmalıdır |
Anahtar 8 karakterden az içeriyor. |
|
422 |
Anahtar 128 karakterden uzun olmamalıdır |
Anahtar 128 karakterden fazla içeriyor. |
|
422 |
Anahtar a-Z 0-9 veya “-” içermelidir |
Anahtar geçersiz karakterler içeriyor. |
|
422 |
Sunucu sağlanmadı |
|
|
422 |
Anahtar sağlanmamış |
|
|
422 |
10.000’den fazla URL’ye izin verilmez |
|
|
422 |
URL sağlanmamış |
İstekte |
|
422 |
URL listesi bir dizi olmalıdır |
|
|
422 |
URL listesi boş olamaz |
Boş bir |
|
422 |
URL bir dizi serisi olmalıdır |
|
|
429 |
Çok Fazla İstek Var |
Bir IP adresi için istek sayısı aşılmış. |
Sorular ve cevaplar
Ne sıklıkla istek gönderebilirim?
İstek sayısında bir sınır yoktur. Sıklığını ayarlayabilirsiniz: Yandex, çok fazla istek gönderilmesini önleyen algoritmalar kullanır.
Aynı URL’yi günde birden fazla kez gönderebilir miyim?
Aynı URL’yi çok sık göndermemenizi öneririz. Gerekirse, 10 dakikalık aralıklarla gönderin.
Sayfa sık güncelleniyorsa, bunu Yandex’e bildirmek için başka yöntemler kullanın.
HTTP kodu 404 olan sayfaları API aracılığıyla gönderebilir miyim?
Evet, 404 veya 410 kodu olan sayfaları bildirmek için IndexNow’u kullanabilirsiniz.
HTTP kodu 301 veya 302 (yönlendirme) olan sayfaları gönderebilir miyim?
Evet, yönlendirmeler veya diğer değişiklikler hakkında bilgi içeren URL’leri gönderebilirsiniz.