← Dokümanlar

API

Projelerini, grafiklerini ve haritalarını başka bir uygulamadan okumak, yeni proje, grafik ve harita oluşturmak ve anahtarla oluşturduklarını güncellemek: kimlik, uç noktalar, istek ve yanıt biçimi, hata kodları, hız sınırı ve OpenAPI belgesi.

Son doğrulama: 2026-11-01 · 1 gün önce

Tuvelia API'si, başka bir uygulamanın (ör. bir WordPress eklentisinin ya da
kendi betiğinin) projelerini, grafiklerini ve haritalarını okumasını, yeni
proje, grafik ve harita oluşturmasını ve bir anahtarla oluşturduğu grafiklerin
ve haritaların verisini ve ayarlarını değiştirmesini sağlar. API ile hiçbir şey silinmez ve yayınlanmaz: yayın her
zaman Tuvelia'da, elle yapılır.

API şu an önizlemede. Tuvelia'nın kendi WordPress eklentisi yayınlanana
kadar uçlar ve alanlar değişebilir; alan kaldırmak ve ad değiştirmek de buna
dahildir. Her değişiklik, tarihiyle birlikte bu sayfanın sonundaki
Değişiklik günlüğü bölümüne yazılır. Önizleme bitince sürüm kuralı
yürürlüğe girer ve v1 içinde yalnız ekleme yapılır.

Kimlik

Her istek bir API anahtarı taşır. Anahtarı Hesap › API anahtarları
sayfasında oluşturursun (API anahtarları) ve
isteğe şu başlıkla eklersin:

Authorization: Bearer tuv_pat_…

Anahtar, oluşturan hesabın verisini okur ve yazar; başka bir hesabın projesini
göremez. Sözleşmenin tanıdığı tek kimlik yöntemi API anahtarıdır.

Uç noktalar

Bütün adresler https://tuvelia.com/api/v1 ile başlar.

İstekNe yapar
GET /projectsProjelerin, en yenisi önce: kimlik, ad, oluşturulma zamanı. Sayfa sayfa gelir (aşağıda Sayfalama).
POST /projectsYeni, boş bir proje oluşturur.
GET /projects/{projectId}/chartsProjedeki grafikler, editördeki sırayla, sayfa sayfa. Veri ve ayar gelmez; yayındaki grafik gömme adresleriyle gelir.
POST /projects/{projectId}/chartsProjeye yeni grafik ekler.
GET /charts/{chartId}Grafiğin verisi (tablo) ve görünüm ayarları.
PATCH /charts/{chartId}Grafiğin ayarlarını gönderdiğin alanlarla birleştirir; stil ya da tip değişince bağlı ayarlar da yazılır (aşağıda Grafiği güncellemek).
PUT /charts/{chartId}/dataGrafiğin verisini baştan yazar; ayarlar değişmez (iki istisna: bozulan dumbbell çifti ve tamamen bozulan dağılım eşlemesi yeniden kurulur).
GET /chart-templatesPOST .../charts gövdesindeki template alanına yazabileceğin başlangıç şablonları.
GET /chart-optionsAyarların listesi: adı, türü, ne işe yaradığı ve seçenekli olanlarda geçerli değerlerin tamamı. ?chartType=scatter ile o tipe özgü ayarlar da gelir.
GET /projects/{projectId}/mapsProjedeki haritalar, editördeki sırayla, sayfa sayfa. Veri ve ayar gelmez; yayındaki harita gömme adresleriyle gelir.
GET /maps/{mapId}Haritanın çizilen satırları, ham kaynağı ve ayarları.
GET /geographiesHaritaya altlık olabilecek coğrafyalar: config.geographyId alanına ne yazılabileceği.
GET /geographies/{geographyId}/scope-parentsO coğrafyada kapsam olarak seçilebilecek üst birimler, adıyla ve çizilecek bölge sayısıyla.
GET /region-presetsHazır çok ülkeli bölge listeleri (Baltık, AB-27, Balkanlar…).
GET /map-optionsHarita ayarlarının listesi: adı, türü, ne işe yaradığı ve seçenekli olanlarda geçerli değerlerin tamamı.
POST /projects/{projectId}/mapsProjeye yeni harita ekler (veri ayrı uçtan yazılır).
PATCH /maps/{mapId}Haritanın ayarlarını gönderdiğin alanlarla birleştirir; coğrafya değişince kapsam, projeksiyon ve veri de yeniden yazılır (aşağıda Harita oluşturmak ve veri yazmak).
PUT /maps/{mapId}/dataHaritanın verisini baştan yazar; bölge adlarını sunucu çözer.

Kimlikler UUID biçimindedir (ör. 3f2b8c1e-5a4d-4e6f-9b7a-1c2d3e4f5a6b).
Coğrafya kimlikleri bunun DIŞINDADIR: onlar de-adm2 gibi kısa anahtarlardır.
Bu sürümde grafikler ve haritalar okunabilir ve yazılabilir. Hikâyeler listede
yer almaz.

Örnek:

curl -H "Authorization: Bearer tuv_pat_…" https://tuvelia.com/api/v1/projects
{
  "projects": [
    { "id": "3f2b8c1e-…", "name": "Haber grafikleri", "createdAt": "2026-09-02T12:00:00.000Z" }
  ],
  "truncated": false,
  "nextCursor": null
}

Zamanlar ISO 8601 biçiminde ve UTC'dir.

Sayfalama

Üç liste ucu (GET /projects, GET /projects/{projectId}/charts ve
GET /projects/{projectId}/maps) kayıtları sayfa sayfa verir. Bir sayfada
varsayılan olarak en çok 50 kayıt gelir; limit sorgu parametresiyle 1 ile
200 arasında bir sayı seçebilirsin.

Her liste yanıtı iki alan daha taşır:

  • truncated: bu sayfadan sonra kayıt var mı. true ise liste eksiktir.
  • nextCursor: sonraki sayfanın işareti. Liste bittiyse null.

Devamını almak için nextCursor değerini cursor sorgu parametresiyle aynı
uca gönder:

curl -H "Authorization: Bearer tuv_pat_…" \
  "https://tuvelia.com/api/v1/projects?limit=50&cursor=djF8cHJvamVjdHN8…"

truncated: false gelene kadar sürdür. İşaret opaktır: içeriğini ayrıştırma,
olduğu gibi geri gönder. İşaret son gördüğün kayıttan devam eder; sayfalar
arasında listeye yeni bir kayıt eklense de aynı kayıt iki kez gelmez. İşaretin
gösterdiği kayıt bu arada silinmişse ya da işaret başka bir listeye aitse
istek 400 invalid_request döner; o zaman listeyi cursor göndermeden baştan
iste. limit 1 ile 200 arasında bir tamsayı değilse de 400 döner.

Yayındaki grafiği ya da haritayı gömmek

Grafik ve harita yanıtlarında, listede de tek öğe okumasında da, yayındaki
öğenin published alanı doludur; yayında olmayan öğede bu alan nulldır.
published.urls üç adres taşır:

  • live: etkileşimli, canlı çizim. <iframe> ile gömmek için budur; ipucu
    kutuları ve zaman imleci çalışır. Her zaman doludur.
  • page: grafiğin tek başına açılan sayfası. null olabilir.
  • svg: grafiğin durağan görüntüsü. null olabilir.

page ve svg durağan görüntüye dayanır. Bir yayında durağan görüntü yoksa bu
iki adres çalışmaz; API o durumda adres uydurmaz, null döner. Programın bu
ikisini kullanmadan önce dolu olup olmadığına bakmalı; live her yayında
çalışır.

Hazır gömme kodu (oEmbed). live adresini kendin <iframe>e koymak
yerine oEmbed ucundan hazır kodu alabilirsin. Kod Tuvelia'daki Paylaş ›
Bağlantı ve embed
penceresinin verdiğiyle aynıdır: oranı doğrudur, zamanlı
öğede imleç şeridine yer açar, telefonda kutuyu uzatır. Bu uç anahtar istemez,
yalnız yayındaki içeriği verir:

GET https://tuvelia.com/oembed?url=https://tuvelia.com/embed/{publicId}/live&format=json

Yanıt oEmbed biçimindedir (type: "rich", html, width, height, title).
url olarak /embed/{publicId} adresini de verebilirsin. İsteğe bağlı
maxwidth ve maxheight yalnız bildirilen ölçüyü küçültür; kodun kendisi
zaten sayfanın genişliğine uyar. WordPress gibi oEmbed tanıyan sistemler bu
ucu gömme sayfasındaki keşif bağlantısından da bulur.

Yayındaki görüntü, öğe Tuvelia'da yeniden yayınlanana kadar değişmez. API ile
verisini değiştirdiğin bir grafik ya da harita da öyledir: yeni veri, öğeyi
Tuvelia'da yeniden yayınladığında görünür. published.stale bunu söyler:
true ise öğede yapılan değişiklikler gömülü görüntüde henüz görünmüyor. API
yayınlayamaz; kullanıcının Tuvelia'da Yeniden yayınla demesi gerekir.

Grafiğin içeriği

GET /charts/{chartId} yanıtında data tablo biçimindedir: headers sütun
başlıklarıdır (ilki kategori sütunu), rows satırlardır. Her hücre METİN
olarak gelir, sayılar da; boş hücre "ölçüm yok" demektir, sıfır değil.

⚠ Ondalık ayırıcı NOKTADIR ("64.8"). Virgüllü yazım ("64,8") sayı
sayılmaz: o hücre sıfır olarak çizilir ve grafik boş görünebilir. Sayıların
ekranda nasıl yazılacağı ayrı bir ayardır (grafik ayarlarındaki sayı biçimi);
gönderdiğin veriyi etkilemez.

title grafiğin Tuvelia'daki adıdır, yani proje listesinde gördüğün ad.
Grafiğin üstünde görünen başlık bu değil, config.title alanıdır; ikisi
farklı olabilir.

config grafiğin görünüm ayarlarıdır: grafik tipi (chartType), renkler,
eksenler, notlar, künye. Ayar alanları zamanla çoğalır; tanımadığın alanları
yok say.

config içinde neye söz veriliyor. Sürüm kuralı config nesnesinin
tamamını değil, şu alanları kapsar: chartType, title, subtitle,
sourceName, sourceLink. Nesnedeki diğer ayarlar Tuvelia'nın iç ayarlarıdır:
okuyabilir ve geri yazabilirsin, ama haber verilmeden değişebilirler.
Programını onlara bağlama.

Yanıtta üç alan daha vardır:

  • version: içerik sürümü. Veri ya da ayar her değiştiğinde artar.

  • apiManaged: grafiğin bir API anahtarıyla oluşturulmuş olduğunu söyler;
    alanın anlamı budur. Bugünkü kural gereği anahtar yalnız true olan
    grafikleri değiştirebilir. Grafik listesinde de bu alan vardır.

  • warnings: verinin bir kısmı çizilmiyorsa ya da grafik çizilip okunamıyorsa
    uyarılar, yoksa boş dizi. Örneğin
    ağaç haritası boş, sıfır ya da eksi değerli satırları çizemez; yarış aynı anda
    sınırlı sayıda varlık gösterir. Her uyarı bir code, çizilmeyenlerin sayısı
    (count) ve Türkçe bir açıklama (message) taşır. Veri silinmez, yalnız
    çizilmez.

    En önemlisi nothing_drawn: grafiğin hiçbir öğesi çizilmiyor demektir.
    Yarış zaman bağlaması (config.temporal), süre çizelgesi başlangıç sütunu
    (config.timeline.startColumn) olmadan boş çizilir; uyarı hangi ayarın eksik
    olduğunu ve varsa hangi template ile hazır kurulacağını söyler. Dağılım ve
    ağaç haritası eşlemeyi tablodan kendisi türetir; ancak türetecek sayı sütunu
    yoksa (dağılımda ölçü çifti, ağaç haritasında büyüklük sütunu) boş çizilir. Süre çizelgesinde eşleme
    doğru olduğu hâlde hiçbir olayın başlangıç tarihi kullanılamıyorsa da gelir;
    o zaman mesaj tarihi söyler ve satırları yanındaki timeline_invalid_dates
    sayar. Tablodaki satırların hepsi tamamen boşsa mesaj bunu söyler ve
    yanında timeline_invalid_dates gelmez (tamamen boş satır olay sayılmaz).
    Dağılımda gizlenen seriler (config.hiddenSeries) bütün noktaları
    düşürüyorsa da gelir: bir nokta x ve y serisini birlikte kullanır, biri
    gizliyse çizilmez; mesaj nedenin gizleme olduğunu söyler. Yarışta gizlenen
    seriler yüzünden görünen hiçbir varlığın ölçümü kalmadığında (görünenlerin
    hücreleri boş, sıfır ya da sayı değil) ve piramidin yüzde biçiminde
    (diverging.valueMode: "percentOfTotal") yüzdesi hesaplanabilen kategori
    yokken (her kategoride bir kanat boş ya da sayı değil, ya da iki kanadın
    toplamı sıfır veya eksi) de gelir. Kısacası grafiğin yerinde nedeni yazan
    boş durum yazısı çıktığı her durumda gelir: değer hücrelerinin hepsi boş,
    sıfır ya da sayı olarak okunamıyorken, ölçümler yalnız gizlenen serilerde ya
    da kategorilerdeyken (config.hiddenSeries · config.hiddenCategories; pastada
    pozitif değerler yalnız gizlenen kısımdayken de), tabloda değer sütunu
    yokken, piramidin kanatları çözülemiyorken, yarışta gösterilecek varlık,
    dağılımda çizilecek nokta ya da ağaç haritasında pozitif değer yokken, pastada
    pozitif değer yokken (eksi ve sıfır değer dilim açmaz), yarışta pozitif değer
    yokken (eksi ve sıfır değer çubuk açmaz; görünen varlıklar eksi, pozitif
    değerler yalnız gizlenen varlıklardayken mesaj gizlemeyi söyler), tek pastanın
    (pie.mode: "single") çizdiği ilk görünür seride pozitif değer yokken (öteki
    seriler dolu olsa da), pastada kategori o kadar çok ki dilimlerin arasındaki
    boşluk bütün daireyi kaplıyor ve hiçbir dilim çizilemiyorken (eşit değerlerde
    tek pastada ve ızgarada halkalıysa 281, halkasızsa 629 kategoriden; iç içe
    pastada halkalıysa yaklaşık 495, halkasızsa 523 kategoriden itibaren),
    dumbbell'de başlangıç ve bitiş serisi eşlenemiyorken ya da hiçbir çiftin iki
    ucu birlikte sayı değilken de —
    mesaj grafiğin neden boş olduğunu söyler. Grafik çiziliyorsa gelmez. Her
    zaman listenin en önündedir; öteki uyarılar (ör. empty_cells) arkasından
    gelir. Bu uyarıyı gördüğünde grafik oluşturma isteği başarılı olmuştur ama
    grafik boştur; yanında bir görsel uyarı (ör. legend_hidden) da varsa önce
    boşluğu düzelt.

    İki uyarı sayı biçimiyle ilgilidir: comma_decimal_cells, virgüllü ondalık
    taşıyan ("12,5") ve bu yüzden sıfır çizilen hücreleri sayar;
    formatted_number_cells ise birim işareti ("%12,5", "₺1.024,5",
    "1.250 TL") ya da boşluklu binlik ("85 372 377") taşıyan hücreleri. Bir
    hücre ikisinden yalnız birinde sayılır. Veri yazarken hücrede yalnız sayı
    olur ve ondalık ayırıcı noktadır; birimi config.valuePrefix ya da
    config.valueSuffix ile gösterirsin. Bu uyarılardan birini görüyorsan
    gönderdiğin sayılar grafikte görünmüyor demektir. Üçüncüsü text_cells:
    sayı olmayan düz metin ("abc", "12 milyon", "n/a") taşıyan değer
    hücreleri — çubuk, çizgi, alan, yığın ve pastada sıfır çizilir, piramit ve
    dumbbell'de boş hücre gibi çizilmez. Bu yedi tipte, empty_cells ile aynı
    hücrelerde sayılır; ölçüm yoksa hücreyi boş bırak (boş hücre çizilmez). Yarışta
    ve dağılımda da sayılır — yarışta metin o dönemin 0 ölçümüdür (çubuk sıfıra
    iner), dağılımda nokta o eksende 0'a çizilir; süre çizelgesinde önem sütunundaki
    (timeline.weightColumn) metin önemi 0 yapar. Bu üç tipte çizimin okuduğu
    hücreler sayılır. Ağaç haritasında metin treemap_invalid_rows ile sayılır. Bir
    hücre üç koddan yalnız birinde sayılır.

    Yarışta race_negative_cells, eksi değerleri sayar: yarış yalnız pozitif
    değere çubuk çizer (değer ekseni sıfırdan başlar), eksi değerli varlığın o
    dönemdeki çubuğu çizilmez — adı sıralamanın sonunda kalır. count eksi değer
    sayısıdır (gizlenmeyen varlıkların, zamanı okunan satırlarındaki değerler);
    message eksi değerli varlıkları (en çok üçünü) adıyla ve değer sayısıyla
    sayar. Görünen varlıkların hiçbir dönemde pozitif değeri yoksa yanında
    nothing_drawn da gelir. Eksi değerleri göstermek için chartType: "bar"
    eksi değeri sıfırın öbür yanına çizer. Kod race_over_limitin ardından gelir.

    Pastada pie_negative_cells, eksi değerleri sayar: pasta yalnız pozitif
    değere dilim açar, eksi değerin dilimi çizilmez ve paylara girmez. count eksi
    değer sayısıdır — pastanın çizdiği serilerin görünen satırlarındaki değerler:
    tek pastada (pie.mode: "single") yalnız ilk görünür seri (çizilmeyen serileri
    pie_series_not_drawn söyler), iç içe ve ızgarada görünen bütün seriler;
    gizlenen seri ve kategori sayılmaz. message eksi değerli dilimleri (en çok
    üçünü) kategori adıyla sayar. Pozitif değer kalmadıysa yanında nothing_drawn
    da gelir. Kod race_negative_cellsin ardından, görsel uyarılardan önce gelir.

    Süre çizelgesinde timeline_invalid_dates, tarihi kullanılamayan olayları
    sayar: başlangıcı boş ya da tarih değilse ya da bitişi başlangıcından önceyse
    olay çizilmez; bitişi tarih değilse bant yerine nokta çizilir. Tarihler
    "1969", "1969-07" ya da "1969-07-20" biçimindedir; boş bitiş (ya da
    "-") nokta olaydır ve uyarı vermez. count olay sayısıdır; message ilk
    üçünü adı, satır numarası (1'den) ve hücredeki değerle sayar.

    timeline_missing_columns, süre çizelgesinin bir sütun rolü
    (config.timeline içindeki startColumn · endColumn · laneColumn ·
    colorColumn · weightColumn) tabloda olmayan bir sütun adını gösterdiğinde
    gelir. PUT /charts/{chartId}/data ayarlara dokunmadığı için, bir sütunun
    adı değişmiş ya da sütun kalkmışsa rol eski adda kalır ve yok sayılır:
    başlangıçta olay çizilmez, bitişte bant yerine nokta, şeritte tek şerit,
    renkte şerit rengi çizilir. count bayat rol sayısıdır; message rolü ve
    sütun adını sayar. Düzeltmek için timeline nesnesini tablodaki sütun
    adlarıyla yeniden gönder (nesne bütün olarak yazılır).

    missing_columns aynı durumun öteki ayarlar için söylenişidir: ağaç
    haritasının bir rolü (config.treemap içindeki labelColumn · valueColumn
    · groupColumn) ya da zaman bağlaması (config.temporal.column — yalnız ilk
    sütun olabilir) tabloda olmayan bir sütun adını gösterir. Ayar yok sayılır:
    kutu adları ilk sütundan, büyüklük ilk sayı sütunundan alınır (yıl ya da
    tarih gibi okunan sütun yalnız başka sayı sütunu yoksa), kutular
    gruplanmaz; zaman bağlamasında imleç ve zaman ekseni çizilmez. Ayar çizime
    girmiyorsa (ağaç haritasının dönem okumasında, zaman imleci çizmeyen bir tipte)
    uyarı gelmez. count bayat ayar sayısıdır; message ayarı ve sütun adını
    sayar. Düzeltmek için treemap ya da temporal nesnesini tablodaki sütun
    adıyla yeniden gönder ya da alanı çıkar (nesne bütün olarak yazılır).

    Aynı kod dumbbell ve piramitte de gelir. Bir dumbbell çiftinin serisi
    (config.dumbbell.pairs[] içindeki start · end) tabloda yoksa o çift
    çizilmez (hiç çift kalmazsa grafik boştur); message çifti grup adıyla sayar,
    count bayat çift sayısıdır. Piramidin bir kanadı (config.diverging içindeki
    leftSeries · rightSeries) tabloda yoksa kanatlar seri adlarından yeniden
    türetilir — yön ters dönebilir, türetilemezse grafik çizilmez; message
    türetilen kanatları ya da çizilmediğini söyler. Kategori sırasında
    (config.diverging.categoryOrder) tabloda olmayan bir satır adı atlanır ve
    sırada olmayan satırlar sona eklenir. Düzeltmek için dumbbell ya da
    diverging nesnesini tablodaki adlarla yeniden gönder.

    Süre çizelgesinde timeline_unlabeled_events, satır tavanı dolduğu için adı
    yazılmayan olayları sayar: bir şeritte en çok timeline.maxRows (varsayılan ve
    en çok 12) satır yığılır, sığmayan olay çizilir ama şeridin tabanında adsız
    kısa bir çizgi olarak kalır. Bu sayı çizimin genişliğine bağlıdır; count
    tek bir referans genişlikteki sayıdır — görselin, PDF'in ve statik gömmenin
    çizim genişliği: boyut otomatikse 636 px, sabit chartWidthte genişlik − 64,
    800'ü aşan sabit genişlik ve sabit yükseklikte 736 (800'de yerleşir). message
    bu genişliği yazar. Canlı gömme, editör ve video kendi genişliğinde çizer; dar
    ekranda genellikle daha çok olayın adı yazılmaz. Adının iki karakteri bile
    sığmadığı için hiç yazılmayan olay ve canlı gömmede seyreltilen ad bu sayıya
    girmez. Azaltmak için daha geniş bir boyut, daha kısa olay adları ya da
    timeline.laneColumn ile şeritler (her şerit kendi satırlarını alır);
    timeline.maxRows 12'den küçükse büyütmek. Kod veri uyarılarının sonunda,
    missing_columnsın ardından gelir.

    Beş uyarı görseldir: grafik çizilir ama bir kısmı görünmez ya da okunamaz.
    Grafiği göremeyen bir program (ör. bir yapay zekâ ajanı) bunu yalnız bu
    uyarılardan öğrenir.

    • pie_series_not_drawn — pasta tek seri modunda (pie.mode: "single",
      varsayılan) yalnız ilk görünür seriyi çizer; count çizilmeyen seri
      sayısıdır. Hepsi için pie.mode nested ya da grid olur; tek seri
      isteniyorsa ötekiler hiddenSeries ile gizlenir.
    • single_color_series — colorMode: "single" renkle ayrılan öğeleri aynı
      renge boyuyor: çok serili çubuk, çizgi, alan ve yığında seriler, dumbbell'de
      iki dönem, iç içe ya da ızgara pastada ve dilim etiketi kapalı
      (showLabels: false) tek pastada kategoriler. Düzeltmesi colorMode
      preset ya da custom (tek pastada showLabels: true da yeter).
    • legend_hidden — lejant kapalı ve renklerin neye karşılık geldiği grafikte
      başka hiçbir yerde yazmıyor: aynı tipler, piramidin kanatları, dilim etiketi
      kapalı tek pasta, renk kategorili (timeline.colorColumn) süre çizelgesi ve
      ağaç haritasında grup başlığı kutusuna sığmayan gruplar (count o grupların
      sayısıdır; başlık otomatik boyutun en geniş hâlinde — 700 × 320 — ya da
      verdiğin chartWidth/chartHeight ile ölçülür). Düzeltmesi config.legend
      içinde visible: true; tek pastada showLabels: true da yeter. Bu uyarının
      kapsadığı her grafik lejant açık doğar (aşağıda "Proje ve grafik
      oluşturmak"); bu uyarıyı lejantı kendin kapattığında ya da grafik sonradan
      bu duruma geldiğinde (ör. sonradan çok serili olduğunda) görürsün.
    • duplicate_colors — tek renk seçilmediği hâlde renkle ayrılan öğelerden
      bazıları aynı renge düşüyor: hazır paletin (colorPreset) beş rengi altıncı
      öğeden itibaren baştan döner; customColorsta aynı renk iki kez geçer ya da
      liste öğe sayısından kısa kalır (eksik renkler varsayılan palete düşer, iç
      içe pastada liste halkada başa döner). count renk paylaşan öğe sayısıdır,
      mesaj kimin kiminle aynı renkte olduğunu yazar. Kapsam single_color_series
      ile aynı öğelerdir; ek olarak renk kategorili süre çizelgesi ve ağaç
      haritasında renk paylaşan gruplardan birinin başlığı sığmıyorsa gruplar.
      Renkler birebir karşılaştırılır (büyük/küçük harf ve #abc kısa yazımı fark
      etmez; "benzer" tonlar sayılmaz). Düzeltmesi colorMode: "custom" ve öğe
      sayısı kadar FARKLI renkli customColors, ya da daha az öğe. colorMode: "single" bu kodu değil single_color_seriesı verir. Pastada bu üç uyarı
      (single_color_series · legend_hidden · duplicate_colors) yalnız dilim
      açan kategorileri sayar: değeri eksi, sıfır ya da sayı olmayan ve çizilen
      hiçbir halkada ya da pastada dilim açmayan kategori lejantta görünmez,
      uyarılara da girmez (boş hücreli kategori sayılmaya devam eder). Pozitif ama
      dilim boşluğundan dar değer (halkalı pastada 40 ve 60 yanında 0,03) de dilim
      açmaz; iç içe modda yalnız hiçbir halkada çizilemeyecek kadar küçük olan.
      İç içe pastada lejant halka başına bölümlüdür; duplicate_colors her halka
      bölümüne ayrı bakar (o halkada dilim açan kategoriler, o halkanın
      renkleriyle): renk paylaşımı yalnız aynı halkada sayılır, iki halkada
      paylaşan çift iki kez anılır ve count halka başına sayar. En az iki halka
      çiziliyorsa message her çiftin önüne halkasını lejanttaki başlıkla
      (grafiğin çıktı dilinde: "Dış halka" · "İç halka" · "2. halka") yazar ve
      sayının halka başına olduğunu söyler; yanıtın şekli aynıdır, halka ayrı bir
      alan olarak gelmez. Halkalar aynı customColors listesini kaydırarak
      kullandığı için messagein önerdiği renk sayısı halka başına değil
      kategori sayısıdır (her seride boş kalan ara kategori de listede yer tutar):
      o kadar FARKLI renk hiçbir halkada paylaşım bırakmaz.
    • point_names_hidden — dağılımda nokta adları kapalı (scatter.showNames: false). Dağılımda lejant yoktur; noktanın hangi varlık olduğunu (noktalar
      renkliyse hangi rengin kim olduğunu da) yalnız ad söyler, ad kapalıyken
      grafikte hiçbir yerde yazmaz. count adı yazılmayan nokta sayısıdır
      (gizlenen seriler ve ölçüsü boş noktalar sayılmaz). Grafikte en az iki nokta
      yoksa ya da noktaların adı yoksa gelmez. Düzeltmesi scatter.showNames: true; config.legend bu tipte çizilmez. ⚠ scatter iç içe nesnesi bütün
      yazılır — eşlemeyi korumak için entities, rowsAre ve öteki alanlarını da
      gönder.

    Görsel uyarılar gizlenen serileri saymaz; tek serili grafikte (değer etiketi
    açık tek pasta dahil), çoklu grafiğin panellerinde ve öğenin adını kendi yanında
    yazan tiplerde (yarış, adları açık dağılım, renk kategorisi olmayan ya da şerit/olay adı
    sütunundan gelen süre çizelgesi, düz ya da bütün grup başlıkları sığan ağaç
    haritası) çıkmaz. Yazımı reddetmezler, çizimi değiştirmezler.

Haritanın içeriği

GET /maps/{mapId} yanıtında veri iki biçimde gelir ve aradaki fark önemlidir:

  • rawRows — haritanın ham kaynağı: { "input": "Ankara", "value": "806.2" }.
    Bölge adı yazıldığı gibi durur ve coğrafyada karşılığı bulunamayan satırlar da
    buradadır
    .
  • data — haritada gerçekten çizilen satırlar: { "id": 6, "value": 806.2, "label": "Ankara" }. Bölge adı coğrafyanın sayısal kimliğine çözülmüştür.

Eşleşmeyen bir satır rawRowsta vardır ama datada yoktur. Bu yüzden veriyi
okuyup değiştirmek istersen rawRowsu temel al: datadan türetip geri
yazmak, eşleşmeyen satırları sessizce silerdi.

Zamanlı haritalarda her satırda bir at alanı bulunur:
{ "precision": "year", "iso": "1985" }. isonun biçimi precisiona bağlıdır
(year → 1985, month → 1985-03, day → 1985-03-17). Yıllık bir veriyi
1985-01-01 diye yazmak, eksende olmayan bir gün kesinliği uydurur.

config haritanın ayarlarıdır. Sözleşmenin kapsadığı alanlar geographyId
(hangi coğrafya), view (kapsam), meta (künye) ve temporal (zaman beyanı);
diğerleri Tuvelia'nın iç ayarlarıdır.

Harita coğrafyaları ve kapsam

Bir haritanın altlığı config.geographyId ile seçilir. Geçerli değerleri
GET /geographies listeler; her satır coğrafyanın adını, ait olduğu ülkeyi ve
idari düzeyini verir.

Katalog yüzlerce coğrafya taşır ve yanıt varsayılan olarak ilk 50 kaydı verir
(limit ile en çok 250); kırpıldığında truncated: true döner, total gerçek
sayıyı söyler. Aradığını bulmanın yolu qdur: GET /geographies?q=almanya
adında, ülke adında ya da kimliğinde bu metin geçen coğrafyaları verir.
Büyük/küçük harf, Türkçe karakter ve aksan fark etmez — turkiye, TÜRKİYE ve
Türkiye aynı sonucu verir, kibris Kıbrıs'ı, ISPANYA İspanya'yı bulur.
Ülkenin İngilizce ve tam Türkçe adı da aranır: germany Almanya'yı,
united states ve amerika ABD'yi bulur; yanıttaki adlar Türkçe kalır. Adı
tartışmalı bölgelerde (Kıbrıs, Kosova, Filistin) yalnız Tuvelia'daki ad aranır.
Bu, Tuvelia'daki Coğrafya panelinin Bölge ara kutusuyla aynı kuraldır. region
(bölge kimliği, ör. de) ve level (ör. adm2) ile de daraltabilirsin. q en
çok 100 karakterdir; q, region ve level boş gönderilemez — boş bir değer ya
da daha uzun bir q 400 invalid_request döner.

Katalogda olmayan bir geographyId — haritayı oluştururken, configte
değiştirirken ya da scope-parents yolunda — 400 invalid_request döner. Mesaj
bütün kimlikleri dökmez: aynı bölgedeki kimlikleri (bölge bulunamazsa birkaç
örnek kimliği), katalogdaki toplam sayıyı ve kimliği adından bulmak için
GET /geographies?q=<ad> aramasını söyler. Katalogda olmayan bir region de aynı
yanıtı alır: mesaj bölge kodlarının ilk on ikisini ve kaç tane daha olduğunu
yazar, kodu ülke adından q ile bulmanı söyler (her satırın region.id alanı
bölge kodudur). Bölge kodları küçük harfle yazılır; DE gönderirsen mesaj
doğrusunu (de) gösterir. region ile birlikte gönderdiğin level o bölgede
yoksa da 400 invalid_request döner ve mesaj o bölgenin düzeylerini yazar:
region=de&level=adm3 için adm0, adm1, adm2 (adm3 Almanya'da yok).

Kapsam (config.view.scope) haritanın yalnız bir bölümünü çizmeye yarar ve iki
türü vardır:

  • Üst birime göre — { "parentId": 15 } yalnız o üst birimin alt
    birimlerini çizer (ör. bir eyaletin ilçeleri). Yazılabilecek değerleri
    GET /geographies/{geographyId}/scope-parents listeler; her satır üst birimin
    adını ve seçilirse çizilecek bölge sayısını verir. Bu keşif ucu gereklidir:
    bazı coğrafyalarda yüzlerce üst birim vardır ve hata mesajı hepsini sayamaz.
    Coğrafyanın parentGeographyId alanı null ise bu tür kapsam kullanılamaz.
  • Kimlik listesine göre — { "ids": [233, 428, 440] } yalnız o bölgeleri
    çizer ve her düzeyde çalışır. Hazır çok ülkeli listeler için
    GET /region-presetse bak: yanıttaki ids değerini olduğu gibi kullan,
    listenin adını değil. Liste ileride değişirse adı kaydedilmiş bir harita
    sessizce başka bir şey gösterirdi.

Harita oluşturmak ve veri yazmak

Harita iki adımda kurulur ve bu bilinçli: bölge adlarının coğrafyaya
çözülmesi ayrı bir iştir ve eşleşme raporunu veri ucu döndürür.

1. Haritayı oluştur — veri göndermezsin, harita boş doğar:

POST /projects/{projectId}/maps
{ "title": "İllere göre nüfus", "config": { "geographyId": "tr-adm1" } }

geographyId değerlerini GET /geographies listeler. Projeksiyon coğrafyadan
türetilir; harita hesabının varsayılan marka kitini giyer. Yanıt 201 ve
Location başlığıyla gelir.

2. Veriyi yaz — bölge adlarını gönderirsin, sunucu çözer:

PUT /maps/{mapId}/data
{
  "rows": [
    { "region": "Ankara", "value": "5803" },
    { "region": "İstanbul", "value": "15907" }
  ]
}

Değerler metin olarak gönderilir ve ondalık ayırıcı noktadır ("806.2");
binlik ayırıcı kullanılmaz ("4946", "4.946" değil). Sütunun geri kalanı
kanıtlarsa virgüllü ondalık çevrilir (806,2 → 806.2). Belirsiz (4.946,
1,234) ya da sayı olmayan değerler yanıtta uyarıyla bildirilir; sayı olmayan
değer (abc, N/A) çizilmez, boş değer 0 sayılır.
Zamanlı harita için her satıra at eklersin:
{ "region": "Ankara", "value": "5803", "at": { "precision": "year", "iso": "2026" } }.
Zaman beyanı (config.temporal) at taşıyan satırlardan türetilir, ayrıca
göndermen gerekmez; hassasiyet ilk zamanlı satırınkidir. Zamanlı bir haritada
at taşımayan ya da hassasiyeti farklı olan satır reddedilmez: kaydedilir
ama çizilmez ve yanıtın warnings alanında undeclared_period_rows koduyla
adıyla sayılır. Hiçbir satırda at yoksa harita zamansızdır.

Eşleşmeyen satırlar sessizce düşmez. Bir bölge adı coğrafyada bulunamazsa ya
da haritanın kapsamı dışında kalırsa satır kaydedilir (rawRows'ta durur) ama
çizilmez, ve yanıtın warnings alanında adıyla sayılır:

"warnings": [
  { "code": "unmatched_rows", "count": 1,
    "message": "1 bölge adı bu coğrafyada bulunamadı: Lefkoşa. …" }
]

Uyarı kodları: no_layers (çizilecek katman yok — layers boş dizi; harita
hiç çizilmez, okur "Bu harita görüntülenemiyor." görür; durum sürdükçe her
yanıtta ve listenin başında gelir) · unmatched_rows (ad çözülemedi) · mixed_id_types (ad ile kod
aynı veride karışık; bu yüzden bulunamayan satırlar) · out_of_scope_rows
(kapsam dışı) · matched_not_drawable (bu geometride yok) ·
undeclared_period_rows (satırın anı haritanın dönemlerinde yok — zamanlı
haritada at eksikse de bu gelir) · duplicate_rows (aynı bölge ya da
bölge+an için birden fazla değer; yalnız biri çizilir) · unreadable_values
(sayı değil, çizilmez) · ambiguous_number_cells (binlik mi ondalık mı
belirsiz) · comma_decimal_cells (virgüllü ondalık noktalıya çevrildi) ·
scheme_hidden_by_colors (renk şeması değişti ama katmandaki colors onu
gizliyor; yalnız PATCH yanıtında).

Hangi ayarlar var? GET /map-options hepsini listeler: adı, türü, ne işe
yaradığı ve seçenekli olanlarda (renk şeması, projeksiyon, lejant köşesi…)
geçerli değerlerin tamamı. Bir ayarı değiştirmeden önce buraya bakmak, geçersiz
bir değer gönderip 400 almaktan hızlıdır.

⚠ Renk şeması, basamak sayısı ve "veri yok" rengi layers dizisinin
içindedir
(layers[].colorScale.scheme gibi). Bu dizi bütün olarak yazılır:
tek bir alanı değiştirmek için haritayı oku, katman nesnesini kopyala, alanı
değiştir ve layersı tamamen geri gönder — eksik gönderdiğin alanlar kaybolur.

Katmanın renkleri (colorScale.colors öğeleri ve noDataColor) grafikteki
renk alanlarıyla aynı biçimleri alır: #RRGGBB gibi onaltılık, yalnız sayılarla
rgb()/rgba()/hsl()/hsla() ya da CSS renk adı (transparent dahil), en
çok 64 karakter. Başka bir değer 400 invalid_request alır ve mesaj alanın
yolunu söyler (ör. config.layers.0.colorScale.colors.2). Okuyup geri
gönderdiğin katmanda bu biçimin dışında eski bir renk varsa (ör. beş haneli
#12345) yazım reddedilir; o renk zaten çizilmiyordur, yerine varsayılan renk
basılıyordur — geçerli bir renkle değiştirip gönder.

⚠ config.dataSource (konnektör künyesi) API ile yazılamaz. O blok verinin
hangi kaynaktan, hangi lisansla geldiğini söyleyen bir köken iddiasıdır ve
lisansı haritanın künyesine basılır; tek meşru yazarı Tuvelia'daki "Kaynaktan
veri" akışıdır. Kaynağı belirtmek için config.meta.source alanına serbest
metin yaz.

Ayarları değiştirmek için PATCH /maps/{mapId} kullanırsın; gönderdiğin
alanlar mevcut ayarlarla birleşir. Göndermediğin alanlar yalnız geographyId
gerçekten değişince değişir (aynı değeri yeniden göndermek değişim sayılmaz):
⚠ kapsam (view) sıfırlanır ve projeksiyon (projection) yeni coğrafyanın
varsayılanından türetilir — ikisini aynı çağrıda gönderirsen gönderdiğin
kazanır. Sebebi: 15 Almanya'da bir eyalet, başka bir ülkede başka bir
bölgedir. Veri de ham satırlardan yeni coğrafyaya göre yeniden çözülür; ham
satırlar korunur, eşleşmeyen bölgeler yanıtın warnings alanında adıyla
sayılır.

Haritalarda da anahtar yalnız anahtarla oluşturulan haritaları değiştirir;
Tuvelia'da oluşturduğun haritalar okunur ama değiştirilemez. expectedVersion
gönderirsen araya giren bir değişiklik yazımı conflict (409) ile reddeder.

Proje ve grafik oluşturmak

Yazma isteklerinin gövdesi JSON'dır ve Content-Type: application/json
başlığı zorunludur. Gövdede tanınmayan bir alan varsa (ör. yazım hatası) istek
reddedilir; alan sessizce yok sayılmaz.

Proje oluşturmak için adını gönderirsin:

curl -X POST https://tuvelia.com/api/v1/projects \
  -H "Authorization: Bearer tuv_pat_…" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Seçim grafikleri" }'

Yanıt 201 durumuyla projeyi döner. Proje adı en çok 200 karakter olabilir.

Grafik oluşturmak için bir ad ve genellikle veri gönderirsin:

curl -X POST https://tuvelia.com/api/v1/projects/{projectId}/charts \
  -H "Authorization: Bearer tuv_pat_…" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Yıllık enflasyon",
    "data": { "headers": ["Yıl", "TÜFE"], "rows": [["2023", "64.8"], ["2024", "44.4"]] },
    "config": { "chartType": "line", "sourceName": "TÜİK" }
  }'

Yanıt 201 durumuyla grafiği döner; Location başlığı grafiğin adresini
taşır. Oluşturulan grafik için şunları bil:

  • Hesabının varsayılan marka kitini giyer: renkleri ve yazı tipi Tuvelia'daki
    Yeni öğe ile oluşturduğun bir grafikle aynıdır.
  • Veri gönderir ve config.title vermezsen grafiğin görünen başlığı grafiğin
    adıdır, alt başlığı boştur. Veri göndermezsen grafik örnek veriyle ve o
    örneğin kendi başlığıyla oluşur; gerçek veriyi sonra PUT ile verirsin.
  • template alanı üç başlangıç şablonundan birini seçer: race (yarış),
    scatter (dağılım) ya da timeline (süre çizelgesi). Şablon örnek veriyi
    zaman bağlaması ve eşlemesiyle kurar. Şablonsuz ve eşlemesiz yarış ile süre
    çizelgesi boş çizer. Dağılım eşlemeyi seri adlarından türetip çizer.
    config.temporal göndermezsen ve satır etiketleri (ilk sütun) yılsa — Yıl | Türkiye · gelir | Türkiye · yaşam | … gibi en az iki varlıklı bir dönem
    tablosu — zaman bağlaması kendiliğinden kurulur (yıl hassasiyeti) ve satırlar
    dönem okunur; yanıtın warnings alanı bunu scatter_temporal_bound ile
    söyler. Öteki tablolarda her satırı bir nokta okur ve yalnız ilk ölçü çiftini
    kullanır. Her satırın bir nokta olmasını istiyorsan aynı istekte
    config.scatter.rowsAre: "entity" gönder; bağlama kurulduktan sonra da
    kaldırabilirsin (aşağıda "Grafiği güncellemek"). Gönderdiğin data ve
    config şablonun üzerine yazar.
  • Renklerin neye karşılık geldiği grafikte lejanttan başka hiçbir yerde
    yazmayacaksa lejant açık doğar (config.showLegend: true). Bu,
    legend_hidden uyarısının kapsadığı her durumdur: çok serili çubuk,
    çizgi, alan ya da yığın; iç içe ya da ızgara pasta; dilim etiketi kapalı
    (showLabels: false) tek pasta; renk sütunlu (timeline.colorColumn) süre
    çizelgesi; grup başlığı kutusuna sığmayan ağaç haritası. showLegend ya da
    legend.visible gönderirsen seninki kalır. Öteki grafiklerde lejant kapalı
    doğar — örneğin tek serili çubukta ya da etiketli tek pastada kategori adları
    eksende ya da dilimde zaten yazar.
  • configte GET /charts/{chartId} yanıtındaki ayar alanlarını kullanırsın.
    Notlar (annotations) API ile yazılamaz; notları Tuvelia'da eklersin.
  • Tablodaki adlara bağlı ayarlar PATCH /charts/{chartId} ile aynı kuralla
    denetlenir. Dumbbell'de config.dumbbell göndermezsen çiftler ve dönem adları
    seri adlarından türetilip kaydedilir (lejant "İlköğretim · 2014" değil
    "2014" der) ve yanıtın configinde görünür. Tabloda olmayan seriyi anan ya da
    aynı seriyi iki uçta kullanan çift 400 invalid_request alır. Çift seri
    adlarına bağlıdır: sonra PUT ile seri adlarını değiştirirsen bozulan çift
    yeni adlardan yeniden kurulur (aşağıda "Grafiği güncellemek").
  • Dağılımda config.scatter.entities göndermezsen eşleme (hangi serinin x,
    hangisinin y olduğu) seri adlarından türetilip kaydedilir. Eksen adlarını
    (scatter.xLabel · scatter.yLabel) gönderdiysen seninki kalır; yalnız
    göndermediğin türetilir ("Türkiye · gelir" serisinden "gelir").
  • Veri sınırları Tuvelia'dakiyle aynıdır: en çok 30 sütun, 5.000 satır, hücre
    başına 300 karakter.

Grafik yayınlanmaz. Gömmek için onu Tuvelia'da bir kez yayınlarsın.

Grafiği güncellemek

Bir API anahtarı YALNIZ anahtarla oluşturulmuş grafikleri (apiManaged: true)
değiştirebilir. Hesabının herhangi bir anahtarı bunu yapabilir; anahtarı
yenilediğinde uygulaman o grafikleri güncellemeye devam eder. Tuvelia'da
oluşturduğun grafikler anahtarla okunur ama değiştirilemez; istek 403
forbidden alır.

  • PATCH /charts/{chartId} gövdesinde config taşır ve gönderdiğin alanları
    mevcut ayarlarla birleştirir. Grafik tipini de böyle değiştirirsin:
    { "config": { "chartType": "bar" } }. Göndermediğin alanlar yalnız bağlı
    ayar olarak değişir: stil (styleId) değişince elle değiştirilmemiş stil
    ayarları (renkler, yazı tipi, köşe yuvarlaklığı, derinlik) yeni stilin
    değerini alır — Tuvelia'da stil seçmekle aynı; aynı istekte gönderdiğin alan
    kalır. Tip değişince o tipin eşlemesi ve ayar nesnesi (dumbbell çiftleri,
    dağılım eşlemesi ve okuması, pasta ayarları) tablodan türetilip kaydedilir;
    dağılımın yıl satırlı tablosu zaman bağlamasını kendiliğinden alır
    (scatter_temporal_bound). Tip değişince yeni tipin hiç
    desteklemediği derinlik (depth; bugün dumbbell, dağılım ve süre
    çizelgesinde extrude) flat yazılır; aynı istekte depth gönderirsen
    dokunulmaz, kapalıysa istek reddedilir. Stil ve derinlik denetimi yalnız
    isteğin chartType, styleId ya da depth taşıdığında yapılır.
  • Zaman bağlamasını kaldırmak için config.temporal: null gönderirsin: alan
    ayarlardan silinir ve grafik bağlamasız çizilir (yarış bağlamasız boş
    çizer, yanıtta nothing_drawn gelir). Dağılımda okuma
    (scatter.rowsAre) değişmez; her satırın bir nokta olmasını istiyorsan aynı
    istekte config.scatter.rowsAre: "entity" gönder (scatter nesnesi bütün
    yazılır). Aynı istekte tipi dağılıma çeviriyorsan yıl satırlı tablo bağlamayı
    kendiliğinden geri almaz. null yalnız PATCHte geçerlidir; grafik
    oluştururken config.temporal ya verilir ya hiç gönderilmez.
  • Zaman bağlı bir dağılımda okumayı config.scatter.rowsAre: "entity" yaparsan
    (config.temporal göndermeden) bağlama da kalkar: varlık okumasında zaman
    yoktur ve iki ayar birlikte kaydedilmez. Yanıtın warnings alanının sonunda
    scatter_temporal_removed gelir (count nokta okunan satır sayısı; mesaj
    kaldırılan sütunu söyler). Çizim değişmez — varlık okumasında bağlama zaten
    yok sayılıyordu. Zaman imlecini geri istersen config.scatter.rowsAre: "period" ile config.temporalı birlikte gönder. Okumayı entity yapıp aynı
    istekte bir config.temporal nesnesi gönderen istek eskisi gibi 400
    alır.
  • PUT /charts/{chartId}/data gövdesinde data taşır ve verinin tamamını
    yeniden yazar; ayarlar değişmez. Tek istisna dumbbell çifti: kayıtlı bir
    çiftin serisi yeni tabloda yoksa o çift düşer ve serileri boşta kalan
    çiftler, oluştururkenki kuralla, yeni seri adlarından kurulur (hiç çift
    kalmadıysa eşleşme ve dönem adları baştan türetilir). Seri adları tabloda
    duran çiftlere dokunulmaz, istek reddedilmez; yanıtın warnings alanında
    dumbbell_pairs_rederived düşen ve kurulan çiftleri sayar. Eşleşme
    istediğin gibi değilse config.dumbbelli PATCH ile gönder. İkinci
    istisna dağılım eşlemesi (config.scatter.entities): eşlemenin hiçbir x ya
    da y serisi yeni tabloda yoksa eşleme, oluştururkenki kuralla, yeni tablodan
    kurulur. Eksen adları (scatter.xLabel/yLabel) yalnız eski eşlemeden
    kopyalanmışsa yenilenir, senin yazdığın ad kalır; okuma (scatter.rowsAre)
    değişmez. En az bir adı tabloda kalan eşlemeye dokunulmaz. Yanıtın
    warnings alanında scatter_mapping_rederived düşen ve kurulan varlıkları
    sayar; yeni tablodan eşleme kurulamıyorsa (en az iki sayı sütunu yoksa)
    eşleme düşer ve yanında nothing_drawn gelir. Eşleşme istediğin gibi
    değilse config.scatterı PATCH ile gönder (nesne bütün yazılır).

İkisi de güncellenen grafiği döner.

Hazır palet: colorPreset 0 ile 5 arasında bir tam sayıdır (0 Okyanus ·
1 Gün Batımı · 2 Orman · 3 Mor Rüya · 4 Toprak · 5 Pastel). Başka bir değer
(9, -1, 1.5, "2") 400 invalid_request alır ve mesaj geçerli
değerleri sayar; POST ile grafik oluştururken de aynı kural geçerlidir.
GET /chart-options bu alanı altı değeriyle ([0, 1, 2, 3, 4, 5], sayı olarak) listeler. Önceden aralık dışı bir
değerle kaydedilmiş grafik okunurken o değeri olduğu gibi döner ve Okyanus
paletiyle çizilir.

Ondalık: decimalPlaces 0 ile 3 arasında bir tam sayıdır — Tuvelia'daki
Ondalık seçicisinin sayıları. Başka bir değer (4, 101, -1, 1.5,
"2") 400 invalid_request alır; POST ile grafik oluştururken de aynı
kural geçerlidir. Daha fazla basamak gereken küçük değerlerde
decimalMode: "auto" kullan (1'den küçük değerlerde iki anlamlı basamak, en
çok altı ondalık). GET /chart-options alanı dört değeriyle ([0, 1, 2, 3], sayı olarak) listeler. Önceden
kaydedilmiş bir değer okunurken olduğu gibi döner; 4 ile 100 arasındaki değer
yine o kadar basamakla çizilir, 100'den büyük değer 3, negatif değer 0
basamakla çizilir.

Renkler ve yazı tipi: geçerli bir CSS biçimi. Renk alanları (bgColor,
singleColor, customColors öğeleri, titleColor, subtitleColor,
labelColor, gridColor, axisColor, highlight.color) yalnız şu biçimleri alır: #RGB,
#RGBA, #RRGGBB, #RRGGBBAA, yalnız sayılarla yazılmış rgb(), rgba(),
hsl(), hsla() (ör. rgba(0, 119, 182, 0.5)) ya da bir CSS renk adı (ör.
navy, transparent); en çok 64 karakter. fontFamily virgülle ayrılmış aile
adlarıdır (ör. 'Inter', system-ui, sans-serif); ad yalnız harf, rakam,
boşluk, nokta, tire ve alt çizgi taşır, en çok 300 karakter. Başka bir değer
(url(…), var(--x), ; içeren metin, renk olmayan bir sözcük) 400
invalid_request alır; mesaj alanın yolunu (ör. config.customColors.1),
gelen değeri ve kabul edilen biçimleri söyler. POST ile grafik oluştururken de
aynı kural geçerlidir. Kural yalnız senin gönderdiğin alanlara bakar: grafiğin
giydiği marka kiti renkleri denetlenmez. Okuduğun ayarların tamamını geri
gönderirsen ve içinde bu biçimlerin dışında eski bir değer varsa istek reddedilir
— yalnız değiştirdiğin alanları gönder.

Arada değişen grafiğin üzerine yazmamak. Grafik bu arada Tuvelia'da
değişmiş olabilir. İstersen gövdeye son okuduğun sürümü eklersin:

{ "data": { … }, "expectedVersion": 7 }

Grafiğin sürümü artık 7 değilse yazma yapılmaz ve yanıt 409 conflict
olur; mesaj güncel sürümü söyler. Grafiği yeniden okur, değişikliğini güncel
hâline uygular ve tekrar gönderirsin. expectedVersion göndermezsen son yazan
kazanır.

Anahtarla yapılan her yazma, hangi anahtarla, ne zaman ve hangi proje ya da
grafik üzerinde yapıldığıyla kayda geçer. Kayıt içeriği (veriyi, ayarları)
tutmaz ve 90 gün saklanır.

Hatalar

Hata yanıtı her zaman aynı biçimdedir:

{ "error": { "code": "not_found", "message": "Grafik bulunamadı (id=…). …" } }

Programın codea bakmalı; message insan için yazılmış Türkçe bir
açıklamadır ve değişebilir.

Geçersiz girdide (invalid_request) message, reddedilen her alanı yoluyla
yazar ve yanına nedenini ve nasıl düzeltileceğini Türkçe ekler:

geçersiz girdi — limit: en çok 200 olabilir — 200 ya da daha küçük bir değer gönder
İstek geçersiz — template: geçerli değerlerden biri olmalı: "race", "scatter", "timeline" — bunlardan birini aynen gönder
İstek geçersiz — (kök): bilinmeyen alan: "foo" — yazım hatası olabilir; alanı düzelt ya da çıkar (bu nesnenin alanları: name)

Birden çok sorun ; ile ayrılır; gövdedeki sorunlardan en çok beşi yazılır,
gerisi "(+n sorun daha)" diye sayılır. Yol nokta ile yazılır (data.rows.0.0
ilk satırın ilk hücresidir); (kök) gövdenin kendisidir.

KodHTTPNe demek
invalid_request400İstek geçersiz: kimlik UUID biçiminde değil, gövde JSON değil, bir alan eksik ya da tanınmayan bir alan var.
unauthorized401Anahtar yok, biçimsiz, geçersiz, süresi dolmuş ya da iptal edilmiş.
insufficient_scope403Anahtarın yazma yetkisi yok (eski, yalnız okuma yetkili anahtar). Yeni bir anahtar oluştur.
forbidden403Grafik ya da harita Tuvelia'da oluşturulmuş; anahtar onu değiştiremez.
not_found404Kaynak yok: silinmiş ya da başka bir hesaba ait olabilir.
conflict409Grafik ya da harita, gönderdiğin expectedVersiondan sonra değişti; yeniden oku ve tekrar dene.
payload_too_large413İstek gövdesi çok büyük.
rate_limited429Hız sınırı aşıldı; Retry-After başlığındaki saniye kadar bekle.
internal_error500Beklenmeyen bir hata; birazdan yeniden dene.
unavailable503Anahtar şu an doğrulanamadı, ama reddedilmedi; Retry-After kadar bekle.

İleride yeni kodlar eklenebilir; tanımadığın kodu HTTP durumuna göre ele al.

Hız sınırı

Okuma istekleri hesap başına 10 dakikada 300, yazma istekleri ayrıca 10
dakikada 120 ile sınırlıdır. Okumanın ve yazmanın bütçeleri birbirinden
bağımsızdır; hesabın bütün anahtarları bu bütçeleri paylaşır. Sınır aşılınca
yanıt 429 olur ve Retry-After başlığı kaç saniye bekleyeceğini söyler.

Bir yazma isteğinin gövdesi en çok 2 MB olabilir; daha büyüğü 413 alır.

Buradaki sayılar söz değildir ve değişebilir. Programın her durumda 429 ve
413 yanıtlarını karşılayabilmeli.

OpenAPI belgesi

API'nin makinece okunur tarifi şu adrestedir ve kimlik istemez:

https://tuvelia.com/api/v1/openapi.json

Belgeyi Postman gibi araçlara ya da bir ChatGPT eylemine (Actions) adresiyle
aktarabilirsin.

Sürüm kuralı

Şimdi (önizleme). API önizlemede olduğu sürece uçlar ve alanlar
değişebilir: bir alan kaldırılabilir, adı ya da anlamı değişebilir. Böyle bir
değişiklik önce aşağıdaki Değişiklik günlüğüne yazılır. Gereksiz değişiklik
yapılmaz; amaç, sözleşmeyi ilk gerçek kullanıcısı olan WordPress eklentisiyle
sınamak.

Önizleme bittikten sonra. v1 içinde yalnız ekleme yapılır: yeni uç ya da
yanıtlara yeni alan. Var olan bir alan silinmez, adı ya da anlamı değişmez;
böyle bir değişiklik /api/v2 olarak gelir.

Her iki dönemde de istemcin tanımadığı alanları ve tanımadığı hata kodlarını
yok saymalı.

Değişiklik günlüğü

  • 2026-11-02 — İç içe pastada "dilimler çizilemeyecek kadar dar" mesajı iç
    içe pastanın sınırını söyler.
    Bu nedenin nothing_drawn mesajı yalnız
    tek pastanın eşiklerini (halkalı 280, halkasız 628 kategori) veriyordu; iç
    içe pastada sınır başkadır. Artık iç içe pastada mesaj o pastanın sınırını
    söyler: eşit değerlerde iki seride ortası boşken yaklaşık 500, doluyken
    yaklaşık 525 kategori; seri sayısı arttıkça sınır düşer. Mesaj, sınırın
    Tuvelia'nın video çıktısındaki pasta boyutuna göre sorulduğunu ve ortayı
    doldurmanın burada sınırı yalnız biraz yükselttiğini de söyler. Tek pasta ve
    ızgarada mesaj, eşiklerin bu iki moda ait olduğunu belirtir. Kod, count
    ve sıra aynı; OpenAPI belgesi değişmedi (1.0.0-preview.88).
  • 2026-11-02 — code alanının açıklaması pastada dilimlerin çizilemeyecek
    kadar dar kaldığı durumu da sayar.
    OpenAPI belgesinde uyarının code
    alanı, nothing_drawn uyarısının geldiği durumları tek tek sayıyordu. Pastada
    kategori o kadar çok ki dilimlerin arasındaki boşluk bütün daireyi kaplıyor
    ve hiçbir dilim çizilemiyorsa uyarı 2026-10-30'dan beri geliyor. Belge bu
    durumu saymıyordu, artık sayıyor. Davranış, kod ve yanıt şekli aynı; yalnız
    açıklama değişti. OpenAPI 1.0.0-preview.88.
  • 2026-11-01 — Dağılımda okumayı entity yapmak zaman bağlamasını da
    kaldırır; yeni bilgi kodu scatter_temporal_removed.
    Zaman bağlı bir
    dağılıma yalnız config.scatter.rowsAre: "entity" gönderen PATCH önce
    kabul ediliyor ve okuma ile bağlamayı birlikte kaydediyordu (bağlama çizimde
    yok sayılıyordu, yanıt bunu söylemiyordu). Artık bağlama kalkar ve yanıtın
    warnings alanının sonunda scatter_temporal_removed gelir. Hiçbir istek
    yeni bir ret almaz; okumayla birlikte bir config.temporal nesnesi gönderen
    istek eskisi gibi 400 alır. Grafik oluşturma ve öteki yazımlar değişmedi.
    OpenAPI 1.0.0-preview.87.
  • 2026-11-01 — iç içe pastada "dilimler çizilemeyecek kadar dar" grafiğin
    video boyutuna göre sorulur.
    İç içe pastada halkaların genişliği grafiğin
    boyutuna bağlıdır. nothing_drawn bu nedeni en geniş halkaya göre soruyordu
    ve eşit değerlerde ancak 524 kategoriden itibaren geliyordu; daha az
    kategoride Tuvelia'nın video çıktısında hiçbir halkaya dilim çizilemeyen
    pastada uyarı gelmiyordu. Artık video çıktısındaki en büyük pastanın
    boyutuna (yarıçap 173 piksel) göre sorulur: eşit değerlerde halkalı iç içe
    pastada seri sayısına göre 493–498, halkasızda 523–524 kategoriden itibaren
    gelir. Bundan büyük çizilen bir gömmede pasta bu eşik ile 523 kategori
    arasında yine çizilebilir; uyarı o durumda da gelir. Tek pasta ve ızgara
    değişmedi. Kod ve yanıt şekli aynı; OpenAPI belgesi aynı
    (1.0.0-preview.86). Bu girdi günlüğe 2026-11-02'de eklendi.
  • 2026-11-01 — Geçersiz girdinin hata metni Türkçe ve düzeltme yolunu
    söylüyor.
    400 invalid_request yanıtının messageı her sorunda alanın
    yolunu korur; bir değerin kuralına uymayan alan için doğrulayıcının İngilizce
    metni ("Too big: expected number to be <=200") yerine nedeni ve düzeltmeyi
    yazar ("en çok 200 olabilir — 200 ya da daha küçük bir değer gönder"). Alanın
    kendi Türkçe mesajı olan kurallar (ör. colorPreset) değişmedi. code,
    durum kodu ve hangi isteğin reddedildiği değişmedi; OpenAPI belgesi
    değişmedi.
  • 2026-10-31 — OpenAPI belgesi GET /geographies arama parametrelerinin
    sınırını ilan ediyor.
    q artık belgede de en az 1, en çok 100 karakterlik
    bir metindir; region ve level en az 1 karakterdir (minLength,
    maxLength). Sunucu bu sınırı zaten uyguluyordu: boş bir değer ya da 100
    karakterden uzun bir q 400 invalid_request döner. Davranış değişmedi.
    OpenAPI 1.0.0-preview.86.
  • 2026-10-31 — OpenAPI belgesi cursor parametresinin uzunluk sınırını
    ilan ediyor.
    Üç liste ucunda (GET /projects,
    GET /projects/{projectId}/charts, GET /projects/{projectId}/maps)
    cursor artık belgede de en az 1, en çok 500 karakterlik bir metindir
    (minLength, maxLength). Sunucu bu sınırı zaten uyguluyordu: boş ya da
    daha uzun bir cursor 400 invalid_request döner. Davranış değişmedi.
    OpenAPI 1.0.0-preview.85.
  • 2026-10-31 — eski kayıt reddinin mesajı yazma işlemini adıyla anıyor.
    Ham satırı olmayan eski bir haritada coğrafya değiştirilince dönen 400
    mesajı veriyi yeniden yazmayı kodun iç adıyla (setMapRows) söylüyordu;
    artık işlemin adıyla söyler ("Haritanın verisini değiştir" — OpenAPI
    belgesindeki PUT /maps/{mapId}/data özeti). Davranış ve OpenAPI belgesi
    değişmedi.
  • 2026-10-31 — geographyId ayar keşfi açıklaması PATCH cümlesiyle aynı;
    eski kayıt reddi verili kayıtla sınırlı.
    GET /map-options yanıtında
    geographyId açıklaması PATCH /maps/{mapId} açıklamasındaki cümlenin ayrı
    bir kopyasıydı; artık aynı cümleyi taşır (projeksiyonu aynı istekte
    göndermek ve eski kayıt reddi de yazılı). Aynı cümlede "ham satırı olmayan
    eski kayıtta coğrafya değişimi reddedilir" deniyordu; ret yalnız çizilmiş
    verisi olup ham satırı olmayan kayıtta gelir, verisi olmayan haritanın
    coğrafyası değişebilir. Davranış değişmedi. OpenAPI 1.0.0-preview.84.
  • 2026-10-31 — haritanın PATCH açıklaması bağlı ayarları sayar; uyarı
    kodlarının açıklamasında uç adı yok.
    PATCH /maps/{mapId} için "yalnız
    gönderdiğin alanlar değişir" deniyordu, uç açıklaması "veri değişmez"
    diyordu; geographyId gerçekten değişince kapsam (view) sıfırlanıyor,
    projeksiyon yeni coğrafyadan türetiliyor ve veri yeniden çözülüyordu. Uç
    tablosu, "Ayarları değiştirmek" ve config alanının açıklaması artık bunu
    söyler. Uyarı kodu code açıklamasında kodların ne zaman geldiği uç adıyla
    değil işlemin adıyla yazılır ("Grafiğin verisini değiştir", "Grafik oluştur",
    "Grafik ayarlarını değiştir"). Davranış değişmedi. OpenAPI
    1.0.0-preview.83.
  • 2026-10-31 — xAxis.labelAngle açıklamasında da "Çoklu grafik". Ayar
    keşfinde (GET /chart-options) görünümün eski adını taşıyan son açıklama
    da Tuvelia'daki adı kullanır: açı Çoklu grafik
    görünümünde uygulanmaz. Değerler ve davranış değişmedi. OpenAPI
    1.0.0-preview.82.
  • 2026-10-31 — PATCH ve uyarı açıklamaları yeni davranışa uydu.
    PATCH /charts/{chartId} için "yalnız gönderdiğin alanlar değişir"
    deniyordu; stil değişimi elle değiştirilmemiş stil ayarlarını, tip değişimi
    tipin eşlemesini, derinliği ve dağılımın zaman bağlamasını da yazıyordu. Uç
    tablosu, "Grafiği güncellemek" ve config alanının açıklaması artık bu bağlı
    ayarları sayar. dumbbell_pairs_rederived ve scatter_mapping_rederived
    kodlarının açıklaması düzeltme yolunu uç adı olmadan söyler ("config.dumbbelli
    tablodaki adlarla gönder") — uyarı mesajlarının kendisi zaten öyleydi.
    Davranış değişmedi. OpenAPI 1.0.0-preview.81.
  • 2026-10-31 — ayar keşfinde iki açıklama. GET /chart-options depth
    açıklaması tip değişiminin kuralını da söyler: yeni tipin hiç desteklemediği
    derinlik (bugün dumbbell, dağılım ve süre çizelgesinde extrude) flat
    yazılır, aynı istekte depth gönderirsen dokunulmaz (PATCH bu kuralla
    2026-10-31'den beri çalışıyor). GET /map-options layers açıklaması boş
    dizinin kabul edildiğini ama haritanın çizilmediğini ve yanıtın bunu
    no_layers ile söylediğini yazar. Alanlar, değerler ve davranış değişmedi.
    OpenAPI 1.0.0-preview.80.
  • 2026-10-31 — PATCH ile zaman bağlaması kaldırılır: config.temporal: null. PATCH /charts/{chartId} config.temporala nullı reddediyordu
    (400); dağılımın kendiliğinden kurduğu bağlama (scatter_temporal_bound)
    sonradan kaldırılamıyordu. Artık null bağlamayı ayarlardan siler ve grafik
    bağlamasız çizilir. Dağılımda okuma değişmez — satırları nokta okumak için
    aynı istekte config.scatter.rowsAre: "entity" gönder. null dışındaki
    her istek önceki gibi kabul ya da reddedilir; grafik oluştururken null
    yine kabul edilmez. scatter_temporal_bound mesajı bu yolu da söyler.
    OpenAPI 1.0.0-preview.79.
  • 2026-10-31 — liste uçları sayfa sayfa: limit, cursor, truncated,
    nextCursor.
    GET /projects, GET /projects/{projectId}/charts ve
    GET /projects/{projectId}/maps eskiden bütün kayıtları tek yanıtta
    veriyordu. Artık bir sayfada varsayılan olarak en çok 50 kayıt gelir
    (limit ile 1–200). Her liste yanıtına truncated ve nextCursor eklendi;
    truncated: true ise devamını cursor ile iste (yukarıda Sayfalama).
    ⚠ 50'den fazla projesi ya da bir projesinde 50'den fazla grafiği veya
    haritası olan bir hesapta, sayfalamayı izlemeyen istemci artık listenin
    yalnız ilk sayfasını görür — yanıt bunu truncated: true ile söyler.
    Geçersiz limit ya da işaret 400 invalid_request döner. OpenAPI
    1.0.0-preview.78.
  • 2026-10-31 — ayar açıklamalarında görünümün adı "Çoklu grafik". Veriyi
    yan yana kartlara bölen görünümün Tuvelia'daki tek adı artık
    Çoklu grafik (editörde Düzen › Görünüm modu). GET /chart-options
    açıklamalarından displayMode · smallMultiplesBy · smallMultiplesColumns
    · smallMultiplesScale · smallMultiplesAxisTitles · highlight ·
    cellNotes · showLabels bu adı kullanır; displayMode açıklaması
    small_multiples değerinin editördeki adını da söyler. Değerler (small_multiples dahil), alan adları ve davranış
    değişmedi. OpenAPI 1.0.0-preview.77.
  • 2026-10-31 — dağılım yıl satırlı tabloda zaman bağlamasını kendiliğinden
    kurar; yeni bilgi kodu scatter_temporal_bound.
    POST /projects/{projectId}/charts ya da tipi dağılıma çeviren PATCH /charts/{chartId}, config.temporal ve config.scatter.rowsAre
    göndermediğinde, satır etiketleri (ilk sütun) yıl olan ve en az iki varlık · ölçü çifti kuran tabloyu her satırı bir nokta okuyordu: noktalar yıl adını
    taşıyor, ilk çift dışındaki varlıklar çizilmiyordu ve uyarı yoktu. Artık
    zaman bağlaması (temporal: ilk sütun, year, instant) kendiliğinden
    kurulur, satırlar dönem okunur (scatter.rowsAre: "period") ve o yanıtın
    warnings listesinin sonunda scatter_temporal_bound gelir (count dönem
    okunan satır sayısı). Ay ya da gün satırlı, tek varlıklı ya da okuması
    verilmiş tabloda davranış aynı; var olan grafikler değişmedi. Satırları nokta
    okumak istiyorsan aynı istekte config.scatter.rowsAre: "entity" gönder.
    OpenAPI 1.0.0-preview.76.
  • 2026-10-31 — katmansız harita yanıtta uyarıyla söylenir: no_layers.
    layers boş dizi yazılabiliyor (POST /projects/{projectId}/maps ve PATCH /maps/{mapId}) ve kabul edilmeye devam ediyor; böyle bir harita hiç
    çizilmez, okur yalnız "Bu harita görüntülenemiyor." yazısını görür. Yanıt
    bunu söylemiyordu. Artık haritayı döndüren her yanıt (okuma dahil), durum
    sürdükçe, warnings listesinin başında no_layers taşır; count
    haritanın satır sayısıdır (veri yoksa 0). Veri korunur; layersa bir
    koroplet katmanı yazınca uyarı kalkar. OpenAPI 1.0.0-preview.75.
  • 2026-10-31 — tip değişiminde kapalı derinlik düz olur; yalnız başlık
    değiştiren istek kapalı derinlikli grafikte de geçer.
    PATCH /charts/{chartId} grafiği, kayıtlı derinliği hiç desteklemeyen bir tipe
    çevirdiğinde (extrude seçiliyken dumbbell, dağılım ya da süre çizelgesi)
    istek "… extrude edilemez" ile reddediliyordu; artık depth flat yazılır
    ve istek geçer. Aynı istekte depth gönderirsen dokunulmaz (kapalıysa yine
    reddedilir). Tuvelia editöründe tipi değiştirilen grafiklerde böyle bir
    derinlik kayıtlı kalabiliyordu ve o grafiklerde yalnız title gibi ilgisiz bir alanı
    değiştiren istek de reddediliyordu; stil ve derinlik denetimi artık yalnız
    istek chartType, styleId ya da depth taşıdığında yapılır. Kayıtlı
    derinliğe yalnız tip değişiminde dokunulur. Kendiliğinden düşürülen derinlik
    (çizgi ve alanda extrude → yumuşak çizim) eskisi gibi korunur. OpenAPI
    1.0.0-preview.74.
  • 2026-10-30 — nothing_drawn dilimleri çizilemeyecek kadar dar pastada da
    gelir.
    Pasta dilimlerin arasında küçük bir boşluk bırakır; kategori çok
    olunca bu boşluklar bütün daireyi kaplıyor ve hiçbir dilim çizilmiyordu
    (eşit değerlerde tek pastada ve ızgarada halkalıysa 281, halkasızsa 629; iç
    içe pastada 524 kategoriden itibaren). Grafik boş çiziliyor ama warningste
    nothing_drawn yoktu. Artık nothing_drawn en önde gelir, count satır
    sayısıdır; mesaj nedeni söyler ve kategori sayısını azaltmayı (küçük
    kategorileri tek satırda toplamayı), halkayı kapatmayı (pie nesnesini
    donut: false ile göndermeyi) ya da çubuk grafiği önerir. Pozitif değer
    yoksa ya da tek pastanın ilk görünür serisi boşsa mesaj eskisi gibi o nedeni
    söyler. Kod ve yanıt şekli aynı; OpenAPI belgesi aynı (1.0.0-preview.73).
    Bu girdi günlüğe 2026-11-02'de eklendi.
  • 2026-10-30 — pastada dilim boşluğundan dar pozitif değer de "dilim açmaz".
    Pasta dilimlerin arasında küçük bir boşluk bırakır; pozitif ama bu boşluktan
    dar bir değerin dilimi çizilmiyordu, lejant ve lejantın renk uyarıları
    (legend_hidden · single_color_series · duplicate_colors) onu yine
    sayıyordu. Artık saymıyor (count ve mesajdaki adlar o kategoriler kadar
    azalabilir). İç içe modda halka genişliği grafiğin boyutuna bağlı olduğundan
    yalnız hiçbir halkada çizilemeyecek değer düşer. Kodlar, sıra ve yanıt şekli
    aynı; OpenAPI belgesi aynı (1.0.0-preview.73).
  • 2026-10-30 — belge ve açıklama düzeltmesi: dağılım eşlemesiz boş çizmez.
    Şablon açıklamaları (GET /chart-templates ve createChartin template
    alanı) ve bu sayfa "yarış, dağılım ve süre çizelgesi eşleme olmadan boş
    çizer" diyordu. Ölçüldü: yarış ve süre çizelgesi için doğru; dağılım ise
    eşlemeyi seri adlarından türetip çizer, ama zaman bağlaması yoksa her satırı
    bir nokta okur (dönem satırlı tabloda noktalar yıl adını taşır). Ağaç haritası
    da büyüklük sütununu kendisi seçer. Açıklamalar bunu söylüyor; uç, alan ve
    davranış değişmedi. OpenAPI 1.0.0-preview.73.
  • 2026-10-30 — dağılım oluşturulurken gönderdiğin eksen adı korunur.
    POST /projects/{projectId}/charts ve grafiği dağılıma çeviren PATCH /charts/{chartId}, config.scatter.entities gönderilmediğinde eşlemeyi
    seri adlarından türetirken scatter.xLabel ve scatter.yLabeli de
    türetilenle eziyordu ("Kişi başı gelir" gönderilince yanıt ve grafik "gelir"
    diyordu). Artık gönderdiğin eksen adı kalır, yalnız göndermediğin türetilir;
    eşleme yine türetilir. entities ile birlikte gönderilen adlar zaten
    korunuyordu. Var olan grafikler değişmedi. OpenAPI 1.0.0-preview.72.
  • 2026-10-29 — renk anahtarı yalnız lejantta olacak her yeni grafik lejant
    açık doğar.
    POST /projects/{projectId}/charts lejantı yalnız çok serili
    çubuk, çizgi, alan ve yığında açık kuruyordu; iç içe ya da ızgara pasta,
    dilim etiketi kapalı tek pasta, renk sütunlu süre çizelgesi ve grup başlığı
    kutusuna sığmayan ağaç haritası lejant kapalı ve legend_hidden uyarısıyla
    doğuyordu. Artık legend_hidden uyarısının kapsadığı her yeni grafik
    config.showLegend: true ile ve bu uyarı olmadan doğar. showLegend ya da
    legend.visible gönderirsen seninki kalır (lejantı açıkça kapatırsan uyarı
    yine gelir). Uyarının kuralı, PATCH ve PUT …/data ile var olan grafikler
    değişmedi. OpenAPI 1.0.0-preview.71.
  • 2026-10-29 — belge gösteriminde iki değişiklik (bağımlılık güncellemesi); davranış
    aynı.
    Doğrulama kitaplığının yeni sürümüyle OpenAPI belgesi iki yerde farklı
    yazılıyor: birden çok basit türü kabul eden alanlar (ayar keşfindeki values
    ögeleri, coğrafya listesindeki parentGeographyId) anyOf yerine tek bir type
    dizisiyle (["string", "number", "boolean"]) gösteriliyor; tarih alanlarının
    (createdAt · updatedAt) deseni saniyeyi zorunlu yazıyor — yanıtlarımız zaten
    hep saniyeli ve Z ile biter. Kabul edilen istekler, yanıtların şekli ve anlamı
    değişmedi. OpenAPI 1.0.0-preview.70.
  • 2026-10-29 — veri yazımı tamamen bozulan dağılım eşlemesini yeniden kurar;
    yeni uyarı scatter_mapping_rederived.
    Dağılım oluşturulurken eşleme
    (config.scatter.entities) kaydedilir; sonra PUT /charts/{chartId}/data
    seri adları değişen bir tablo yazınca eşleme eski adlarda kalıyor ve grafik
    boş çiziliyordu (nothing_drawn). Artık eşlemenin hiçbir x ya da y serisi
    yeni tabloda yoksa eşleme oluştururkenki kuralla yeni tablodan kurulur; eksen
    adları yalnız eski eşlemeden kopyalanmışsa yenilenir, okuma (rowsAre)
    değişmez. En az bir adı tabloda kalan eşlemeye ve seri adlarını koruyan veri
    yazımının ayarlarına dokunulmaz, istek reddedilmez. Yanıt bunu yeni uyarıyla
    söyler (count düşen varlık sayısı; mesaj düşen ve kurulan varlıkları,
    hiçbir varlığa girmeyen serileri sayar) — yalnız o PUT yanıtında gelir,
    okumada gelmez. Var olan kodların anlamı ve sırası aynı. OpenAPI
    1.0.0-preview.69.
  • 2026-10-29 — veri yazımı bozulan dumbbell çiftini yeniden kurar; yeni uyarı
    dumbbell_pairs_rederived.
    PUT /charts/{chartId}/data ayarlara hiç
    dokunmuyordu: seri adları değişen tabloda kayıtlı dumbbell çifti eski adlarda
    kalıyor, grafik boş çiziliyor (nothing_drawn + missing_columns) ya da yeni
    grubun serileri hiç çizilmiyordu. Artık bir çiftin serisi yeni tabloda yoksa o
    çift düşer ve serileri boşta kalan çiftler oluştururkenki kuralla yeni seri
    adlarından kurulur; hiç çift kalmadıysa eşleşme ve dönem adları baştan
    türetilir. Seri adları tabloda duran çiftlere dokunulmaz, istek reddedilmez,
    seri adlarını koruyan veri yazımında ayarlar aynı kalır. Yanıt bunu yeni
    uyarıyla söyler (count düşen çift sayısı; mesaj düşen ve kurulan çiftleri,
    hiçbir çifte girmeyen serileri sayar) — bu uyarı yalnız o PUT yanıtında
    gelir, okumada gelmez. Var olan kodların anlamı ve sırası aynı. OpenAPI
    1.0.0-preview.68.
  • 2026-10-29 — Yeni uyarı: timeline_unlabeled_events (süre çizelgesi). Bir
    şeritte satır tavanı (timeline.maxRows, varsayılan 12) dolunca sığmayan
    olaylar adsız kısa çizgi olarak çiziliyordu ve kaç olayın adının yazılmadığı
    warningste hiç görünmüyordu. Artık bu olaylar timeline_unlabeled_events ile
    sayılır (yukarıda "Grafiğin içeriği"). Sayı çizimin genişliğine bağlı olduğu
    için count görselin referans genişliğindeki sayıdır ve message o genişliği
    yazar. Var olan kodların anlamı ve sırası değişmedi; yeni kod
    missing_columnsın ardından, görsel uyarılardan önce gelir. Çizim değişmedi.
    OpenAPI 1.0.0-preview.67.
  • 2026-10-29 — grafik oluştururken dumbbell çifti türetilir ve denetlenir.
    POST /projects/{projectId}/charts dumbbell çiftini kaydetmiyordu: lejant ilk
    ayar değişikliğine kadar dönem yerine tam seri adını gösteriyordu
    ("İlköğretim · 2014" yerine "2014"); tabloda olmayan seriyi anan çift 201 ve
    missing_columns ile kaydediliyordu, aynı seriyi iki uçta kullanan çift ise
    uyarısız kaydediliyordu. Artık oluşturma PATCH /charts/{chartId} ile aynı
    kuralı uygular: config.dumbbell verilmezse çiftler ve dönem adları seri
    adlarından türetilip yanıtın configine yazılır; geçersiz çift 400
    invalid_request alır (mesaj PATCHtekiyle aynı). Çift artık oluşturmadan
    itibaren kayıtlıdır; sonra seri adlarını değiştiren PUT için aşağıdaki
    (aynı gün) madde. Var olan grafikler değişmez. OpenAPI 1.0.0-preview.66.
  • 2026-10-29 — ayar keşfinin değerleri ayarın kendi türünde. GET /chart-options
    ve GET /map-options yanıtındaki values sayı alanlarında da metin
    döndürüyordu (decimalPlaces için ["0", "1", "2", "3"]); listeden aynen
    yazılan "1" ise 400 invalid_request alıyordu. Artık değerler ayarın
    kendi JSON türünde gelir: colorPreset [0, 1, 2, 3, 4, 5],
    decimalPlaces [0, 1, 2, 3], smallMultiplesColumns [2, 3, 4, 5, 6];
    listelenen her değer confige aynen yazılabilir. Metin alanları ve harita
    ayarları değişmedi (harita keşfinde sayı seçenekli alan yok). values
    öğelerini metin varsayan istemci sayı da beklemelidir. Kabul kuralları
    değişmedi. OpenAPI 1.0.0-preview.65.
  • 2026-10-27 — pastada lejantın renk uyarıları yalnız dilim açan kategorileri
    sayar.
    Pasta lejantı artık dilim açmayan kategoriyi (değeri eksi, sıfır ya da
    sayı olmayan; çizilen hiçbir halkada ya da pastada pozitif değeri yok)
    listelemiyor; legend_hidden, single_color_series ve duplicate_colors da
    onu saymıyor (önce sayıyordu: count ve mesajdaki adlar o kategoriler kadar
    azalabilir; tek pastada tek dilim kalınca ya da hiçbir dilim çizilmiyorsa uyarı
    gelmez — boş grafiği nothing_drawn söyler). Boş hücreli kategori eskisi gibi
    sayılır. Kodlar, sıra ve yanıt şekli aynı; OpenAPI belgesi aynı
    (1.0.0-preview.64).
  • 2026-10-27 — yeni uyarı kodu: pie_negative_cells. Pasta yalnız pozitif
    değere dilim açar; karışık işaretli pastada eksi değerin dilimi çizilmiyordu ve
    warnings bunu söylemiyordu. Artık pie_negative_cells eksi değerleri sayar
    (count eksi değer sayısı — tek pastada yalnız çizilen ilk görünür seride;
    mesaj dilimleri kategori adıyla sayar). Hepsi eksi pastada nothing_drawn
    eskisi gibi en önde, yeni kod arkasında. Çizim değişmedi. Var olan kodların
    anlamı ve sırası aynı; yeni kod race_negative_cellsin ardından. OpenAPI
    1.0.0-preview.64.
  • 2026-10-27 — yeni uyarı kodu: race_negative_cells; nothing_drawn hepsi
    eksi yarışta da gelir.
    Yarış yalnız pozitif değere çubuk çizer; eksi değerli
    varlığın çubuğu çizilmiyordu ve warnings boş dönüyordu. Artık
    race_negative_cells eksi değerleri sayar (count eksi değer sayısı, mesaj
    varlıkları sayar). Görünen varlıkların hiçbir dönemde pozitif değeri yokken
    grafik boş çiziliyor ama warnings boş dönüyordu; artık nothing_drawn en
    önde gelir (pozitif değerler yalnız gizlenen varlıklardaysa mesaj gizlemeyi
    söyler). Çizim değişmedi. Var olan kodların anlamı ve sırası aynı; yeni kod
    race_over_limitin ardından. OpenAPI 1.0.0-preview.63.
  • 2026-10-27 — gizleme nedenli nothing_drawn mesajı yalnız işe yarayan yolu
    önerir.
    Ölçümler yalnız gizlenen serilerde (ya da kategorilerde) iken mesaj
    her durumda "o serileri listeden çıkar" diyordu; gizlenen değerler de sıfır,
    sayı değil ya da pastada eksiyse listeden çıkarmak grafiği çizdirmiyordu. Artık
    mesaj bunu söyler ve gizleme kalkınca grafiğin boş kalma nedenini çözümüyle
    ekler. Pastada görünen kısımda pozitif değer yokken pozitif değerler yalnız
    gizlenen kısımdaysa mesaj nedenin gizleme olduğunu söyler (öncesinde "pastada
    pozitif değer yok" diyordu). code ve OpenAPI belgesi aynı
    (1.0.0-preview.62).
  • 2026-10-27 — nothing_drawn eksi değerli pastada da gelir. Pasta yalnız
    pozitif değere dilim açar; görünen serilerin hiçbirinde pozitif değer yokken
    (hücreler eksi, sıfır, boş ya da sayı değil) grafik boş çiziliyor ama
    warnings boş (ya da yalnız empty_cells, text_cells, legend_hidden,
    pie_series_not_drawn) dönüyordu. Artık nothing_drawn gelir, mesaj nedeni
    söyler. Tek seri modunda (pie.mode: "single") ilk görünür seri eksiyken de
    gelir (öncesinde yalnız boş, sıfır ya da sayı olmayan hücrede geliyordu). Tek
    seri modunda nedeni gizleme olan nothing_drawn mesajı artık ilk görünür seri
    kuralını söyler: gizlenen seriyi hiddenSeriesten çıkarmak, ondan önce görünen
    bir seri varken onu çizdirmez. code açıklaması kuralı sayar. OpenAPI
    1.0.0-preview.62.
  • 2026-10-27 — nothing_drawn tek pastada ve dumbbell'de de gelir. Tek
    seri modundaki pastada (pie.mode: "single", varsayılan) çizilen ilk görünür
    serinin hücreleri boş, sıfır ya da sayı değilken — öteki seriler dolu olsa da
    — ve dumbbell'de tabloda tek değer sütunu varken, dumbbell.pairsteki seriler
    tabloda yokken ya da hiçbir kategoride bir çiftin iki ucu birlikte sayı
    değilken grafik boş çiziliyor ama warningste nothing_drawn yoktu (yalnız
    pie_series_not_drawn, empty_cells, text_cells ya da missing_columns
    geliyordu, bazen hiçbir şey). Artık nothing_drawn en önde gelir, mesaj
    nedeni söyler; count satır sayısıdır, öteki uyarılar eskisi gibi arkasından
    gelir. Ayar keşfinde (/chart-options) showLabels açıklaması dumbbell'i
    değer etiketi yazılan yerler arasında saymaz (dumbbell değer yazmaz). OpenAPI
    1.0.0-preview.61.
  • 2026-10-26 — nothing_drawn grafiğin boş çizildiği her durumda gelir.
    Grafik boş çizildiği hâlde warnings çoğu durumda bunu söylemiyordu: değer
    hücrelerinin hepsi boş, sıfır ya da sayı olarak okunamıyorken (çubukta
    yalnız legend_hidden geliyordu), ölçümler yalnız gizlenen serilerde ya da
    kategorilerdeyken, tabloda değer sütunu yokken, piramidin kanatları
    çözülemiyorken (yalnız missing_columns), yarışta gösterilecek varlık,
    dağılımda çizilecek nokta (yalnız scatter_over_limit) ya da ağaç
    haritasında pozitif değer yokken (yalnız treemap_invalid_rows). Artık
    nothing_drawn gelir, mesaj nedeni söyler. Kural tek: grafiğin yerinde
    nedeni yazan boş durum yazısı çıkıyorsa gelir, grafik çiziliyorsa gelmez. nothing_drawn en öndedir, count satır sayısıdır; var
    olan kodların anlamı ve sırası değişmedi, yanlarındaki uyarılar eskisi gibi
    gelir. code açıklaması kuralı sayar. OpenAPI 1.0.0-preview.60.
  • 2026-10-26 — nothing_drawn yarışta gizlemeyi ve piramidin yüzde
    biçimini de söyler.
    Çok serili yarışta görünen varlıkların hücreleri boş,
    hepsi sıfır ya da sayı değilken ve ölçümler yalnız config.hiddenSeries ile
    gizlenen serilerdeyken grafik boş çiziliyor ama warnings boş (ya da yalnız
    text_cells) dönüyordu; artık nothing_drawn gelir ve mesaj nedenin gizleme
    olduğunu söyler. Piramidin yüzde biçiminde hiçbir kategorinin yüzdesi
    hesaplanamıyorsa da gelir — iki kanadın toplamı sıfır ya da eksi olduğunda
    eskiden hiç uyarı yoktu; boş ya da metin kanatta empty_cells / text_cells
    eskisi gibi arkasından gelir. nothing_drawn en öndedir, count satır
    sayısıdır; var olan kodların anlamı ve sırası değişmedi, code açıklaması iki
    kapsamı da sayar. OpenAPI 1.0.0-preview.59.
  • 2026-10-26 — nothing_drawn dağılımda gizlemeyi de söyler. Dağılımda
    noktası olan her varlığın x ya da y serisi config.hiddenSeries ile
    gizliyken (ya da ölçümler yalnız gizlenen serilerdeyken) grafik boş
    çiziliyor ama warnings boş dönüyordu. Artık nothing_drawn gelir (en
    önde, count satır sayısı); mesaj nedenin gizleme olduğunu ve hangi listeden
    çıkarılacağını söyler. Gizleme kalkınca grafik çizilir; gizlemesiz de boşsa
    uyarı eskisi gibi gelmez. Var olan kodların anlamı ve sırası değişmedi;
    code açıklaması bu kapsamı da sayar. OpenAPI 1.0.0-preview.58.
  • 2026-10-26 — empty_cells ve text_cells dumbbell'de gizli dönemi de
    sayar.
    Dumbbell'de gizleme uygulanmaz: config.hiddenSeries ile gizlenen
    dönem (grafik başka bir tipteyken gizlenmiş olabilir) çizilmeye devam eder,
    ama o dönemin boş ve metin hücreleri bu iki uyarıda sayılmıyordu. Artık
    sayılır (çizimle aynı hücreler). Kodlar, mesaj kalıbı ve sıra aynı; yanıt
    şekli değişmediği için OpenAPI sürümü değişmedi.
  • 2026-10-26 — Ayar keşfi: axisMin / axisMax açıklaması.
    GET /chart-options bu iki alan için yalnız "değer ekseninin alt/üst sınırı"
    diyordu; pastada, ağaç haritasında, süre çizelgesinde, yarışta ve dağılımda
    değer kaydedilir ama çizimi değiştirmez. Açıklama artık bu beş tipi sayar.
    Piramidin simetrik ekseni ve çoklu grafiğin bağımsız ölçeği kendi
    alanlarının açıklamasında (diverging.symmetricAxis · smallMultiplesScale).
    Alanlar, kabul edilen değerler ve çizim değişmedi. OpenAPI
    1.0.0-preview.57.
  • 2026-10-26 — Açıklama: ağaç haritasının büyüklük sütunu. Büyüklük
    sütunu kendiliğinden seçilirken yıl ya da tarih gibi okunan sütun artık
    yalnız başka sayı sütunu yoksa seçilir (ör. Ülke · Yıl · Nüfus tablosunda
    Nüfus). Grafik tipi açıklaması ve missing_columns açıklaması bunu söyler.
    OpenAPI 1.0.0-preview.56.
  • 2026-10-25 — text_cells yarış, dağılım ve süre çizelgesini de kapsar.
    Sayı olmayan düz metin yarışta o dönemin 0 ölçümü sayılıyor (çubuk sıfıra
    iniyor), dağılımda noktayı o eksende 0'a çiziyor, süre çizelgesinin önem
    sütununda önemi 0 yapıyordu ve warnings boş dönüyordu. Artık bu tiplerde de
    text_cells sayar (çizimin okuduğu hücrelerde); mesaj etkiyi tipe göre söyler.
    Çizim değişmedi. Kod, sıra ve öteki tiplerin mesajı aynı; code açıklaması
    kapsamı sayar. OpenAPI 1.0.0-preview.55.
  • 2026-10-25 — missing_columns: başlığı boş piramit kanadı adıyla değil
    sırasıyla söylenir.
    Veriyi yazarken piramidin kanadı yeniden türetildiğinde
    ve türetilen serinin başlığı boşsa mesaj kanadı sol "" diye yazıyordu.
    Artık sırasını söyler (sol 1. seri (adı boş)). Kod, count ve uyarıların
    sırası değişmedi. OpenAPI 1.0.0-preview.54.
  • 2026-10-25 — nothing_drawn: yalnız boş satırlı süre çizelgesinde mesaj
    düzeltildi.
    Süre çizelgesinin satırlarının hepsi tamamen boşken (hiçbir
    hücre dolu değilken) nothing_drawn mesajı "hangi satırların neden
    çizilmediğini timeline_invalid_dates sayar" diyordu, ama o uyarı gelmiyordu
    (tamamen boş satır olay sayılmaz). Artık mesaj satırların boş olduğunu ve
    başlangıç sütununu adıyla söyler. Kod, count, uyarıların sırası ve öteki
    durumların mesajı değişmedi. OpenAPI 1.0.0-preview.53.
  • 2026-10-25 — yeni uyarı kodu: text_cells. Sayı olmayan düz metin
    taşıyan değer hücresi ("abc", "12 milyon") grafikte sıfır çiziliyor
    (piramit ve dumbbell'de hiç çizilmiyor) ve warnings boş dönüyordu (virgüllü
    ondalık ve birim işareti zaten comma_decimal_cells · formatted_number_cells
    ile söyleniyordu). Artık text_cells sayar; çizim DEĞİŞMEDİ. Çubuk, çizgi,
    alan, yığın, pasta, piramit ve dumbbell'de, empty_cells ile aynı hücrelerde
    sayılır; mesaj etkiyi tipe göre söyler. Var olan kodların anlamı ve sırası değişmedi; yeni kod
    formatted_number_cellsin ardından gelir. OpenAPI 1.0.0-preview.52.
  • 2026-10-25 — missing_columns dumbbell çiftini ve piramidi de kapsar.
    Veriyi PUT /charts/{chartId}/data ile yazarken dumbbell çiftinin serisi ya
    da piramidin kanadı tabloda kalmazsa warnings boş dönüyordu: o çift
    sessizce çizilmiyor (hepsi bayatsa grafik boş), piramitte kanatlar yeniden
    türetiliyor (yön ters dönebiliyordu) ya da grafik hiç çizilmiyordu; kategori
    sırasındaki eski satır adı sessizce atlanıyordu. Artık bunlar missing_columns
    ile söylenir (yukarıda "Grafiğin içeriği"). Yeni kod yok; var olan kodların
    anlamı ve sırası değişmedi, yalnız missing_columnsın kapsamı genişledi.
    PUT …/data ayarlara yine dokunmaz. OpenAPI 1.0.0-preview.51.
  • 2026-10-25 — nothing_drawn süre çizelgesinde doğru nedeni söyler.
    Süre çizelgesinin eşlemesi doğruyken hiçbir olayın başlangıç tarihi
    kullanılamıyorsa ("20.07.1969", Excel gün sayısı, boş hücre ya da her
    olayın bitişi başlangıcından önce) nothing_drawn mesajı "başlangıç/bitiş
    eşlemesi olmadan çizilemez" diyordu. Artık tarihi söyler ve satırları sayan
    timeline_invalid_datese işaret eder; eşleme gerçekten yoksa mesaj aynı.
    Kod, count ve uyarıların sırası değişmedi; code alanının açıklaması bu
    kapsamı da sayar. OpenAPI 1.0.0-preview.50.
  • 2026-10-25 — Ayar keşfi: showLabels açıklaması düzeltildi.
    GET /chart-options showLabels için "değer etiketleri çubukların/noktaların
    üstüne yazılsın mı" diyordu; dağılımda noktalara değer hiç yazılmaz, yarışta
    ve süre çizelgesinde de bu ayar çizimi değiştirmez. Açıklama artık değerin
    yazıldığı yerleri sayar ve bu üç tipi söyler: yarışta çubuk ucundaki değeri
    race.showValues açıp kapar, dağılımda noktanın yanındaki yazı addır
    (scatter.showNames). Ayarın kendisi, kabul edilen değerler ve çizim
    değişmedi. OpenAPI 1.0.0-preview.49.
  • 2026-10-20 — Yeni uyarı: missing_columns (ağaç haritası · zaman bağlaması).
    timeline_missing_columnsin genel ikizi. Veriyi PUT /charts/{chartId}/data
    ile yazarken ağaç haritasının kutu adı, büyüklük ya da grup sütunu ya da zaman
    bağlamasının sütunu tabloda yoksa ayar eski adda kalıyordu ve warnings boş
    dönüyordu (zaman bağlaması yalnız yarışta nothing_drawn ile görünüyordu):
    kutular gruplanmadan, başka bir sütunun değeriyle çiziliyor; çizgi ve çubukta
    zaman ekseni sessizce kayboluyordu. Artık bu durum missing_columns ile
    söylenir (yukarıda "Grafiğin içeriği"). PUT …/data ayarlara yine dokunmaz;
    grafik editörde açılınca bayat ayar düşer. Var olan kodların anlamı ve sırası
    değişmedi; yeni kod timeline_missing_columnsin ardından, görsel uyarılardan
    önce gelir. OpenAPI 1.0.0-preview.48.
  • 2026-10-19 — Yeni uyarı: timeline_missing_columns (süre çizelgesi).
    Veriyi PUT /charts/{chartId}/data ile yazarken bir süre çizelgesi rolünün
    sütunu tabloda yoksa (adı değişmiş ya da sütun kalkmış) rol eski adda
    kalıyordu ve warnings boş dönüyordu: bitiş sütunu kalkınca bütün olaylar
    nokta, şerit sütunu kalkınca tek şerit çiziliyordu. Artık bu durum
    timeline_missing_columns ile söylenir (yukarıda "Grafiğin içeriği").
    PUT …/data ayarlara yine dokunmaz. Var olan kodların anlamı ve sırası
    değişmedi; yeni kod timeline_invalid_datesin ardından, görsel uyarılardan
    önce gelir. OpenAPI 1.0.0-preview.47.
  • 2026-10-19 — Yeni uyarı: timeline_invalid_dates (süre çizelgesi).
    Tarihi kullanılamayan olaylar warningste iz bırakmıyordu: başlangıcı boş
    ya da tarih olmayan satır ve bitişi başlangıcından önce olan olay çizilmiyor,
    bitişi tarih olmayan olay ("devam ediyor", "20.07.1991", Excel gün
    sayısı) bant yerine nokta çiziliyordu. Artık bu olaylar
    timeline_invalid_dates ile sayılır (yukarıda "Grafiğin içeriği"). Aynı
    turda bir çizim kusuru düzeldi: başlangıç ve bitiş farklı hassasiyetteyken
    ("1985-03" → "1990") "bitiş önce mi" kararı farklı birimleri
    karşılaştırıyordu — geçerli olay çizilmiyor, gerçekten önce biten
    ("1990" → "1989-12") çiziliyordu. Artık bitiş, başlangıcın ilk anından
    önce biterse önce sayılır. Bitişteki "-" boş sayılır (nokta olay; eskiden
    de nokta çiziliyordu). Var olan kodların anlamı ve sırası değişmedi; yeni
    kod timeline_over_limitin ardından, görsel uyarılardan önce gelir. OpenAPI
    1.0.0-preview.46.
  • 2026-10-18 — Vurgu rengi öteki renk alanlarıyla aynı biçimleri alır.
    config.highlight.color yalnız #RRGGBB kabul ediyordu: #abc, #0077B6CC,
    rgba(0, 119, 182, 0.5), hsl(…) ya da navy gibi geçerli bir renk 400
    alıyordu ve mesajı öteki renk alanlarınınkinden farklıydı. Artık öteki renk
    alanlarıyla aynı kural geçerli (yukarıda "Renkler ve yazı tipi"): bu biçimler
    kabul edilir, geçersiz değer aynı mesajla reddedilir. Yalnız genişleme — daha
    önce kabul edilen her değer yine kabul edilir. Ayar keşfi
    (GET /chart-options) renk alanlarında artık kabul edilen biçimlerin
    tamamını söyler (eskiden yalnız #RRGGBB diyordu). OpenAPI
    1.0.0-preview.45.
  • 2026-10-18 — Çok serili yeni grafik lejant açık doğar. legend_hidden
    uyarısı geldiğinden beri POST /projects/{projectId}/charts ile kurulan her
    çok serili çubuk, çizgi, alan ve yığın grafik bu uyarıyla doğuyordu, çünkü
    lejant varsayılan olarak kapalıydı. Artık böyle bir grafik
    config.showLegend: true ile oluşur ve uyarı gelmez. showLegend ya da
    legend.visible gönderirsen seninki kalır; tek serili grafik, çoklu grafik,
    pasta, dumbbell ve piramit eskisi gibi oluşur. Var olan grafikler değişmez ve
    PATCH lejanta dokunmaz. Tuvelia'daki Yeni öğe de aynı kuralı izler.
    OpenAPI 1.0.0-preview.44 (aynı turdaki renk denetimiyle tek sürüm).
  • 2026-10-18 — Renk ve yazı tipi değerleri artık biçim denetiminden geçer.
    Grafik ve haritanın renk alanlarına ve grafiğin fontFamily alanına her metin
    yazılabiliyordu: url(…), var(--x) ya da ; içeren bir değer 200 alıyor,
    ama Tuvelia onu hiçbir yerde çizmiyor, yerine varsayılan rengi ya da yazı
    tipini basıyordu — yanlış değer sessizce yok sayılıyordu. Artık
    POST /projects/{projectId}/charts, PATCH /charts/{chartId},
    POST /projects/{projectId}/maps ve PATCH /maps/{mapId} geçerli bir CSS
    biçiminde olmayan değeri 400 invalid_request ile reddeder; mesaj alanın
    yolunu, gelen değeri ve kabul edilen biçimleri söyler (yukarıda "Grafiği
    güncellemek" ve "Harita oluşturmak ve veri yazmak"). ⚠ Kısıtlayıcı değişiklik
    (önizleme kapsamında): daha önce 200 alan bu değerler artık reddedilir.
    Onaltılık renkler, yalnız sayılarla rgb()/rgba()/hsl()/hsla(), CSS
    renk adları ve transparent eskisi gibi kabul edilir. Kayıtlı grafikler ve
    haritalar değişmez; Tuvelia'daki düzenleme ve marka kitleri bu kurala tabi
    değildir. OpenAPI 1.0.0-preview.44.
  • 2026-10-18 — GET /geographies ülkenin İngilizce adını da arar. q
    artık bölgenin Türkçe adına ek olarak ülkenin İngilizce ve tam Türkçe adını
    da tanır: germany, united states ve amerika eskiden boş dönüyordu, şimdi
    Almanya'nın ve ABD'nin coğrafyalarını bulur (yukarıda "Harita coğrafyaları ve
    kapsam"). Adı tartışmalı bölgelerde (Kıbrıs, Kosova, Filistin) yalnız
    Tuvelia'daki ad aranır. Eskiden bulunan her sonuç yine bulunur, liste yalnız
    genişledi; uç, alan ve yanıt biçimi değişmedi — yanıttaki adlar Türkçe kalır.
    OpenAPI 1.0.0-preview.43.
  • 2026-10-18 — Yeni görsel uyarı: point_names_hidden. Dağılımda
    scatter.showNames: false yazmak nokta adlarını grafikten tamamen
    kaldırıyordu — lejant olmadığı için hangi noktanın ve hangi rengin hangi varlık
    olduğu hiçbir yerde kalmıyordu — ama warnings boş dönüyordu. Artık bu
    durumda point_names_hidden gelir; count adı yazılmayan nokta sayısıdır
    (yukarıda "Grafiğin içeriği"). Aynı ayar artık Tuvelia'da da var
    (Düzen › Dağılım eşleştirme › Nokta adları), yani kullanıcı adları geri
    açabilir.
    Var olan kodların anlamı ve sırası değişmedi; yeni kod listenin sonunda gelir.
    OpenAPI 1.0.0-preview.42.
  • 2026-10-18 — decimalPlaces artık 0–3 arası tam sayı. Ondalık basamak
    sayısı sınırsızdı: 101, 1e9 ya da (decimalMode: "fixed" ile) -1
    yazmak 200 alıyordu ama grafik Tuvelia'da, gömmede, dışa aktarmada ve
    videoda hiç açılmıyordu. Artık PATCH /charts/{chartId} ve
    POST /projects/{projectId}/charts 0–3 dışını ve tam sayı olmayan değeri
    400 invalid_request ile reddeder; sınır Tuvelia'daki Ondalık
    seçicisiyle aynıdır. ⚠ Daha önce 200 alan 4…100 de artık reddedilir
    (önizleme kapsamında kısıtlayıcı değişiklik); kayıtlı grafikler etkilenmez.
    GET /chart-options alanı değer kümesiyle (0…3) listeler. Önceden
    kaydedilmiş değer okunurken olduğu gibi döner; 100'den büyük değer 3, negatif
    değer 0 basamakla çizilir (yukarıda "Grafiği güncellemek"). OpenAPI
    1.0.0-preview.41.
  • 2026-10-18 — colorPreset artık 0–5 arası tam sayı. Hazır palet
    indeksi sınırsızdı: 9, -1 ya da 1.5 yazmak 200 alıyordu ama grafik
    Tuvelia'da, gömmede ve videoda hiç açılmıyordu. Artık PATCH /charts/{chartId}
    ve POST /projects/{projectId}/charts aralık dışı ve tam sayı olmayan değeri
    400 invalid_request ile reddeder; mesaj altı paleti adlarıyla sayar.
    GET /chart-options alanı değer kümesiyle (0…5) listeler. Önceden aralık
    dışı değerle kaydedilmiş grafik okunurken olduğu gibi döner ve Okyanus
    paletiyle çizilir (yukarıda "Grafiği güncellemek"). Geçerli değerlerin anlamı
    ve çizimi değişmedi. OpenAPI 1.0.0-preview.40.
  • 2026-10-18 — Yeni görsel uyarı: duplicate_colors. Tek renk seçilmediği
    hâlde iki öğe aynı renge düşebiliyordu ve warnings boş dönüyordu: hazır
    paletin beş rengi altıncı seride baştan döner (yeni grafiklerin varsayılan
    kiti de beş renklidir), customColorsta aynı renk iki kez geçebilir ya da
    liste kısa kalıp varsayılan palete düşen renk listedekiyle çakışabilir. Artık
    bu durumda duplicate_colors gelir; count renk paylaşan öğe sayısıdır
    (yukarıda "Grafiğin içeriği"). Var olan kodların anlamı ve sırası değişmedi;
    yeni kod listenin sonunda gelir. OpenAPI 1.0.0-preview.39.
  • 2026-10-18 — legend_hidden ve single_color_series üç durumu daha
    kapsıyor.
    Renklerin anahtarı yalnız lejantta olduğu hâlde warnings boş
    dönüyordu: dilim etiketi kapalı (showLabels: false) tek pasta, renk
    kategorisi (timeline.colorColumn) şeritten ve olay adından ayrı olan süre
    çizelgesi, grup başlığı kutusuna sığmayan ağaç haritası grupları. Artık lejant
    kapalıyken legend_hidden, etiketsiz tek pastada tek renk seçiliyse
    single_color_series gelir (yukarıda "Grafiğin içeriği"). Ağaç haritasında
    count başlığı sığmayan grup sayısıdır. Yeni kod yok; kodların anlamı
    genişledi, açıklamaları güncellendi. OpenAPI 1.0.0-preview.38.
  • 2026-10-18 — GET /geographies araması Türkçe karakter ve aksan duyarsız.
    q artık Tuvelia'daki Coğrafya panelinin Bölge ara kutusuyla aynı kuralla
    eşleşir: turkiye, kibris, ISPANYA ve ilceler eskiden boş dönüyordu,
    şimdi Türkiye'yi, Kıbrıs'ı, İspanya'yı ve ilçe düzeyindeki coğrafyaları bulur
    (yukarıda "Harita coğrafyaları ve kapsam"). Eskiden bulunan her sonuç yine
    bulunur, liste yalnız genişledi; yalnız boşluktan oluşan q artık süzmez.
    Uç, alan ve yanıt biçimi değişmedi. OpenAPI 1.0.0-preview.37.
  • 2026-10-18 — üç yeni GÖRSEL uyarı kodu: pie_series_not_drawn ·
    single_color_series · legend_hidden.
    İki serili grafiğe tek renk vermek,
    iki serili grafiği pastaya çevirmek ve lejant kapalıyken veriyi iki seriye
    çıkarmak grafiği okunmaz yapıyordu ama warnings boş dönüyordu. Artık her biri
    bir kod, sayı ve düzeltmeyi söyleyen bir mesajla gelir (yukarıda "Grafiğin
    içeriği"). warnings açıklaması "çizilmeyen ya da çizilip okunamayan" diye
    genişledi; count artık seri, dönem ya da kategori de sayabilir. Ekleme
    yapıldı, var olan bir kodun anlamı değişmedi. OpenAPI 1.0.0-preview.36.
  • 2026-10-17 — yeni uyarı kodu: formatted_number_cells. Birim işareti
    (₺ $ € £ % TL) ya da boşluklu binlik taşıyan hücreler sıfır çiziliyordu ve
    warnings bunu söylemiyordu; artık sayıyla bildiriyor. Böyle bir hücre
    comma_decimal_cellste sayılmaz ("₺806,2" eskiden de orada sayılmıyordu).
    Ekleme yapıldı, var olan bir kodun anlamı değişmedi. OpenAPI 1.0.0-preview.35.
  • 2026-10-08 — grafik ayarında smallMultiplesAxisTitles (Tuvelia'nın iç ayarı): çoklu grafik
    panellerinin dikey eksen başlıkları, [{ panel, title }] — panel adı seri ya da kategori adı, başlık en
    çok 80 karakter, en çok 200 başlık. Veride olmayan panel ve aynı panele ikinci başlık 400. Başlıklar
    translations.{dil}.labels ile çevrilir. OpenAPI 1.0.0-preview.34.
  • 2026-10-08 — grafik translations içinde labels: seri ve kategori ADLARININ çevirisi.
    { "en": { "labels": { "Güney Kore": "South Korea", "Ar-Ge (%GSYH)": "R&D (% of GDP)" } } } —
    anahtar ana dildeki ad (TAM eşleşme), değer o dildeki ad; en çok 2.000 ad. O dilin canlı gömmesinde,
    görselinde, PDF'inde ve videosunda grafiğin her yerinde (kart başlığı, eksen, vurgu, hücre notu,
    gizleme) bu ad kullanılır; veri ana dilde kalır. İsteğe bağlı; translations yine BÜTÜN yazılır.
    Yalnız ad çevirisi olan dil de published.urls.liveByLocaleda görünür. OpenAPI 1.0.0-preview.33.
  • 2026-10-08 — grafik ayarında çoklu grafik alanları (Tuvelia'nın iç ayarları; söz verilen alanlar
    değişmedi): smallMultiplesColumns artık 2–6 · smallMultiplesScale (shared | independent) ·
    highlight ({ category, color }) · cellNotes ([{ category, series, text }], en çok 200).
    highlight ve cellNoteste veride olmayan ad ve aynı hücreye ikinci not 400 ile reddedilir (mevcut
    adlar mesajda sayılır).
  • 2026-10-05 — published.urls.liveByLocale eklendi. Tek grafik ve tek harita
    yanıtlarında, ana dil dışında en az bir alanı çevrilmiş her dil için canlı adres:
    { "en": "https://tuvelia.com/embed/{id}/live/en" }. live ana dildir; çeviri yoksa
    alan hiç gelmez. Durağan görüntü (page, svg) yalnız ana dildedir. oEmbed ucu
    …/live/{dil} adresini de kabul eder.
  • 2026-10-05 — grafik ve harita ayarında translations eklendi (aynı öğede iki dil).
    İsteğe bağlı; anahtar dil (en), değer { fields: { … } }. Grafikte alanlar:
    title · subtitle · xAxisTitle · yAxisTitle · tooltipLabel · valuePrefix ·
    valueSuffix · sourceLabel · sourceName · dataAsOf · footerText; haritada:
    title · legendTitle · sourceLabel · source · note. locale ana dildir; ana
    dilin metinleri kendi alanlarında kalır. Bilinmeyen alan ya da dil reddedilir, metin en
    çok 500 karakter. Alan bütün yazılır (bir dili güncellerken önce oku, birleştir,
    tamamını gönder). Yayın ve dışa aktarma bugün ana dilde üretilir.
  • 2026-10-05 — grafik ayarında locale eklendi. İsteğe bağlı locale: "tr" | "en"
    (yoksa tr): grafiğe sistemin bastığı metinlerin dili — künye etiketleri (Veri
    tarihi/Data as of · Oluşturulma/Created · Güncellenme/Updated · Lisans/License ·
    Atıf/Cite), boş tuval yazısı, pasta/ağaç haritası ipucu satırları, künye
    tarihlerinin ve zaman ekseninin ay adları, yüzde işaretinin yeri (%25 / 25%).
    Sayı biçimi numberFormatta kalır. sourceLabel ve tooltipLabel kayıtlı
    metinlerdir; dili değiştirirken eski dilin varsayılanını taşıyorlarsa yenisini
    (Source/Value) de gönder. GET /chart-options alanı listeler. Ayrıca pasta
    ipucundaki yüzde artık grafiğin ondalık ayracını kullanır (Türkçe biçimde
    eskiden %25.0 yazıyordu).
  • 2026-10-05 — harita ayarında locale eklendi. İsteğe bağlı locale: "tr" | "en"
    (yoksa tr): haritaya sistemin bastığı metinlerin dili — künye ön ekinin
    varsayılanı (Kaynak/Source; meta.sourceLabel yazılmışsa o kalır), "veri yok"
    yazıları, sınır atfının öneki, dönem adları ve büyük sayı kısaltma harfleri (tr
    B/Mn/Mr = bin/milyon/milyar · en K/M/B). Başlık, kaynak adı, not ve bölge
    adları çevrilmez; sayı ayraçları değişmez. GET /map-options alanı listeler.
  • 2026-09-24 — boş hücre artık hiçbir tipte 0 çizilmez. Çizgi ve alan boş
    hücrede kopar, çubuk ve yığın o hücreye çubuk/dilim çizmez (yığının boyu yalnız
    dolu hücrelerin toplamı). empty_cells uyarısının mesajı buna göre değişti
    ("0 olarak çiziliyor" yerine tipe göre etki); kod ve sayım aynı. Sayıya
    çevrilemeyen metin boş sayılmaz, comma_decimal_cells ile sıfır çizilmeye devam
    eder.
  • 2026-09-24 — yeni uyarı kodu empty_cells. Grafiğin çizdiği değer
    hücrelerinden boş olanlar (boş, boşluk ya da -) sayılır; mesaj tipe göre ne
    olduğunu söyler (o gün çubuk/çizgi/alan/yığında 0 çiziliyordu — yukarıdaki kayıt;
    pastada dilim, piramitte kanat, dumbbell'da çift düşer). Piramidin yüzde modunda tek kanadı boş olan
    kategori artık hiç çizilmez (eskiden dolu kanat %100 çiziliyordu). warnings[].code
    açıklaması artık bütün kodları sayar (nothing_drawn ve comma_decimal_cells
    eksikti).
  • 2026-09-24 — decimalMode eklendi. Grafik ayarında isteğe bağlı
    decimalMode: "auto" | "fixed". auto fazla basamağı gösterimde kırpar
    (|değer| ≥ 1 ise en çok 2 ondalık, küçük değerlerde 2 anlamlı basamak);
    fixed decimalPlacesi aynen uygular (0 = tam sayıya yuvarla). Alan yoksa
    decimalPlaces > 0 ise fixed, 0 ise auto sayılır. Önceden decimalPlaces: 0
    hiç yuvarlamıyordu ve Türkçe biçimde ondalık noktayla yazılıyordu.
  • 2026-09-24 — styleId değişimi değiştirilmiş alanları korur. Stil
    değiştiğinde krom renkleri, fontFamily, borderRadius ve depth yalnız
    önceki stilin varsayılanında duruyorsa yeni stile geçer; marka kitinden ya da
    elle yazılmış değer korunur. Seçilen depth yeni stil ve tipte kapalıysa yeni
    stilin derinliği yazılır. Önceden stil değişimi bu alanların hepsini yeniden
    yazıyordu.
  • 2026-09-24 — showFooter artık kaynağı gizlemiyor. showFooter: false
    yalnız künyenin dipnot kısmını (veri tarihi, oluşturma/güncelleme tarihi, not
    metni, atıf düğmesi, marka satırı) gizler. Kaynak adı ve lisans yalnız
    showSource ile yönetilir. Önceden showFooter: false kaynak ve lisansı da
    gizliyordu; bu grafiklerde kaynak artık görünür.
  • 2026-09-23 — harita colorScale.mode açıklaması düzeltildi (belge
    düzeltmesi).
    Açıklama "threshold sınırları domainden okur" diyordu; bu,
    eşiklerin elle verilebileceğini düşündürüyordu. Doğrusu: threshold bugün
    quantize ile aynı çizer — en küçük ile en büyük değer (domain ya da veri)
    arasını eşit basamaklara böler; elle eşik girişi yoktur. Davranış değişmedi.
  • 2026-09-23 — sortOrder açıklaması düzeltildi (belge düzeltmesi).
    Açıklama yalnız ağaç haritasının bu ayarı yok saydığını söylüyordu; aslında
    kendi sırasını kuran beş tip yok sayıyor: diverging (veri sırası) ·
    treemap (büyükten küçüğe) · race (her an değere göre) · scatter (konum
    değerden gelir) · timeline (zamana göre). Davranış değişmedi; yalnız
    açıklama doğru oldu.
  • 2026-09-23 — grafikte "değere göre" renk. config.colorMode yeni bir
    değer alıyor: value. Tek serili bar ve pie grafikte her çubuk ya da
    dilim değerine oranlı boyanır; en küçük değer rampanın en açık, en büyük
    değer en koyu rengini alır. Rampa colorPreset ile seçilir (Pastel rampa
    değildir, Okyanus kullanılır). Başka her grafikte value, preset gibi
    davranır. Ekleme yapıldı; var olan değerlerin anlamı değişmedi.
  • 2026-09-22 — hazır gömme kodu için oEmbed ucu. Yeni, anahtarsız uç
    GET https://tuvelia.com/oembed?url={yayın adresi}: yayındaki bir grafiğin,
    haritanın, karşılaştırmanın ya da zaman tünelinin gömme kodunu Tuvelia'nın
    paylaşım penceresindeki kodla aynı biçimde döndürür. /api/v1 altında değildir
    ve bir oEmbed standardı ucudur. Yayın bilgisindeki (published) açıklamalar
    artık yalnız grafiği değil haritayı da anlatıyor. Ekleme yapıldı; var olan
    hiçbir uç değişmedi.
  • 2026-09-22 — grafik künyesi Türkçe; yeni grafiklerde kaynak etiketi
    Kaynak.
    sourceLabel verilmeden oluşturulan grafikler artık Kaynak
    ile başlar (eskiden Source); daha önce oluşturulmuş grafiklerin kayıtlı
    etiketi değişmez. Künyedeki sabit etiketler Türkçe basılır: Veri tarihi: ·
    Oluşturulma: · Güncellenme: · Atıf.
  • 2026-09-22 — grafikte alt eksen adlarının açısı. Yeni opsiyonel ayar
    xAxis.labelAngle: horizontal (varsayılan, alan yoksa da böyle) ·
    diagonal (45°) · vertical · auto (yatay sığmıyorsa 45°, o da sığmıyorsa
    dikey). Yalnız dikey çubuk, yığılmış, çizgi, alan ve dikey dumbbell'da
    etkilidir. Döndürülmüş adlar alttan yer açar; grafik yüksekliğinin %40'ına
    sığmayan ad "…" ile kısalır. Her grafik tipinin ayar keşfinde görünür.
  • 2026-09-22 — haritada "Made with Tuvelia" satırı. Yeni opsiyonel ayar
    showBranding (üst düzeyde, metanın dışında): yoksa açık, false
    gizler. Satır sağ altta, coğrafya atfının sonunda durur; atıf bundan
    bağımsızdır ve gizlenemez. ⚠ Görünüm değişikliği: alanı hiç yazılmamış
    mevcut haritalarda da satır artık görünür ve alt satır payı açılır.
  • 2026-09-21 — haritada değer etiketleri. Yeni opsiyonel ayar
    labels.mode: off (varsayılan, alan yoksa da böyle) · all · exports
    (yalnız video, indirilen görsel ve ZIP karelerinde; gömülü haritada ve hikâyede
    yazılmaz). Sığmayan bölgede etiket basılmaz. Nesne bütün yazılır.
  • 2026-09-21 — haritada iki yeni ayar: doğal kırılım ve kaynak etiketi.
    layers[].colorScale.mode artık natural değerini de alır: birbirine yakın
    değerleri aynı renk basamağında toplar, tek bir dev değeri kendi basamağına
    ayırır. meta.sourceLabel (opsiyonel, varsayılan Kaynak) künyede kaynağın
    önüne basılan ön ektir; harita ": " ekler. ⚠ Görünüm değişikliği: künye
    artık "Kaynak: TÜİK · not · lisans" biçiminde basılıyor (eskiden ön eksiz ve
    uzun tireyle); meta.source alanına ön eki ayrıca yazma.
  • 2026-09-21 — belge düzeltmesi: haritada iç içe ayar nesneleri bütün
    yazılır.
    PATCH /maps/{mapId} ayarları yalnız üst düzeyde birleştirir;
    meta, legend, scaleBar, locator ve animation gibi iç içe nesneler
    bütün olarak yazılır ve eksik alan reddedilir. Belge bunu artık açıkça
    söylüyor; hata mesajı da eksik alanın adını veriyor. Davranış değişmedi.
  • 2026-09-21 — haritanın coğrafyası değişince veri yeniden çözülüyor;
    okuma yanıtı da uyarıları adıyla veriyor.
    PATCH /maps/{mapId} ile
    geographyId değiştiğinde veri artık yeni coğrafyaya göre yeniden çözülüyor.
    ⚠ Davranış değişikliği: eskiden veri eski coğrafyanın kimlikleriyle
    kalıyordu ve değerler yeni haritada yanlış bölgelere boyanabiliyordu. Ham
    satırı olmayan eski bir kayıtta coğrafya değişimi artık anlaşılır bir hatayla
    reddediliyor. Aynı geographyId'yi yeniden göndermek artık değişim sayılmıyor
    ve kapsamı sıfırlamıyor. GET /maps/{mapId} ve PATCH yanıtlarındaki
    warnings, yazma yanıtıyla aynı kodları ve adları taşıyor; eskiden okuma
    yanıtı her çizilmeyen satırı unmatched_rows diye bildiriyordu. Yeni uyarı
    kodu: scheme_hidden_by_colors.
  • 2026-09-21 — harita verisinde sessiz kalan durumlar artık bildiriliyor.
    PUT /maps/{mapId}/data yanıtına dört yeni uyarı kodu eklendi:
    unreadable_values, ambiguous_number_cells, comma_decimal_cells ve
    mixed_id_types. Aynı ad ve dönem iki kez geldiğinde, zamansız haritada da
    aynı bölge iki kez geldiğinde, duplicate_rows artık bildiriliyor.
    ⚠ Davranış değişikliği: sayı olmayan bir değer (abc, N/A) eskiden
    sessizce 0 sayılıp çiziliyordu; artık çizilmiyor ve uyarıyla bildiriliyor.
    Boş değer eskisi gibi 0 sayılıyor.
  • 2026-09-21 — belge düzeltmesi: harita verisinde zamanı eksik satır
    reddedilmez.
    PUT /maps/{mapId}/data açıklaması ve bu sayfa "kısmi zaman
    reddedilir" diyordu; doğru değildi. Zamanlı bir yazımda at taşımayan ya da
    hassasiyeti farklı olan satır kaydedilir, çizilmez ve undeclared_period_rows
    uyarısıyla adıyla sayılır. Davranış değişmedi; yalnız anlatımı düzeltildi.
  • 2026-09-21 — harita ayarları keşfedilebilir oldu (GET /map-options) ve
    config.dataSource API'ye kapatıldı.
    Harita ayarlarının tamamı artık adı,
    türü, açıklaması ve geçerli değerleriyle listeleniyor — renk şeması ve
    basamak sayısı dahil. dataSource bir köken iddiası olduğu ve haritanın
    künyesine basıldığı için API ile yazılamaz hâle geldi; kaynak belirtmek için
    meta.source kullanılır. ⚠ Bu ikincisi kısıtlayıcı bir değişikliktir (önizleme
    kapsamında).
  • 2026-09-21 — haritalar yazılabilir oldu (üç yeni uç).
    POST /projects/{projectId}/maps · PATCH /maps/{mapId} ·
    PUT /maps/{mapId}/data. Veri ucu bölge adlarını coğrafyaya çözer ve
    eşleşmeyenleri warnings alanında adıyla sayar. Ekleme yapıldı; var olan
    hiçbir uç değişmedi.
  • 2026-09-21 — haritalar okunabilir oldu (beş yeni uç).
    GET /projects/{projectId}/maps · GET /maps/{mapId} · GET /geographies ·
    GET /geographies/{geographyId}/scope-parents · GET /region-presets.
    Harita oluşturma ve düzenleme henüz yok. Ekleme yapıldı; var olan hiçbir uç
    değişmedi.
  • 2026-09-20 — yayın bilgisi grafik yanıtına eklendi (published, stale).
    Bir grafiği API ile güncellediğinde yayındaki sürüm geride kalır; yanıt artık
    bunu söylüyor. Yayına gitmek insan onayıyla olur: API ile yeniden
    yayınlanamaz, kullanıcı Tuvelia'da "Yeniden yayınla" demelidir. Ekleme
    yapıldı.
  • 2026-09-20 — ayar açıklamaları. GET /chart-options artık her ayarın ne
    işe yaradığını da yazıyor; ayrıca temporal ve legend gibi her tipte
    geçerli ayar blokları alan alan listeleniyor (önce yalnız blok adı
    görünüyordu). Ekleme yapıldı.
  • 2026-09-20 — yeni uç: GET /chart-options. Ayarların adları yanıtlarda
    zaten görünüyordu ama seçenekli alanlarda hangi değerlerin geçerli olduğunu
    öğrenmenin yolu denemekti; artık listeleniyor. Ekleme yapıldı.
  • 2026-09-20 — yeni uyarı kodu: nothing_drawn. Zaman bağlaması olmayan
    yarış ve başlangıç sütunu bağlanmamış süre çizelgesi boş çiziliyordu ve yanıt
    bunu söylemiyordu; artık warnings sebebini ve çözümünü bildiriyor. Dağılım
    ve ağaç haritası eşlemeyi tablodan kendisi türetir; bu ikisinde uyarı yalnız
    türetecek sayı sütunu olmadığında gelir. Ekleme yapıldı, var olan bir kodun
    anlamı değişmedi. (Bu satır 2026-10-31'de düzeltildi: dağılım ve ağaç
    haritasını da eşlemesiz boş çizilen tipler arasında sayıyordu; ikisi o gün de
    eşlemeyi kendisi türetiyordu.)
  • 2026-09-20 — yeni uç: GET /chart-templates. createChartin template
    alanı ilk günden beri vardı ama geçerli kimlikleri öğrenmenin yolu yoktu; artık
    listelenebiliyor. Ekleme yapıldı, var olan hiçbir uç değişmedi.
  • 2026-09-20 — yeni uyarı kodu: comma_decimal_cells. Virgüllü ondalık
    taşıyan hücreler sıfır çiziliyordu ve yanıt bunu söylemiyordu; warnings
    artık bildiriyor. Ekleme yapıldı, var olan bir kodun anlamı değişmedi.
  • 2026-09-20 — ondalık ayırıcı netleşti. Örnekteki virgüllü sayı noktalıyla
    değiştirildi ve kural açıkça yazıldı: veri alanında ondalık ayırıcı noktadır.
    Davranış değişmedi; belge yanlış yönlendiriyordu (ajan denemesinde görüldü).
  • 2026-09-20 — önizleme başladı. API'nin ilk yayını.