API verilerini görsel olarak tasarlanmış bir sayfaya bağlayın
Pagiera'da canlı API verileri bir sayfaya nasıl bağlanır?
Tek bir nesne getirmek için Request bloğu veya bir dizi üzerinde yinelemek için Repeat bloğu ekleyin; ardından {{params.x}} ve {{query.x}} yer tutucularını kullanarak URL, üst bilgiler veya gövde içinde rota parametrelerine ve sorgu alanlarına başvurun. Yayımlanan sayfalarda her ikisi de HTML döndürülmeden önce sunucuda çözümlenir; böylece API destekli içerik sonradan doldurulmak yerine ilk yanıtta bulunur.
Önemli noktalar
- Request blokları döndürülen tek bir nesneyi alt öğelerine sunar; Repeat blokları bir dizi sonucu üzerinde yinelenir.
- {{params.slug}} ve {{query.q}} gibi yer tutucular URL'lerde, üst bilgilerde, sorgu alanlarında ve gövdelerde çalışır.
- Yayımlanan sayfalar her iki blok türünü sunucuda çözümler; bu nedenle veriler tarayıcı botlarının aldığı HTML'de bulunur.
- Kaynak page-404 davranışını kullandığında, üst API'den gelen bir 404 tüm rotayı 404'e dönüştürebilir.
Sayfaya dinamik bir slug verin
Bir sayfa slug'ı adlandırılmış parametreler taşıyabilir. Eşleşen değerler, sayfa işlenirken sunucu bağlamına aktarılır.
blog/:slug/blog/1 adresine yapılan bir istek için sunucuya aktarılan bağlam şöyle görünür:
{
params: { slug: "1" },
query: { preview: "true" }
}Veri kaynağından bağlama başvurun
İstek URL'leri, üst bilgileri, sorgu alanları ve gövdeleri, çift süslü parantezli yer tutucularla bağlam değerlerine başvurabilir.
https://dummyjson.com/posts/{{params.slug}}
https://api.example.com/search?q={{query.q}}Request ile Repeat arasında seçim yapın
| Blok | Ne zaman kullanılır? |
|---|---|
| Request | Uç nokta tek bir nesne döndürüyor ve alanlarını doğrudan öğelere bağlamak istiyorsanız. |
| Repeat | Uç nokta bir dizi döndürüyor ve her öğeyi aynı tasarımla işlemek istiyorsanız. |
NotRepeat yalnızca bir listedeki her öğeyi işlemek istediğinizde gereklidir. Tek bir kaydı bağlıyorsanız yalnızca bir Request bloğu yeterlidir.
Sunucu tarafında çözümleme neden önemlidir?
İstemci tarafında veri getirme, ilk yanıtı boş bırakır; görsel olarak oluşturulmuş birçok sayfayı tarayıcı botları ve yanıt motorları için görünmez kılan da budur. Pagiera, HTML döndürülmeden önce Request bloklarını tamamlar; böylece bir tarayıcı botunun okuduğu içerik, ziyaretçinin gördüğü içerikle aynıdır.
Sık sorulan sorular
Bir veri kaynağı hangi HTTP yöntemlerini kullanabilir?
GET, POST, PUT, PATCH ve DELETE veri kaynakları desteklenir; istek URL'leri, üst bilgileri, sorgu alanları ve gövdeleri rota parametrelerine ve sorgu değerlerine başvurabilir.
API verileri arama motorlarına görünür mü?
Yayımlanan sayfalarda evet. Request blokları sunucuda çözümlenir ve HTML döndürülmeden önce tamamlanır; bu nedenle API destekli içerik daha sonra tarayıcıda yüklenmek yerine ilk yanıtın bir parçasıdır.
Üst API 404 döndürdüğünde ne olur?
Veri kaynağı page-404 davranışını kullandığında, üst API'den gelen 404 boş bir düzen işlemek yerine rotanın tamamını bir 404 sayfasına dönüştürür.
