Oracle Metriği Oluştur

Bir metrik sağlayıcısı kaydeder. Her sağlayıcı kendi connection bilgisini taşır: sağlayıcı tipi bir endpoint anlamına gelmez.

Bağlantı kaydedilmeden önce eksiksiz olup olmadığı kontrol edilir (http:// ya da https:// ile başlayan bir URL ve kimlik doğrulama şemasının gerektirdiği ad, kullanıcı adı ya da gizli değer). Bu aşamada kaynağa istek gönderilmez; önce Oracle Metrik Bağlantısını Test Et ile deneyin.

connection.auth.secret yalnızca yazılabilir: saklanır, hiçbir zaman döndürülmez; yanıt yalnızca secret_set bilgisini verir.

Gerekli izin: oracle:create

İstek

POST /v2/admin/oracle-metrics

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
fiat_currency	string	Evet	Kaynağın kira gelirinin para biriminin ISO 4217 kodu (ör. TRY)
codes	array	Hayır	Bu sağlayıcının okuyabildiği seriler
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	Alınan kaynak belgenin tek bir sunucu sürecinde yeniden kullanılma süresi, 0–86400. 0 bu önbelleği kapatır
connection.auth	object	Hayır	Kaynağa kimlik doğrulama biçimi. Gönderilmezse NONE
connection.auth.type	string	Hayır	NONE (herkese açık kaynak), BEARER (Authorization: Bearer <secret>), API_KEY (name adlı başlıkta gizli değer), BASIC (username + gizli değer) ya da QUERY_PARAM (name adlı query parametresinde gizli değer)
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	Koşullu	Bearer token, API anahtarı ya da basic parolası. NONE dışındaki her şema için zorunlu; NONE için yok sayılır
connection.headers	array	Hayır	Her istekle gönderilen sabit başlıklar. Açık metin olarak saklanır ve döndürülür; buraya kimlik bilgisi koymayın
connection.headers[].name	string	Evet	Başlık adı
connection.headers[].value	string	Hayır	Başlık değeri

Örnek

curl --request POST \
  --url '{{baseUrl}}/v2/admin/oracle-metrics' \
  --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", "description": "İstanbul Ataşehir hızlı şarj istasyonu" }
    ],
    "connection": {
      "url": "https://docs.google.com/spreadsheets/d/1Q9xWmT4kLp7RzV2sN8bYc3HdF6gJ0aEu5iO/export?format=csv&gid=0",
      "timeout": 30,
      "cache_ttl_seconds": 300,
      "auth": { "type": "NONE" },
      "headers": []
    }
  }'

Yanıt

Yeni sağlayıcıyla birlikte 201 Created; yapı Oracle Metriğini Getir sayfasında açıklanmıştır.

{
  "id": "6911b6f1e4b0f51d2c8a7e63",
  "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" }
    ],
    "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-11-09T10:40:12.226Z",
  "updated_at": "2026-11-09T10:40:12.226Z"
}

Hatalar

Durum	Kod	Açıklama
400	10015	Doğrulama başarısız (zorunlu bir alan eksik, type TOGG ya da SHEET değil, connection.url bir URL değil, bir sayı aralık dışında, bilinmeyen auth.type) — details alanına bakın
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. Hangisi olduğunu message söyler

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