Geliştirici Dokümantasyonu

Autr Döviz & Altın Kuru API

HTTP REST API ve WebSocket (WSS) protokolleri üzerinden canlı döviz, altın, sarrafiye, gümüş ve kripto fiyat akışlarına erişin.

Üye Ol & API Key Al

Protokol HTTP REST & WebSocket

Veri Akışı Gerçek Zamanlı (Real-Time)

Kimlik Doğrulama API Key (ak_live_...)

1 API Anahtarı (API Key) Nasıl Alınır?

API servislerimize yetkili erişim sağlamak için ücretsiz üyelik hesabınız üzerinden size özel bir API Key oluşturmanız gerekmektedir.

Adım 1: Üye Olun

Hesabınız yoksa e-posta adresiniz ile saniyeler içinde ücretsiz üye olun.

Adım 2: Paneli Açın

Profil menünüzden API Anahtarlarım sayfasına gidin.

Adım 3: Key Üretin

"API Anahtarı Oluştur" butonuna basarak ak_live_... anahtarınızı alın.

2 HTTP REST API Kullanımı

Anlık döviz, altın ve piyasa fiyatlarını JSON formatında çeken HTTP endpoint'i.

Endpoint URL

GET https://autr.tr/api/prices/live

Yetkilendirme (Parametre & Başlık Seçenekleri)

1. URL Query Parametresi: ?api_key=ak_live_YOUR_KEY

2. HTTP Header: X-API-Key: ak_live_YOUR_KEY

3. Authorization Header: Authorization: Bearer ak_live_YOUR_KEY

Örnek JSON Yanıtı

{
  "status": "success",
  "api_key_provided": true,
  "authenticated_user": {
    "id": 12,
    "name": "Hamdi Yılmaz"
  },
  "prices": {
    "USDTRY": { "alis": 34.254, "satis": 34.289 },
    "EURTRY": { "alis": 37.120, "satis": 37.165 },
    "GRAMALTIN": { "alis": 2980.50, "satis": 2985.00 },
    "CEYREK_YENI": { "alis": 4850.00, "satis": 4930.00 },
    "GUMUSTRY": { "alis": 38.45, "satis": 39.10 }
  }
}

Kod Örnekleri

cURL

curl -X GET "https://autr.tr/api/prices/live?api_key=ak_live_YOUR_KEY"

JavaScript (Fetch)

fetch('https://autr.tr/api/prices/live?api_key=ak_live_YOUR_KEY')
  .then(response => response.json())
  .then(data => console.log('Canlı Fiyatlar:', data.prices));

Python (Requests)

import requests

headers = {"X-API-Key": "ak_live_YOUR_KEY"}
res = requests.get("https://autr.tr/api/prices/live", headers=headers)
print(res.json())

PHP (cURL)

$ch = curl_init('https://autr.tr/api/prices/live?api_key=ak_live_YOUR_KEY');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = json_decode(curl_exec($ch), true);
print_r($response['prices']);

3 WebSocket (WSS) Canlı Akış Kullanımı

Milisaniye hassasiyetinde canlı piyasa fiyat güncellemelerini aktaran WebSocket kanalı.

WebSocket Endpoint URL

WSS wss://autr.tr/ws/prices?api_key=ak_live_YOUR_KEY

Bağlantı & Veri Akış Yapısı

Bağlantı kurulduğunda sunucu ilk olarak {"type": "init", "snapshot": [...]} paketi ile tüm paritelerin başlangıç fiyatlarını gönderir.
Piyasada fiyat değiştikçe [[parite_idx, alis_fiyati, satis_fiyati]] dizisi şeklinde anlık güncellemeler akar.

WebSocket İstemci Kod Örnekleri

JavaScript (Standard Browser WebSocket)

const ws = new WebSocket('wss://autr.tr/ws/prices?api_key=ak_live_YOUR_KEY');

ws.onopen = () => {
    console.log('Autr Canlı Fiyat Portuna Bağlanıldı');
};

ws.onmessage = (event) => {
    const data = JSON.parse(event.data);
    if (data.type === 'init') {
        console.log('Initial Snapshot:', data.snapshot);
    } else {
        console.log('Price Update Tick:', data);
    }
};

ws.onerror = (err) => console.error('WS Error:', err);

Python (websockets kütüphanesi)

import asyncio
import websockets
import json

async def listen_prices():
    uri = "wss://autr.tr/ws/prices?api_key=ak_live_YOUR_KEY"
    async with websockets.connect(uri) as ws:
        print("WebSocket Bağlantısı Başarılı")
        while True:
            msg = await ws.recv()
            print("Gelen Akış:", json.loads(msg))

asyncio.run(listen_prices())

4 API Key Kullanım ve Anlık Loglama Politikası

API servislerimizin güvenliğini ve adil kullanımını sağlamak amacıyla; API anahtarınız ile gerçekleştirdiğiniz tüm HTTP REST ve WebSocket çağrılarının yanına aşağıdaki bilgiler anlık olarak sistem loglarına ve veritabanınıza kaydedilmektedir:

• Tarih / Zaman Damgası: İstek atıldığı anın UTC/TS zamanı

• API Anahtarı (API Key): İstekte kullanılan ak_live_... kodu

• Kullanıcı Kimliği (User ID): Hesabınıza ait benzersiz ID

• IP Adresi: Çağrının yapıldığı sunucu/cihaz IP adresi

• Endpoint: Çağrılan servis adresi (ör. GET /api/prices/live, WS /ws/prices)

Hesabınızın API Anahtarlarım sayfasından son yapılan çağrıları ve IP adreslerinizi canlı olarak takip edebilir, şüpheli durumlarda tek tıkla yeni API anahtarı üretebilirsiniz.