Gold API

Genel Bilgi

Gold API, altın ve döviz fiyatlarını WebSocket üzerinden gerçek zamanlı olarak dağıtır. Her client kendi API anahtarıyla bağlanır ve izin verilen sembolleri alır.

• Sunucu: —
• Protokol: wss:// (Nginx üzerinden port 443)
• Kimlik Doğrulama: API Key (URL parametresi veya Bearer header)

WebSocket Bağlantısı

WS wss://api.sezginkuyumculuk.com?key=YOUR_API_KEY

Alternatif — Authorization header:

Authorization: Bearer YOUR_API_KEY

Mesaj Tipleri

snapshot — Bağlandığında tüm fiyatları gönderir:

{
  "type": "snapshot",
  "data": [
    { "symbol": "ALTIN", "category": "Kıymetli Madenler",
      "bid": 3850.25, "ask": 3855.10, "timestamp": 1716220800000 }
  ],
  "server_time": 1716220800000
}

update — Sadece değişen semboller:

{ "type": "update", "data": [...], "server_time": ... }

status — Veri akışı durumu:

{ "type": "status", "status": "live" | "stale", "server_time": ... }

Desteklenen Semboller

JavaScript Örneği

const ws = new WebSocket('wss://api.sezginkuyumculuk.com?key=YOUR_API_KEY');

ws.addEventListener('open', () => console.log('Bağlandı'));

ws.addEventListener('message', (evt) => {
  const msg = JSON.parse(evt.data);
  if (msg.type === 'snapshot' || msg.type === 'update') {
    msg.data.forEach(p => {
      console.log(p.symbol, '| Alış:', p.bid, '| Satış:', p.ask);
    });
  }
  if (msg.type === 'status') console.log('Durum:', msg.status);
});

ws.addEventListener('close', e => console.log('Kapandı', e.code));
ws.addEventListener('error', e => console.error('Hata', e));

PHP Örneği

<?php
// composer require textalk/websocket
require 'vendor/autoload.php';
use WebSocket\Client;

$ws = new Client('wss://api.sezginkuyumculuk.com?key=YOUR_API_KEY');
while (true) {
    $msg = json_decode($ws->receive(), true);
    if (in_array($msg['type'], ['snapshot','update'])) {
        foreach ($msg['data'] as $p) {
            echo $p['symbol'] . ' Alış:' . $p['bid'] . PHP_EOL;
        }
    }
}

Bağlantı Hata Kodları

Kod	Açıklama
4001	API key eksik
4002	Yeni bağlantı açıldı (eski kapatıldı)
4003	Geçersiz veya süresi dolmuş API key
4005	IP adresiniz bu API key için yetkili değil