Oracle Metriğini Güncelle

Bir metrik sağlayıcısının düzenlenebilir alanlarını değiştirir; ID'si ve created_at değeri korunur. Oracle Metriği 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/oracle-metrics/{oracle_metric_id}

Parametreler

Ad	Tip	Konum	Açıklama
oracle_metric_id	string	path	Zorunlu. Metrik sağlayıcısı 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	Sağlayıcının ait olduğu kategori (24 karakterlik hex ID). Var olup olmadığı kontrol edilmez
type	string	Evet	Kaynak tipi: TOGG ya da SHEET
name	string	Evet	Sağlayıcı adı
description	string	Hayır	Açıklama. Gönderilmezse silinir
fiat_currency	string	Evet	Kaynağın kira gelirinin para biriminin ISO 4217 kodu
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	Sağlayıcını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

Örnek

curl --request PUT \
  --url '{{baseUrl}}/v2/admin/oracle-metrics/6a5d0206379ebd02e53bf1a1' \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "category_id": "6a5d0206379ebd02e53bf0df",
    "type": "SHEET",
    "name": "Togg Şarj İstasyonu Metric Sheet",
    "description": "Google Sheets üzerinden yönetilen Togg şarj istasyonu token metrikleri",
    "fiat_currency": "TRY",
    "codes": [
      { "code": "TOGG1", "name": "Togg Şarj İstasyonu 1" },
      { "code": "TOGG2", "name": "Togg Şarj İstasyonu 2" }
    ],
    "connection": {
      "url": "https://docs.google.com/spreadsheets/d/1Q9xWmT4kLp7RzV2sN8bYc3HdF6gJ0aEu5iO/export?format=csv&gid=0",
      "timeout": 30,
      "cache_ttl_seconds": 60,
      "auth": { "type": "NONE" },
      "headers": []
    }
  }'

Yanıt

Güncellenen sağlayıcıyla birlikte 200 OK; yapı Oracle Metriğini Getir sayfasında açıklanmıştır.

{
  "id": "6a5d0206379ebd02e53bf1a1",
  "category_id": "6a5d0206379ebd02e53bf0df",
  "type": "SHEET",
  "name": "Togg Şarj İstasyonu Metric Sheet",
  "description": "Google Sheets üzerinden yönetilen Togg şarj istasyonu token metrikleri",
  "integration": {
    "codes": [
      { "code": "TOGG1", "name": "Togg Şarj İstasyonu 1" },
      { "code": "TOGG2", "name": "Togg Şarj İstasyonu 2" }
    ],
    "fiat_currency": "TRY",
    "connection": {
      "url": "https://docs.google.com/spreadsheets/d/1Q9xWmT4kLp7RzV2sN8bYc3HdF6gJ0aEu5iO/export?format=csv&gid=0",
      "timeout": 30,
      "cache_ttl_seconds": 60,
      "auth": {
        "type": "NONE",
        "name": "",
        "username": "",
        "secret_set": false
      },
      "headers": []
    }
  },
  "created_at": "2026-07-19T16:57:42.876Z",
  "updated_at": "2026-11-09T10:44:03.517Z"
}

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_metric_id geçerli bir 24 karakterlik hex ID değil
400	10001	Metrik sağlayıcısı bulunamadı ya da silinmiş (domain 53)
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.