Oracle'ı Getir

Tek bir fiyat oracle'ını bağlantısıyla birlikte döndürür. Kimlik doğrulama gizli değeri hiçbir zaman döndürülmez: integration.connection.auth.secret_set yalnızca bir gizli değerin kayıtlı olup olmadığını söyler. Silinmiş bir oracle bulunamaz.

Gerekli izin: oracle:view

İstek

GET /v2/admin/oracles/{oracle_id}

Parametreler

Ad	Tip	Konum	Açıklama
oracle_id	string	path	Zorunlu. Oracle ID'si (24 karakterlik hex)

Başlıklar

Ad	Açıklama
Authorization	Zorunlu. Bearer <access_token>

Örnek

curl --request GET \
  --url '{{baseUrl}}/v2/admin/oracles/677ed6e3cc111aea14a3dfc3' \
  --header 'Authorization: Bearer <access_token>'

Yanıt

{
  "id": "677ed6e3cc111aea14a3dfc3",
  "category_id": "677ed6e3cc111aea14a3dfb4",
  "type": "TEFAS",
  "name": "Gümüş Fonu",
  "description": "TEFAS Gümüş Fonu",
  "integration": {
    "codes": [
      { "code": "IOG", "name": "Gümüş Fonu" },
      { "code": "GTZ", "name": "Gümüş Fonu", "description": "Silver fund, second share class" }
    ],
    "fiat_currency": "TRY",
    "connection": {
      "url": "https://tefas-api.p.rapidapi.com",
      "timeout": 30,
      "cache_ttl_seconds": 0,
      "auth": {
        "type": "API_KEY",
        "name": "x-rapidapi-key",
        "username": "",
        "secret_set": true
      },
      "headers": [
        { "name": "x-rapidapi-host", "value": "tefas-api.p.rapidapi.com" }
      ]
    },
    "summary_cache_ttl_seconds": 0,
    "default_summary_cache_ttl_seconds": 43200
  },
  "created_at": "2024-01-01T00:00:00Z",
  "updated_at": "2026-10-27T09:12:31.004Z"
}

Yanıt Alanları

Alan	Tip	Açıklama
id	string	Oracle ID'si
category_id	string	Oracle'ın ait olduğu kategori
type	string	Kaynak tipi: TEFAS, TOGG ya da SHEET (yayımlanmış bir tablo)
name	string	Oracle adı
description	string	Açıklama
integration	object	Kaynak yapılandırması
integration.codes	array	Bu oracle'ın fiyatlayabildiği seriler; her biri code ile adreslenir
integration.codes[].code	string	Kaynağın seriyi tanıdığı kod (ör. fon kodu)
integration.codes[].name	string	Serinin görünen adı
integration.codes[].description	string	Serinin açıklaması. Ayarlanmamışsa gönderilmez
integration.fiat_currency	string	Kaynağın fiyatladığı para biriminin ISO 4217 kodu (ör. TRY)
integration.connection	object	Oracle'ın okuduğu yer
integration.connection.url	string	Kaynağın temel URL'si
integration.connection.timeout	integer	Saniye cinsinden istek zaman aşımı. 0 varsayılan değer (30) demektir
integration.connection.cache_ttl_seconds	integer	Alınan kaynak belgenin tek bir sunucu sürecinde ne kadar süre yeniden kullanılacağı. 0 bu önbelleği kapatır
integration.connection.auth.type	string	NONE, BEARER, API_KEY, BASIC ya da QUERY_PARAM
integration.connection.auth.name	string	Gizli değerin taşındığı başlık (API_KEY) ya da query parametresi (QUERY_PARAM)
integration.connection.auth.username	string	Kullanıcı adı (yalnızca BASIC)
integration.connection.auth.secret_set	boolean	Gizli değerin kayıtlı olup olmadığı. Gizli değerin kendisi hiçbir zaman döndürülmez
integration.connection.headers	array	Her istekle gönderilen sabit başlıklar; açık metin olarak döner
integration.connection.headers[].name	string	Başlık adı
integration.connection.headers[].value	string	Başlık değeri
integration.summary_cache_ttl_seconds	integer	Hesaplanan özetin saniye cinsinden önbellekte tutulma süresi. 0 platform varsayılanı demektir
integration.default_summary_cache_ttl_seconds	integer	Platformun varsayılan özet önbellek süresi (43200, 12 saat)
created_at	string	Oluşturulma zamanı (ISO 8601)
updated_at	string	Son güncelleme zamanı (ISO 8601)

Hatalar

Durum	Kod	Açıklama
400	10000	oracle_id geçerli bir 24 karakterlik hex ID değil (bu endpoint hatalı biçimli ID'yi 10016 yerine genel kodla bildirir)
400	10001	Oracle bulunamadı ya da silinmiş (domain 5)

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