Katalogdaki her kayıt aynı adımlardan geçer. Bu sayfa, bir katalog sayfasında gördüğünüz bilginin nereden geldiğini ve neyin doğrulanmış, neyin doğrulanmamış olduğunu açıklar.
Her kayıt, sağlayıcının kendi dokümantasyonundan başlar. API'nin resmî mi yoksa topluluk tarafından yürütülen bir sarmalayıcı mı olduğu ayrıca işaretlenir; bu ayrım süreklilik beklentisini doğrudan değiştirdiği için gizlenmez. Dokümantasyon, fiyatlandırma, kullanım koşulları ve gizlilik metni ayrı bağlantılar olarak saklanır, böylece bir iddiayı kaynağına kadar takip edebilirsiniz.
Kimlik doğrulama yöntemi, ücretsiz katmanın gerçekte ne kapsadığı ve oran sınırları dokümantasyondan okunur. Burada tahmin yürütmüyoruz: bir sağlayıcı limitini yayımlamıyorsa alan “belirtilmemiş” olarak kalır. Pazarlama sayfasındaki “ücretsiz” ifadesi ile geliştirici dokümanındaki gerçek kota çoğu zaman aynı şey değildir ve kataloğun işi bu farkı görünür kılmaktır.
Uygun API'lerde gerçek bir endpoint çağrılır ve istek, yanıt ile test tarihi kayda eklenir. Test Lab üzerinden aynı çağrıyı tarayıcıda kendiniz de çalıştırabilirsiniz. Tek bir başarılı test, kesintisiz hizmet garantisi değildir — yalnızca o tarihte o endpoint'in beklendiği gibi yanıt verdiğini gösterir.
Bir kaydın indekslenebilir sayılması için özet, kullanım senaryoları ve doğrulama notlarının her iki dilde de yeterli olması, çalışır örnek bulunması ve bir insan tarafından incelenmiş olması gerekir. Bu ölçütlerin tamamını karşılamayan kayıtlar katalogda kalır ancak arama motorlarına indekslenmez. Sağlayıcı koşullarını değiştirdiğinde kayıt yeniden incelenir ve son kontrol tarihi güncellenir.
Katalog, bir API'yi entegre etmeden önce “bu iş için doğru kaynak hangisi ve gerçekten ücretsiz mi” sorusunu cevaplaması gereken geliştiriciler için hazırlanır. Yan proje yapan biri için anahtarsız ve hızlı başlanabilen seçenekler, üretim sistemi kuran biri için ise oran limitleri, kimlik doğrulama modeli ve kullanım koşulları öne çıkar. Blog tarafındaki rehberler bu kararları belirli bir alan üzerinden — hava durumu, ödeme, coğrafi kodlama, açık veri — uçtan uca örnekleyerek tamamlar.