Wednesday, March 12, 2025

Postman ile Binance API Metotlarını Test Etme

Binance API, kripto para ticaretini otomatikleştirmek ve platformla entegrasyon sağlamak için kapsamlı bir arayüz sunar. Bu rehber, Postman kullanarak Binance API'nin tüm metotlarını nasıl test edeceğinizi ayrıntılı olarak açıklayacaktır.

Gereksinimler:

  • Postman: Postman uygulamasının yüklü olması.
  • Binance API Anahtarları: Binance hesabından oluşturulmuş API anahtarları.
  • API Dokümantasyonu: Binance API dokümantasyonuna erişim.

Adım 1: Postman'de Çalışma Alanı ve Koleksiyon Oluşturma

  1. Postman'i açın ve yeni bir çalışma alanı oluşturun.
  2. Çalışma alanında, "Collections" sekmesine giderek yeni bir koleksiyon oluşturun (örneğin, "Binance API Testleri").

Adım 2: Ortam Değişkenlerini Ayarlama

  1. Koleksiyonunuzun sağ üst köşesindeki "..." simgesine tıklayın ve "Edit"i seçin.
  2. "Variables" sekmesine gidin ve aşağıdaki değişkenleri ekleyin:
    • baseUrl: https://api.binance.com
    • apiKey: API anahtarınız
    • apiSecret: Gizli anahtarınız

Adım 3: API İsteklerini Oluşturma ve Test Etme

Binance API dokümantasyonu, farklı uç noktaları ve metotları kategorilere ayırır. Bu kategorilere göre testleri düzenleyeceğiz.

3.1. Piyasa Verileri (Market Data)

  • GET /api/v3/ping:
    • Sunucunun çalışır durumda olduğunu kontrol eder.
    • URL: {{baseUrl}}/api/v3/ping
  • GET /api/v3/time:
    • Sunucu zamanını alır.
    • URL: {{baseUrl}}/api/v3/time
  • GET /api/v3/ticker/price:
    • Sembolün güncel fiyatını alır.
    • URL: {{baseUrl}}/api/v3/ticker/price?symbol=BTCUSDT
  • GET /api/v3/klines:
    • K-çizgisi/mum verilerini alır.
    • URL: {{baseUrl}}/api/v3/klines?symbol=BTCUSDT&interval=1m

3.2. Hesap Bilgileri (Account)

  • GET /api/v3/account:
    • Hesap bilgilerini alır (imza gerektirir).
    • URL: {{baseUrl}}/api/v3/account
  • GET /api/v3/myTrades:
    • Hesap işlem geçmişini alır (imza gerektirir).
    • URL: {{baseUrl}}/api/v3/myTrades?symbol=BTCUSDT

3.3. Emirler (Orders)

  • POST /api/v3/order:
    • Yeni bir alım/satım emri verir (imza gerektirir).
    • URL: {{baseUrl}}/api/v3/order
  • GET /api/v3/openOrders:
    • Açık emirleri listeler (imza gerektirir).
    • URL: {{baseUrl}}/api/v3/openOrders
  • DELETE /api/v3/order:
    • Bir emri iptal eder (imza gerektirir).
    • URL: {{baseUrl}}/api/v3/order

Adım 4: İmza Oluşturma (Authentication)

  1. Birçok Binance API metodu, isteğin imzalanmasını gerektirir.
  2. Postman'de "Pre-request Script" sekmesini kullanarak imza oluşturma işlemini otomatikleştirebilirsiniz.
  3. İmza oluşturmak için, isteğin parametrelerini ve gizli anahtarınızı kullanarak bir HMAC SHA256 hash'i oluşturmanız gerekir.

Adım 5: Testleri Otomatikleştirme ve Doğrulama

  1. Postman'in "Tests" sekmesini kullanarak API yanıtlarını doğrulayabilirsiniz.
  2. Test senaryoları oluşturarak API'nin beklenen davranışlarını doğrulayın.
  3. Newman gibi araçlarla testlerinizi otomatikleştirebilir ve sürekli entegrasyon (CI) süreçlerinize dahil edebilirsiniz.

Önemli Notlar:

  • Binance API dokümantasyonunu düzenli olarak kontrol edin, çünkü API değişiklik gösterebilir.
  • API anahtarlarınızı ve gizli anahtarlarınızı güvenli bir şekilde saklayın.
  • Binance api'si ile işlem yaparken testnet ağını kullanmanız olası kayıplarınızı engelleyecektir.
  • Hata kodlarına ve mesajlarına dikkat edin.

No comments: