GitHub Public APIs: Ücretsiz API Bulma Rehberi

Uygulamanın tasarımını yaptın. Ekranlar yerli yerinde, butonlar hazır. Ama bir yerde durdun: “Bu uygulamanın içine koyacağım veriyi nereden bulacağım?”

GitHub’daki Public APIs, tam bu noktada bakabileceğin bir kaynak listesi. Hava durumu, oyunlar, kitaplar ve bilim gibi farklı alanlardaki API bağlantılarını kategoriler halinde bir araya getiriyor. [1]

Public APIs nedir?

Önemli ayrımı baştan yapalım: Public APIs, bilgisayarına kurup çalıştıracağın bir uygulama veya bütün verileri tek adresten sunan bir servis değil. Farklı API hizmetlerini keşfetmeni sağlayan bir rehber. Kullanacağın servisin kendi dokümantasyonuna gitmen gerekiyor. [1]

API ne işe yarar?

API, yazılımların belirli kurallar çerçevesinde birbiriyle iletişim kurmasını sağlayan arayüzdür. Buradaki web API’lerini, uygulamanın başka bir hizmetten veri istemesi için kullanabileceğin bir kapı gibi düşünebilirsin. [2]

Örneğin bir hava durumu ekranı tasarladığını hayal et. Sıcaklık bilgisini elle yazmak yerine uygun bir hava durumu API’sinden alıp kendi tasarımında göstermeyi hedefleyebilirsin. Open-Meteo’nun dokümantasyonunda sıcaklık, yağış ve rüzgâr gibi veri alanları bulunuyor. [3]

Listede nasıl ilerlemelisin?

Önce projenin ihtiyacını belirle. Sonra Public APIs içinde ilgili kategoriye geç. Listedeki Auth sütunu kimlik doğrulama gereksinimi, HTTPS ve CORS sütunları da bağlantı ve tarayıcı kullanımı hakkında ilk bilgiyi veriyor. Bu tabloyu başlangıç noktası olarak kullan; son kararını hizmetin resmi dokümantasyonuna göre ver. [1]

CORS, tarayıcının başka bir kaynaktan veri almasına sunucunun hangi koşullarda izin verdiğiyle ilgilidir. Bir bağlantının tarayıcıda açılması, web uygulamandaki isteğin otomatik olarak çalışacağı anlamına gelmez. [4]

Başlamak için üç küçük proje fikri

Hava durumu kartı

Seçtiğin bir konumun sıcaklığını ve hava durumunu gösteren sade bir kart yapmayı deneyebilirsin. Open-Meteo bunun için inceleyebileceğin seçeneklerden biri. Ücretsiz API erişiminin ticari olmayan kullanım için sunulduğunu ve istek sınırları bulunduğunu unutma. Ticari projede güncel planları ayrıca kontrol et. [3][5]

Pokémon bilgi kartı

PokéAPI, Pokémon verilerini sunuyor ve REST API’ye erişmek için kimlik doğrulama gerekmiyor. Bir isim arama alanı ve sonuç kartı tasarlamak iyi bir alıştırma olabilir. Hizmetin adil kullanım politikası, alınan verilerin yerel olarak önbelleğe alınmasını istiyor. [6]

Günün uzay içeriği

NASA’nın APOD API’siyle bir astronomi içeriğinin başlığını, açıklamasını ve medya bağlantısını gösteren bir sayfa tasarlayabilirsin. Yanıt her zaman görsel olmayabilir; video da olabilir. API anahtarı kullanımını ve varsa içeriğin telif bilgisini dokümantasyondan kontrol et. [7]

Bu üçü hazır uygulama vaadi değil; seçtiğin veriyi kendi arayüzüne taşımak için proje fikirleri.

İlk deneme: Tek bir veriyi ekrana getir

PokéAPI ile başlarken resmi dokümantasyondaki Pokemon bölümünü aç. İstek adresi, Pokémon’un adını veya numarasını kabul ediyor. Örnek bir deneme adresi:

https://pokeapi.co/api/v2/pokemon/pikachu/

Dönen verideki name ve id gibi alanları incele. İlk hedefin yalnızca bir adı kendi kartında göstermek olsun. Sonra arama alanı, yükleniyor durumu ve hata mesajı eklemeyi deneyebilirsin. [6]

Ücretsiz demek sınırsız demek değil

Örneğin Open-Meteo’nun ücretsiz API’sinde kullanım amacı ve istek sayısıyla ilgili koşullar var. PokéAPI’de de adil kullanım kurallarına uyman bekleniyor. Yani “Listede var, her koşulda kullanabilirim” diye düşünme; projenin ihtiyacıyla hizmetin şartlarını birlikte değerlendir. [5][6]

Bizim önerimiz: Önce tek bir veri kaynağı seç, tek bir bilgiyi ekrana getir ve oradan ilerle. Büyük bir uygulamayı planlamak yerine küçük ama çalışan bir örnek hedefle.

Bu içeriğin Instagram dalga kodu: api.

Kaynaklar

[1] Public APIs - resmi GitHub deposu: https://github.com/public-apis/public-apis

[2] MDN - API nedir?: https://developer.mozilla.org/en-US/docs/Glossary/API

[3] Open-Meteo - Weather Forecast API: https://open-meteo.com/en/docs

[4] MDN - CORS: https://developer.mozilla.org/en-US/docs/Web/HTTP/Guides/CORS

[5] Open-Meteo - planlar ve kullanım koşulları: https://open-meteo.com/en/pricing

[6] PokéAPI - dokümantasyon ve adil kullanım: https://pokeapi.co/docs/v2

[7] NASA - APOD API dokümantasyonu: https://github.com/nasa/apod-api