IndexNow API sorğu arayüzü

API qəsdən kiçikdir: bir nöqtə, iki metod.

Bir URL — GET

GET https://yandex.com/indexnow?url=<String>&key=<String>[&keyLocation=<String>]

url və key tələb olunur; keyLocation yalnız açar faylı kök qovluqda olmadıqda. URL RFC 3986 standartına uyğun olmalıdır.

Çoxlu URL — POST

POST https://yandex.com/indexnow
Content-Type: application/json; charset=utf-8

{ "host": "www.example.com",
  "key": "…",
  "keyLocation": "https://www.example.com/key.txt",
  "urlList": [ "https://www.example.com/url1", … ] }

Sorğu üçün 10.000-ə qədər URL. host, key və urlList tələb olunur.

İşlənməyə dəyər cavab kodları

• 200 OK — qəbul edildi.
• 202 Accepted — yeni açar təsdiqlənməsini gözləyir. Xəta deyil, göndərməyə davam edin.
• 400 — gövdədə səhv parametrlər.
• 403 Yanlış açar — açar yüklənə bilmədi və ya göndərilən URL-lərə uyğun gəlmir. Kataloq səviyyəsindəki açarda bu adətən səhv açardan çox səlahiyyət pozuntusudur.
• 405 — yalnız GET və POST dəstəklənir.
• 422 — böyük ailə: yanlış açar yeri, yanlış URL, çox qısa və ya çox uzun açar, yanlış simvollar, çatışmayan açar, host və ya URL, 10.000-dən çox URL, urlList massiv deyil və ya boşdur.
• 429 Çoxlu sorğu — IP üzrə limit aşılıb.

Sürət məhdudiyyəti

Yandex bildirir ki, sorğu sayına heç bir limit yoxdur və onun alqoritmləri həddindən artıq göndərmənin qarşısını alır — eyni zamanda sənədləşdirərək 429. Birlikdə nəzərə alsaq: dəyişikliklər olduqca göndərin, bacardıqca paketləyin və 429-u xəta kimi deyil, gözləmə ilə yenidən cəhd tələb edən əks təzyiq kimi qəbul edin.

Tətbiqetmə qeydləri

Yeni açarın pozulmuş açar kimi səhv başa düşülməməsi üçün jurnallarda 202-ni 200-dən ayırın; 422-ni yenidən cəhd tələb edən deyil, düzəliş tələb edən daimi nasazlıq kimi qəbul edin; və hər səhifə üçün GET göndərmək əvəzinə (bu, məşğul nəşriyyat sistemində adətən 429-u işə salır), dəyişiklikləri tək bir POST-da paketləyin.