Oracle'ı Güncelle

Bir fiyat oracle'ının düzenlenebilir alanlarını değiştirir; ID'si ve created_at değeri korunur. Oracle Oluştur sayfasındaki gibi kaydın tamamını gönderin.

Kimlik doğrulama gizli değeri hiçbir zaman döndürülmez; bu yüzden kaydı okuyup geri gönderen bir istemcinin gönderecek gizli değeri yoktur. connection.auth.secret diğer alanlardan bu nedenle farklı davranır:

• gönderilmezse ya da null ise kayıtlı gizli değer korunur;
• bir metin gönderilirse onun yerine geçer;
• auth.type: "NONE" gizli değeri siler.

Kayıtlı bir gizli değer yalnızca kaydedildiği köke (şema, host ve port) gönderilir. Kayıtlı gizli değeri koruyarak connection.url değerini başka bir köke yönlendiren güncelleme, connection.auth.secret alanını belirten 10015 ile reddedilir: gizli değeri yeniden gönderin.

Gerekli izin: oracle:update

İstek

PUT /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>
Content-Type	Zorunlu. application/json

Gövde

Alan	Tip	Zorunlu	Açıklama
category_id	string	Evet	Oracle'ın ait olduğu kategori (24 karakterlik hex ID). Var olup olmadığı kontrol edilmez
type	string	Evet	Kaynak tipi: TEFAS, TOGG ya da SHEET
name	string	Evet	Oracle adı
description	string	Hayır	Açıklama. Gönderilmezse silinir
fiat_currency	string	Evet	Kaynağın fiyatladığı para biriminin ISO 4217 kodu (ör. TRY)
codes	array	Hayır	Serilerin tam listesi; kayıtlı listenin yerine geçer. Gönderilmezse liste silinir
codes[].code	string	Evet	Kaynağın seriyi tanıdığı kod
codes[].name	string	Evet	Serinin görünen adı
codes[].description	string	Hayır	Serinin açıklaması
connection	object	Evet	Oracle'ın okuduğu yer
connection.url	string	Evet	Kaynağın http:// ya da https:// ile başlayan temel URL'si
connection.timeout	integer	Hayır	Saniye cinsinden istek zaman aşımı, 0–300. 0 varsayılan değer (30) demektir
connection.cache_ttl_seconds	integer	Hayır	Tek bir sunucu sürecindeki kaynak belge önbellek süresi, 0–86400. 0 kapatır
connection.auth.type	string	Hayır	NONE, BEARER, API_KEY, BASIC ya da QUERY_PARAM. Gönderilmezse NONE
connection.auth.name	string	Koşullu	Başlık ya da query parametresi adı. API_KEY ve QUERY_PARAM için zorunlu
connection.auth.username	string	Koşullu	BASIC için zorunlu
connection.auth.secret	string | null	Hayır	Gönderilmezse ya da null ise kayıtlı gizli değer korunur; bir metin onun yerine geçer
connection.headers	array	Hayır	Sabit başlıklar; açık metin olarak saklanır ve döndürülür
connection.headers[].name	string	Evet	Başlık adı
connection.headers[].value	string	Hayır	Başlık değeri
summary_cache_ttl_seconds	integer	Hayır	Özet önbellek süresi, 0–2592000 saniye. 0 platform varsayılanı demektir

Örnek

curl --request PUT \
  --url '{{baseUrl}}/v2/admin/oracles/677ed6e3cc111aea14a3dfc3' \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "category_id": "677ed6e3cc111aea14a3dfb4",
    "type": "TEFAS",
    "name": "Gümüş Fonu",
    "description": "TEFAS Gümüş Fonu",
    "fiat_currency": "TRY",
    "codes": [
      { "code": "IOG", "name": "Gümüş Fonu" },
      { "code": "GTZ", "name": "Gümüş Fonu" }
    ],
    "connection": {
      "url": "https://tefas-api.p.rapidapi.com",
      "timeout": 30,
      "cache_ttl_seconds": 0,
      "auth": { "type": "API_KEY", "name": "x-rapidapi-key", "secret": null },
      "headers": [
        { "name": "x-rapidapi-host", "value": "tefas-api.p.rapidapi.com" }
      ]
    },
    "summary_cache_ttl_seconds": 3600
  }'

Yanıt

Güncellenen oracle ile birlikte 200 OK; yapı Oracle'ı Getir sayfasında açıklanmıştır.

{
  "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" }
    ],
    "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": 3600,
    "default_summary_cache_ttl_seconds": 43200
  },
  "created_at": "2024-01-01T00:00:00Z",
  "updated_at": "2026-11-09T10:31:47.902Z"
}

Hatalar

Durum	Kod	Açıklama
400	10015	Doğrulama başarısız — details alanına bakın. URL, kayıtlı gizli değer korunarak başka bir köke taşındığında da connection.auth.secret alanını belirterek döner
400	10000	oracle_id geçerli bir 24 karakterlik hex ID değil
400	10001	Oracle bulunamadı ya da silinmiş (domain 5)
400	-1	Bağlantı eksik: URL http:// ya da https:// ile başlamıyor veya kimlik doğrulama şemasının name, username ya da secret değeri eksik

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