Spot Fiyat Bağlantısını Test Et

Gönderilen yapılandırmadan geçici bir sağlayıcı oluşturur ve örnek bir fiyat sorgular: USD cinsinden ETH. Hiçbir şey kaydedilmez ve hiçbir önbelleğe dokunulmaz. Kayıtlı yapılandırma kullanılmaz: test etmek istediğiniz API anahtarını gönderin.

• Boş base_url sağlayıcının kendi endpoint'ini dener. Yazılmış bir URL anahtarı alır; bu yüzden herkese açık https ya da ortamın listelediği bir küme içi host olmalıdır; diğer her şey hiçbir şey gönderilmeden 10001 (domain 83) ile reddedilir.
• use_config: true reddedilir: test edilecek yerleşik bir yapılandırma yoktur.

Başarısız bir deneme yine 200 döner; ok: false olur ve neden error alanında yer alır. Kullanılabilir bir fiyat döndürmeden yanıt veren sağlayıcı da ok: false olur.

Yalnızca platform sahibi. Çağıranın düğümü platformun kök düğümü olmalıdır; diğer çağıranlar 403 / 10005 ile reddedilir.

Gerekli izin: spot-quote-provider:update

İstek

POST /v2/admin/spot-quote-providers/test

Başlıklar

Ad	Açıklama
Authorization	Zorunlu. Bearer <access_token>
Content-Type	Zorunlu. application/json

Gövde

Alan	Tip	Zorunlu	Açıklama
provider	string	Evet	Sağlayıcı anahtarı: cryptocompare ya da coinmarketcap
api_key	string	Hayır	Denemede kullanılacak API anahtarı
base_url	string	Hayır	API temel URL'si. Boş değer sağlayıcının kendi endpoint'i demektir
timeout	integer	Hayır	Saniye cinsinden istek zaman aşımı, 0 veya daha büyük
use_config	boolean	Hayır	Gönderilmemeli ya da false olmalı; true reddedilir

Örnek

curl --request POST \
  --url '{{baseUrl}}/v2/admin/spot-quote-providers/test' \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "provider": "coinmarketcap",
    "api_key": "<coinmarketcap_api_key>",
    "base_url": "",
    "timeout": 30
  }'

Yanıt

{
  "ok": true,
  "latency_ms": 264,
  "sample_symbol": "ETH",
  "price": "3412.57"
}

Yanıt Alanları

Alan	Tip	Açıklama
ok	boolean	Örnek sembol için pozitif bir fiyat dönüp dönmediği
latency_ms	integer	Sorgunun milisaniye cinsinden süresi
sample_symbol	string	Sorgulanan sembol: ETH
price	string	Örnek sembolün USD cinsinden fiyatı, ondalık string. ok false olduğunda "0"
error	string	Yalnızca ok false olduğunda: sorgunun neden başarısız olduğu

Hatalar

Durum	Kod	Açıklama
400	10015	Doğrulama başarısız (provider eksik, negatif timeout) — details alanına bakın. Ayrıca: desteklenmeyen sağlayıcı anahtarı ya da use_config: true
400	10001	Yazılan base_url reddedildi: https değil, çözümlenemiyor ya da özel veya metadata adresine çözümleniyor (domain 83)
403	10005	Çağıran platform sahibi değil (domain 2)

Hata biçimi ve ortak kodlar için Hatalar sayfasına bakın.