cURL ile İlk İstek
cURL, terminalden tek satırda API çağrısı yapmanın en hızlı yoludur ve neredeyse her işletim sisteminde hazır bulunur. Anlık gram altın fiyatını çekmek için Authorization başlığını ekleyerek bir GET isteği atmanız yeterlidir: `curl -H "Authorization: Bearer <API_KEY>" https://altinapi.hasfiyat.com/v1/price/gram-altin`. Yanıt olarak sembol, alış (bid), satış (ask) ve zaman damgasını içeren bir JSON gövdesi dönmelidir.
Sorun giderme sırasında `-i` bayrağını ekleyerek yanıt başlıklarını da görebilirsiniz; bu, HTTP durum kodunu ve rate limit sayaçlarını incelemenizi sağlar. `-v` (verbose) bayrağı ise TLS el sıkışmasından gönderilen başlıklara kadar tüm alışverişi gösterir ve 401 gibi kimlik hatalarının kaynağını bulmayı kolaylaştırır. Anahtarı komut geçmişinize yazmamak için bir ortam değişkeninde tutup `-H "Authorization: Bearer $ALTIN_API_KEY"` biçiminde referans vermeniz daha güvenlidir.
Yanıtı okunaklı hale getirmek için çıktıyı `jq` gibi bir araca yönlendirebilirsiniz: `curl -s -H "Authorization: Bearer $ALTIN_API_KEY" .../v1/price/ons | jq`. Böylece ons altın (XAU) ya da USD/TRY paritesi gibi sonuçları biçimli biçimde görüp beklenen alanların geldiğini hızlıca doğrulayabilirsiniz.
Postman ile Koleksiyon Kurmak
Postman, isteklerinizi görsel bir arayüzde saklayıp tekrar kullanmanız için idealdir. Yeni bir istek oluşturup metodu GET, URL'yi ilgili uca ayarladıktan sonra Authorization sekmesinde tür olarak Bearer Token'ı seçin ve anahtarınızı girin. Alternatif olarak Headers sekmesine doğrudan `Authorization: Bearer <API_KEY>` satırını da ekleyebilirsiniz; ikisi aynı sonucu verir.
Anahtarı her isteğe tek tek yazmamak için Postman'in ortam (environment) değişkenlerini kullanın. `base_url` ve `api_key` adında iki değişken tanımlayıp URL'de `{{base_url}}/v1/price/ceyrek-altin`, header'da `Bearer {{api_key}}` yazdığınızda, geliştirme ile üretim ortamları arasında tek tıkla geçebilirsiniz. Anahtarı 'secret' türünde tanımlamak, ekran paylaşımı sırasında maskelenmesini sağlar.
İsteklerinizi bir koleksiyon altında toplayıp örnek yanıtları kaydettiğinizde, ekibinizle paylaşılabilir yaşayan bir dokümana kavuşursunuz. Postman'in Tests sekmesine `pm.test("200 döndü", () => pm.response.to.have.status(200));` gibi küçük betikler ekleyerek, her çağrıda durum kodunu ve alan varlığını otomatik doğrulayabilirsiniz. Bu, API sözleşmesindeki bir değişikliği erken fark etmenizi sağlar.
Yanıtı Doğrulamak ve Sonraki Adım
İster cURL ister Postman kullanın, test aşamasında birkaç şeyi rutin olarak kontrol edin: HTTP durum kodunun 200 olması, yanıttaki zaman damgasının güncelliği ve alış/satış değerlerinin makul bir aralıkta olması. 401 alıyorsanız anahtar veya header formatı, 429 alıyorsanız istek sıklığınız, 403 alıyorsanız istediğiniz sembolün planınıza dahil olup olmadığı ilk bakılacak yerlerdir.
Farklı sembolleri denemek, kapsamı anlamanın en iyi yoludur. Gram ve has altının yanı sıra çeyrek, ata ve cumhuriyet altını, ons XAU, gümüş, platin ve paladyum, 995/916/750/585 ayar bazlı değerler ile USD/EUR/GBP pariteleri için ucu değiştirip aynı komutu tekrarlayın. Serbest piyasa alış/satış kotasyonlarını da aynı yapıyla çekebilirsiniz.
cURL ve Postman ile sözleşmeyi doğruladıktan sonra sıra gerçek entegrasyona gelir. Hasfiyat API'si REST'in yanında WebSocket (Socket.IO) ve Webhook desteği sunduğu için, anlık fiyat akışını sürekli sorgulamadan, milisaniye gecikmeyle abonelik üzerinden alabilirsiniz. Test ortamında öğrendiğiniz header ve doğrulama alışkanlıklarını doğrudan üretim kodunuza taşıyarak sağlam bir entegrasyona ulaşırsınız.
Sık sorulan sorular
cURL ile Hasfiyat altın API'sini nasıl test ederim?
curl -H "Authorization: API_ANAHTARINIZ" komutuyla uç nokta URL'sine GET isteği atarsınız. Dönen JSON yanıtını terminalde görüp alış-satış alanlarını doğrularsınız. -i bayrağını ekleyerek durum kodunu ve header'ları da inceleyebilirsiniz.
Postman'de Authorization header nasıl ayarlanır?
Postman'de isteğin Headers sekmesine Authorization anahtarını ekler ya da Authorization sekmesinden uygun tipi seçersiniz. Anahtarı bir ortam değişkeni olarak tanımlarsanız istekler arasında yeniden kullanabilirsiniz. Gönder'e bastığınızda yanıt gövdesinde fiyat verisini görürsünüz.
cURL ile POST isteği göndermem gerekir mi, yoksa GET yeterli mi?
Fiyat okuma uç noktaları genelde GET isteğiyle çalışır; sadece Authorization header eklemeniz yeterlidir. Toplu e-fatura kesimi gibi işlem gerektiren uç noktalar için gövdeli POST kullanabilirsiniz. Doküman her uç noktanın hangi metodu beklediğini belirtir.
Postman'de dönen altın fiyatı JSON'unu daha okunur nasıl görürüm?
Yanıt panelinde Pretty görünümünü ve JSON formatını seçerek veriyi girintili ve renkli görürsünüz. Beautify ile düzensiz JSON'u da düzenleyebilirsiniz. Bu görünüm sembol, alış ve satış alanlarını hızlıca incelemenizi sağlar.
cURL isteğim 401 dönüyor, nasıl düzeltirim?
401 Authorization header'ının eksik veya hatalı olduğunu gösterir; -H "Authorization: ANAHTAR" bölümünü ve anahtarın doğruluğunu kontrol edin. Anahtar etrafında istem dışı boşluk veya tırnak olmadığından emin olun. Doğru anahtarla istek yetkilenir ve fiyat verisi döner.
Postman koleksiyonuyla birden çok altın uç noktasını topluca test edebilir miyim?
Evet, uç noktaları bir koleksiyonda toplayıp ortak Authorization değişkeniyle Collection Runner üzerinden sırayla çalıştırabilirsiniz. Her istek için test scriptleriyle durum kodunu ve alanları doğrularsınız. Bu yöntem entegrasyon öncesi hızlı bir doğrulama sağlar.
cURL ile yanıt süresini nasıl ölçerim?
curl -w "%{time_total}\n" -o /dev/null -s seçenekleriyle isteğin toplam süresini görebilirsiniz. Bu ölçüm API'nin milisaniye altı gecikme performansını kendi ağınızdan doğrulamanıza yardımcı olur. Farklı zamanlarda ölçüp ortalamayı değerlendirin.
Canlı altın & döviz verisine hemen bağlanın
Dakikalar içinde REST veya Socket.IO ile gerçek zamanlı fiyat akışına başlayın.