Rehber n8n HTTP Request yalnız ilk sayfadaki kayıtları getiriyorsa ne yapılır?

Bir API yanıtı yalnız ilk kayıt grubunu veriyorsa n8n HTTP Request düğümünde sayfalama kurmanız gerekir. Sayfa boyutunu yükseltmek her kaydı alacağınızı garanti etmez; hizmetin üst sınırı olabilir. Önce API’nin sonraki sayfayı URL, sayfa numarası veya cursor ile nasıl belirttiğini öğrenin.

Yanıtın veri sözleşmesini inceleyin​

Varsayımsal bir API her yanıtta records dizisi ve next alanı döndürsün. next boş olduğunda işlem biter. Başka bir hizmet ise page parametresini artırmanızı bekleyebilir. Birindeki ayarı diğerine kopyalamak ya aynı sayfayı tekrar getirir ya da kayıt atlatır.

Sayfalamayı kontrollü ekleyin​

1. İlk yanıtı kaydedip yapısını okuyun. Kayıt dizisinin adını, sonraki sayfa bilgisini ve varsa toplam sayıyı bulun. Sayıların gerçekten toplam mı, yalnız mevcut sayfa mı olduğunu doğrulayın.
2. Pagination seçeneğini açın. HTTP Request içinde Add Option üzerinden Pagination alanını ekleyin. Kullanılan API’nin gerçek yöntemine uygun modu seçin.
3. Sonraki sayfa değerini eşleyin. Yanıt URL içeriyorsa Response Contains Next URL; numara istiyorsa her istekte parametre güncelleme yaklaşımını kullanın. Parametre adını sağlayıcının belgesinden alın.
4. Bitiş koşulunu tanımlayın. Boş next, boş kayıt dizisi veya belgenin belirttiği diğer koşulu kullanın. Sonsuz döngüyü önlemek için makul bir istek sınırı da koyun.
5. İki sayfalık örnekle doğrulayın. İlk ve son kayıt kimliklerini karşılaştırın. Aynı sayfanın tekrar eklenmediğini ve beklenen toplamın oluştuğunu kontrol edin.

Örnek ifadeyi doğru yerde kullanın​

API next alanında tam sonraki URL’yi döndürüyorsa ilgili alana aşağıdaki gibi bir ifade uygulanabilir. Alan adı gerçek yanıtınızla aynı olmalıdır.


Sayfa numarası birden başlıyorsa $pageCount + 1 yaklaşımı kullanılabilir; sıfırdan başlayan bir API’de aynı değer doğru olmayabilir. Çok sayfalı aktarımda hız sınırı veya zaman aşımı da görülebilir. Hız sınırında rastgele hızlı tekrar yerine hizmetin bekleme koşulunu izleyin ve kaldığınız yeri belirleyebilecek kayıt kimliklerini koruyun.

API yanıtında toplam kayıt sayısı bulunması, n8n’in bütün sayfaları aldığı anlamına gelmiyor. Örnek olarak ilk yanıtta 100 kayıt ve sonraki sayfa alanı varken beklenen toplam 250 olsun. Sayfalama ayarını yaptıktan sonra yalnız çıktı sayısını karşılaştırmak yerine hangi kayıt izleri takip edilmeli?

İlk ve son kayıt kimlikleriyle sayfa geçişi birlikte incelenebilir. Aynı sayfanın tekrar eklenmesi, sayıyı artırdığı halde aktarımı doğru yapmaz. API’nin gerçek sonraki sayfa alanı veya parametresi kullanılmalı; bitiş koşulu da belgesine dayanmalı. İki sayfalık küçük deneme, yanlış döngüyü büyük aktarım öncesinde görünür kılar.

Bitiş değerinin biçimini de kontrol etmek gerekir; boş alanla metin olarak yazılmış bir değeri aynı varsaymamak önemli. İstek sınırı koymak sonsuz döngüyü durdurabilir, fakat eksik veriyi tamamlamaz. Sonuçta beklenen toplamla birlikte benzersiz kayıtların gerçekten geldiği de doğrulanmalı.