ODN API

ODN API, Socrata tarafından geliştirilen ve OpenDataNetwork.com üzerinde çalışan bir REST API'dir. Binlerce kamu ve kar amacı gütmeyen kuruluşun sürekli güncellenen açık verilerini tek bir noktadan sunar. API, veri setlerini arama ve otomatik tamamlama özelliklerinin yanı sıra eyalet, ilçe, metropol alanı, şehir ve posta kodu gibi coğrafi bölgelere göre veri karşılaştırması yapma imkanı tanır. Bu karşılaştırmalar, ABD Nüfus Sayımı, BEA, HUD gibi güvenilir veri sağlayıcılarından derlenen verilerle önceden biçimlendirilmiş olarak gelir ve grafik, tablo veya interaktif harita üzerinde kolayca görüntülenebilir. Ayrıca API, insanların sorabileceği anlatısal sorulara göre düzenlenmiş verilere erişim sağlar; bu sorular otomatik tamamlama ile hızlıca bulunabilir ve zaman serileri, tablolar, mekansal sınırlar ve otomatik oluşturulmuş açıklayıcı metinler dahil tüm gerekli verilere ulaşılabilir. ODN API, kamu kurumlarının mevcut API uç noktalarını tekrarlamaz; bunun yerine, bağlamla ilgili önceden doldurulmuş REST URL'leri döndürerek verilere doğrudan kaynağından erişilmesini sağlar. API açık kaynak kodludur ve yeni veri kaynakları sürekli eklendiğinden, favori veri kaynağınız henüz mevcut değilse kısa süre içinde eklenmesi beklenir. ODN API'yi kullanmak için Socrata uygulama token'ı zorunludur; bu token `app_token` parametresi veya `X-App-Token` HTTP başlığı ile iletilmelidir.

Hangi ihtiyaçlarda değerlendirilebilir?

• Kamu verilerini web sitelerinde veya uygulamalarında görselleştirmek isteyen geliştiriciler
• Coğrafi bölgelere göre sosyo-ekonomik karşılaştırmalar yapan analitik platformlar
• Açık veri odaklı haber siteleri veya sivil toplum projeleri

Yaygın kullanım alanları

İncelenmesi gereken noktalar

• •ODN API kullanımı için Socrata uygulama token'ı zorunludur; token'ı `app_token` parametresi veya `X-App-Token` başlığı ile iletmeniz gerekir.
• •API, özellikle ABD merkezli kamu verilerine odaklanmıştır; Türkiye veya diğer ülkeler için veri kapsamı sınırlı olabilir.
• •API'nin döndürdüğü veriler, kaynak kurumların güncelleme sıklığına bağlıdır; gerçek zamanlı veri gerektiren projelerde kaynakların güncelliğini kontrol etmeniz önemlidir.

WordPress.org

Kurulum ve geliştirme notları

Installation Development

ODN API bir REST API olduğundan, kurulum gerektirmez; doğrudan HTTP istekleriyle kullanılır. Entegrasyon için yalnızca bir Socrata uygulama token'ı edinmeniz ve API uç noktalarına istek göndermeniz yeterlidir.

1. 1Socrata developer portalından bir uygulama token'ı edinin.
2. 2API isteklerinizde token'ı `app_token` parametresi veya `X-App-Token` başlığı olarak ekleyin.
3. 3OpenAPI spesifikasyonunu inceleyerek ihtiyacınıza uygun uç noktaları belirleyin ve isteklerinizi oluşturun.

ODN API'nin geliştirme süreci, REST API tüketimi üzerine kuruludur. OpenAPI spesifikasyonu sayesinde istemci kodları otomatik olarak oluşturulabilir. API, veri setlerini arama, otomatik tamamlama, coğrafi karşılaştırma ve soru odaklı veri erişimi gibi çeşitli uç noktalar sunar.

• •OpenAPI spesifikasyonu mevcuttur; bu sayede çeşitli dillerde istemci SDK'ları türetilebilir.
• •API, veri setlerini arama ve otomatik tamamlama için uç noktalar sağlar.
• •Coğrafi bölgelere göre karşılaştırma verileri önceden biçimlendirilmiş olarak sunulur.
• •Anlatısal sorulara dayalı veri erişimi, zaman serileri ve mekansal verileri içerir.

Hazır çözümün ötesinde

Özel geliştirme ne zaman değerlendirilebilir?

ZeplinGo olarak, ODN API'yi web projelerinize entegre etmek için ihtiyaç analizi yapıyor, veri görselleştirme ve karşılaştırma panelleri tasarlıyor ve API tüketimini optimize ediyoruz. Projenizin kapsamına göre özel çözümler geliştiriyoruz.

Ücretsiz ön çalışma isteyin →

Değerlendirme soruları