API Nedir ve Adım Adım API Kullanımı

Şekil Resim Bir
API Nedir ve Adım Adım API Kullanımı

Karnınız acıktı ve yemek yemek için bulduğunuz en yakın restorana girdiniz. Şimdi sıra
genellikle en zor ama en keyifli aşamada, ne yiyeceğinize karar vermek 🙂
Uzun düşüncelere daldıktan sonra artık ne yiyeceğinize karar verdiyseniz, seçimimizi mutfağa
iletmesi için garsona siparişimizi verebiliriz. Eğer şanslıysanız, kısa süreli bir beklemenin
ardından yemeğinizi yemeye başlayabilirsiniz 🙂

Peki bu senaryonun konumuzla olan alakası ne?


Aslında API’lar da bizim için tam olarak bu görevi üstlenirler. Veri ile ilgili yaptığımız projelerde
bazen popüler bazı kaynakların verilerini kullanmak isteriz ancak onları nereden bulacağımızı
tam olarak bilemeyebiliriz. İşte bu noktada tam olarak yapmamız gereken, API’lardan
yararlanarak kaynak veritabanıyla kendi bilgisayarımız arasında o bağlantıyı kurmaktır.

API’lar kendi içerisinde kullanım senaryolarına göre bazı kategorilere ayrılırlar. Aşağıdaki
şekilde bunların neler olduğunu inceleyebilirsiniz.

Open API’leri erişmek diğerine nazaran çok daha zahmetsiz olduğu için örneklerimizi bu API’ler
üzerinden şekillendirelim.
NOT: OpenAPI dediğimize bakmayın, günümüzde açık kaynakların yükselişine hepimiz şahit
oluyoruz 🙂 İşte bazı çok bilinen örnekler…

Yukarıdaki logolardaki firmaların API servislerine ulaşabilir, bu sitelerden
ihtiyacınız olan API’lere erişebilmek için yapmanız gerekenleri adım adım açıklayan dokümanlar
bulabilirsiniz.
Ama özellikle bu araçları ilk defa kullanacaksanız, ne zaman ne yapılması gerektiğiyle ilgili kafa
karışıklıkları yaşanabiliyor. Bu sebeple yapmanız gereken temel işlem adımlarını beraber
sırasıyla inceleyelim.

Son olarak da yukarıda konuştuklarımızın tam olarak karşılığını görebileceğimiz bir uygulama
gerçekleştirelim. Yukarıda bahsettiğimiz AccuWeather’ın verilerine ulaşmayı deneyelim 🙂

https://developer.accuweather.com/ adresine giderek AccuWeather’ın API servisine kayıt
olun.

Hesabınızı oluşturduktan sonra hesabınıza tekrar giriş yapın ve aşağıdaki ekran
görüntüsünde de gösterildiği gibi yeni bir app oluşturun.

Oluşturduğunuz appi aşağıdaki listeden görebilirsiniz. Listenin içerisinde yer alan API
Key’ini kullanarak ise bize sunulan verilerden artık yararlanabiliyor olacağız.

Ardından da bu API Key’ini kullanarak aşağıda görmüş olduğunuz servislere erişebiliyor
oluruz. Örneğin İstanbul’daki son 24 saatlik hava durumu verilerine ulaşmayı deneyelim.

Bunun için, Current Conditions API –> Historical Current Conditions (past 24 hours)
linkine tıklarsanız, karşınıza aşağıdaki gibi bir sayfa çıkıcaktır. Burada bizden bu verilere
erişebilmemiz için gerekli anahtarları istiyor.

Eğer dönen response kodu 200 ise bağlantı başarılı bir şekilde gerçekleştirilmiştir. İşte
görüntülediğimiz verilere ait küçük bir kesit :

İstediğimiz konuyla ilgili verileri artık websitesi üzerinden görüntüleyebiliyoruz. Ama küçük
bir adıma daha ihtiyacımız var. Şimdi de bu verileri Python çalışma ortamlarımıza aktarmayı
deneyelim.

NOT: base_url değişkeninde tanımlanan url adresine cURL sekmesinden ulaşabilirsiniz

Bir çok firma verileri Json formatında paylaşmayı tercih ettikleri için bizim de bu dönüşümü
yapmamız gerekiyor. İşte elde ettiğimiz veri setine dair küçük bir kesit 🙂

Son olarak da bu çıktılarımızı daha aşina olunan bir formata getirelim.

NOT: Her sitenin API kullanımında, yapılacak işlem adımları genellikle bu şekilde olsa da,
zaman zaman küçük farklılıklar olabilmektedir. Hatta Spotify gibi büyük şirketlerin API
servislerini kullanabilmek için geliştirilen Spotipy isminde Python kütüphaneleri de mevcuttur.
Bu sebeple işe koyulmadan önce, sitelerde paylaşılan dokümantasyonları dikkatli bir şekilde
okumayı ihmal etmeyin 🙂

Bir yanıt yazın

E-posta adresiniz yayınlanmayacak. Gerekli alanlar * ile işaretlenmişlerdir