Oracle Metriğini Getir
Tek bir metrik sağlayıcısı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 sağlayıcı bulunamaz.
Gerekli izin: oracle:view
İstek
GET /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> |
Örnek
curl --request GET \
--url '{{baseUrl}}/v2/admin/oracle-metrics/6a5d0206379ebd02e53bf1a1' \
--header 'Authorization: Bearer <access_token>'
Yanıt
{
"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", "description": "İstanbul Ataşehir hızlı şarj istasyonu" },
{ "code": "TOGG2", "name": "Togg Şarj İstasyonu 2", "description": "Ankara Çankaya hızlı şarj istasyonu" }
],
"fiat_currency": "TRY",
"connection": {
"url": "https://docs.google.com/spreadsheets/d/1Q9xWmT4kLp7RzV2sN8bYc3HdF6gJ0aEu5iO/export?format=csv&gid=0",
"timeout": 30,
"cache_ttl_seconds": 300,
"auth": {
"type": "NONE",
"name": "",
"username": "",
"secret_set": false
},
"headers": []
}
},
"created_at": "2026-07-19T16:57:42.876Z",
"updated_at": "2026-07-19T16:57:42.876Z"
}
Yanıt Alanları
| Alan | Tip | Açıklama |
|---|---|---|
id | string | Metrik sağlayıcısı ID'si |
category_id | string | Sağlayıcının ait olduğu kategori |
type | string | Kaynak tipi: TOGG ya da SHEET (yayımlanmış bir tablo). TEFAS metrik sağlayıcısı yoktur |
name | string | Sağlayıcı adı |
description | string | Açıklama |
integration | object | Kaynak yapılandırması |
integration.codes | array | Bu sağlayıcının okuyabildiği seriler; her biri code ile adreslenir |
integration.codes[].code | string | Kaynağın seriyi tanıdığı kod |
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 kira gelirinin para biriminin ISO 4217 kodu (ör. TRY) |
integration.connection | object | Sağlayıcını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 |
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_metric_id geçerli bir 24 karakterlik hex ID değil (bu endpoint hatalı biçimli ID'yi 10016 yerine genel kodla bildirir) |
| 400 | 10001 | Metrik sağlayıcısı bulunamadı ya da silinmiş (domain 53) |
Hata biçimi ve ortak kodlar için Hatalar sayfasına bakın.