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 vev1iç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.
| İstek | Ne yapar |
|---|---|
GET /projects | Projelerin, en yenisi önce: kimlik, ad, oluşturulma zamanı. Sayfa sayfa gelir (aşağıda Sayfalama). |
POST /projects | Yeni, boş bir proje oluşturur. |
GET /projects/{projectId}/charts | Projedeki grafikler, editördeki sırayla, sayfa sayfa. Veri ve ayar gelmez; yayındaki grafik gömme adresleriyle gelir. |
POST /projects/{projectId}/charts | Projeye 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}/data | Grafiğ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-templates | POST .../charts gövdesindeki template alanına yazabileceğin başlangıç şablonları. |
GET /chart-options | Ayarları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}/maps | Projedeki 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 /geographies | Haritaya altlık olabilecek coğrafyalar: config.geographyId alanına ne yazılabileceği. |
GET /geographies/{geographyId}/scope-parents | O coğrafyada kapsam olarak seçilebilecek üst birimler, adıyla ve çizilecek bölge sayısıyla. |
GET /region-presets | Hazır çok ülkeli bölge listeleri (Baltık, AB-27, Balkanlar…). |
GET /map-options | Harita ayarlarının listesi: adı, türü, ne işe yaradığı ve seçenekli olanlarda geçerli değerlerin tamamı. |
POST /projects/{projectId}/maps | Projeye 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}/data | Haritanı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ı.trueise liste eksiktir.nextCursor: sonraki sayfanın işareti. Liste bittiysenull.
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ı.nullolabilir.svg: grafiğin durağan görüntüsü.nullolabilir.
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ıztrueolan
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ı bircode, ç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 hangitemplateile 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ındakitimeline_invalid_dates
sayar. Tablodaki satırların hepsi tamamen boşsa mesaj bunu söyler ve
yanındatimeline_invalid_datesgelmez (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_cellsise 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; birimiconfig.valuePrefixya da
config.valueSuffixile 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_cellsile 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 metintreemap_invalid_rowsile 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.counteksi değer
sayısıdır (gizlenmeyen varlıkların, zamanı okunan satırlarındaki değerler);
messageeksi 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_drawnda gelir. Eksi değerleri göstermek içinchartType: "bar"
eksi değeri sıfırın öbür yanına çizer. Kodrace_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.counteksi
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_drawnsöyler), iç içe ve ızgarada görünen bütün seriler;
gizlenen seri ve kategori sayılmaz.messageeksi değerli dilimleri (en çok
üçünü) kategori adıyla sayar. Pozitif değer kalmadıysa yanındanothing_drawn
da gelir. Kodrace_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.countolay sayısıdır;messageilk
üçünü adı, satır numarası (1'den) ve hücredeki değerle sayar.timeline_missing_columns, süre çizelgesinin bir sütun rolü
(config.timelineiçindekistartColumn·endColumn·laneColumn·
colorColumn·weightColumn) tabloda olmayan bir sütun adını gösterdiğinde
gelir.PUT /charts/{chartId}/dataayarlara 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.countbayat rol sayısıdır;messagerolü ve
sütun adını sayar. Düzeltmek içintimelinenesnesini tablodaki sütun
adlarıyla yeniden gönder (nesne bütün olarak yazılır).missing_columnsaynı durumun öteki ayarlar için söylenişidir: ağaç
haritasının bir rolü (config.treemapiçindekilabelColumn·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.countbayat ayar sayısıdır;messageayarı ve sütun adını
sayar. Düzeltmek içintreemapya datemporalnesnesini 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çindekistart·end) tabloda yoksa o çift
çizilmez (hiç çift kalmazsa grafik boştur);messageçifti grup adıyla sayar,
countbayat çift sayısıdır. Piramidin bir kanadı (config.divergingiç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çindumbbellya da
divergingnesnesini 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 çoktimeline.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, sabitchartWidthte 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.laneColumnile şeritler (her şerit kendi satırlarını alır);
timeline.maxRows12'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çinpie.modenestedya dagridolur; tek seri
isteniyorsa ötekilerhiddenSeriesile 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üzeltmesicolorMode
presetya dacustom(tek pastadashowLabels: trueda 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 (counto grupların
sayısıdır; başlık otomatik boyutun en geniş hâlinde — 700 × 320 — ya da
verdiğinchartWidth/chartHeightile ölçülür). Düzeltmesiconfig.legend
içindevisible: true; tek pastadashowLabels: trueda 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).countrenk paylaşan öğe sayısıdır,
mesaj kimin kiminle aynı renkte olduğunu yazar. Kapsamsingle_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#abckısa yazımı fark
etmez; "benzer" tonlar sayılmaz). DüzeltmesicolorMode: "custom"ve öğe
sayısı kadar FARKLI renklicustomColors, ya da daha az öğe.colorMode: "single"bu kodu değilsingle_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_colorsher 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 vecounthalka başına sayar. En az iki halka
çiziliyorsamessageher ç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ıcustomColorslistesini kaydırarak
kullandığı içinmessagein ö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.countadı 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üzeltmesiscatter.showNames: true;config.legendbu tipte çizilmez. ⚠scatteriç içe nesnesi bütün
yazılır — eşlemeyi korumak içinentities,rowsAreve ö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-parentslisteler; 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ınparentGeographyIdalanınullise 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ıttakiidsdeğ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.titlevermezsen 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 sonraPUTile verirsin. templatealanı üç başlangıç şablonundan birini seçer:race(yarış),
scatter(dağılım) ya datimeline(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.temporalgö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ınwarningsalanı bunuscatter_temporal_boundile
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ğindatave
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_hiddenuyarı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ı.showLegendya da
legend.visiblegö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. configteGET /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'deconfig.dumbbellgöndermezsen çiftler ve dönem adları
seri adlarından türetilip kaydedilir (lejant "İlköğretim · 2014" değil
"2014" der) ve yanıtınconfiginde görünür. Tabloda olmayan seriyi anan ya da
aynı seriyi iki uçta kullanan çift400invalid_requestalır. Çift seri
adlarına bağlıdır: sonraPUTile seri adlarını değiştirirsen bozulan çift
yeni adlardan yeniden kurulur (aşağıda "Grafiği güncellemek"). - Dağılımda
config.scatter.entitiesgö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övdesindeconfigtaşı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
çizelgesindeextrude)flatyazılır; aynı istektedepthgönderirsen
dokunulmaz, kapalıysa istek reddedilir. Stil ve derinlik denetimi yalnız
isteğinchartType,styleIdya dadepthtaşıdığında yapılır.- Zaman bağlamasını kaldırmak için
config.temporal: nullgönderirsin: alan
ayarlardan silinir ve grafik bağlamasız çizilir (yarış bağlamasız boş
çizer, yanıttanothing_drawngelir). Dağılımda okuma
(scatter.rowsAre) değişmez; her satırın bir nokta olmasını istiyorsan aynı
istekteconfig.scatter.rowsAre: "entity"gönder (scatternesnesi bütün
yazılır). Aynı istekte tipi dağılıma çeviriyorsan yıl satırlı tablo bağlamayı
kendiliğinden geri almaz.nullyalnızPATCHte geçerlidir; grafik
oluştururkenconfig.temporalya verilir ya hiç gönderilmez. - Zaman bağlı bir dağılımda okumayı
config.scatter.rowsAre: "entity"yaparsan
(config.temporalgöndermeden) bağlama da kalkar: varlık okumasında zaman
yoktur ve iki ayar birlikte kaydedilmez. Yanıtınwarningsalanının sonunda
scatter_temporal_removedgelir (countnokta 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 istersenconfig.scatter.rowsAre: "period"ileconfig.temporalı birlikte gönder. Okumayıentityyapıp aynı
istekte birconfig.temporalnesnesi gönderen istek eskisi gibi400
alır. PUT /charts/{chartId}/datagövdesindedatataşı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ınwarningsalanında
dumbbell_pairs_rederiveddüşen ve kurulan çiftleri sayar. Eşleşme
istediğin gibi değilseconfig.dumbbelliPATCHile 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
warningsalanındascatter_mapping_rederiveddüş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ındanothing_drawngelir. Eşleşme istediğin gibi
değilseconfig.scatterıPATCHile 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.
| Kod | HTTP | Ne demek |
|---|---|---|
invalid_request | 400 | İstek geçersiz: kimlik UUID biçiminde değil, gövde JSON değil, bir alan eksik ya da tanınmayan bir alan var. |
unauthorized | 401 | Anahtar yok, biçimsiz, geçersiz, süresi dolmuş ya da iptal edilmiş. |
insufficient_scope | 403 | Anahtarın yazma yetkisi yok (eski, yalnız okuma yetkili anahtar). Yeni bir anahtar oluştur. |
forbidden | 403 | Grafik ya da harita Tuvelia'da oluşturulmuş; anahtar onu değiştiremez. |
not_found | 404 | Kaynak yok: silinmiş ya da başka bir hesaba ait olabilir. |
conflict | 409 | Grafik ya da harita, gönderdiğin expectedVersiondan sonra değişti; yeniden oku ve tekrar dene. |
payload_too_large | 413 | İstek gövdesi çok büyük. |
rate_limited | 429 | Hız sınırı aşıldı; Retry-After başlığındaki saniye kadar bekle. |
internal_error | 500 | Beklenmeyen bir hata; birazdan yeniden dene. |
unavailable | 503 | Anahtar ş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 nedeninnothing_drawnmesajı 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 —
codealanının açıklaması pastada dilimlerin çizilemeyecek
kadar dar kaldığı durumu da sayar. OpenAPI belgesinde uyarınıncode
alanı,nothing_drawnuyarı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. OpenAPI1.0.0-preview.88. - 2026-11-01 — Dağılımda okumayı
entityyapmak zaman bağlamasını da
kaldırır; yeni bilgi koduscatter_temporal_removed. Zaman bağlı bir
dağılıma yalnızconfig.scatter.rowsAre: "entity"gönderenPATCHö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
warningsalanının sonundascatter_temporal_removedgelir. Hiçbir istek
yeni bir ret almaz; okumayla birlikte birconfig.temporalnesnesi gönderen
istek eskisi gibi400alır. Grafik oluşturma ve öteki yazımlar değişmedi.
OpenAPI1.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_drawnbu 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_requestyanıtınınmessageı 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 /geographiesarama parametrelerinin
sınırını ilan ediyor.qartık belgede de en az 1, en çok 100 karakterlik
bir metindir;regionvelevelen az 1 karakterdir (minLength,
maxLength). Sunucu bu sınırı zaten uyguluyordu: boş bir değer ya da 100
karakterden uzun birq400 invalid_requestdöner. Davranış değişmedi.
OpenAPI1.0.0-preview.86. - 2026-10-31 — OpenAPI belgesi
cursorparametresinin uzunluk sınırını
ilan ediyor. Üç liste ucunda (GET /projects,
GET /projects/{projectId}/charts,GET /projects/{projectId}/maps)
cursorartı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 bircursor400 invalid_requestdöner. Davranış değişmedi.
OpenAPI1.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önen400
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
belgesindekiPUT /maps/{mapId}/dataözeti). Davranış ve OpenAPI belgesi
değişmedi. - 2026-10-31 —
geographyIdayar keşfi açıklamasıPATCHcümlesiyle aynı;
eski kayıt reddi verili kayıtla sınırlı.GET /map-optionsyanıtında
geographyIdaçı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. OpenAPI1.0.0-preview.84. - 2026-10-31 — haritanın
PATCHaçı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;geographyIdgerç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" veconfigalanının açıklaması artık bunu
söyler. Uyarı koducodeaçı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.labelAngleaçı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 —
PATCHve 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" veconfigalanının açıklaması artık bu bağlı
ayarları sayar.dumbbell_pairs_rederivedvescatter_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. OpenAPI1.0.0-preview.81. - 2026-10-31 — ayar keşfinde iki açıklama.
GET /chart-optionsdepth
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 çizelgesindeextrude)flat
yazılır, aynı istektedepthgönderirsen dokunulmaz (PATCHbu kuralla
2026-10-31'den beri çalışıyor).GET /map-optionslayersaçıklaması boş
dizinin kabul edildiğini ama haritanın çizilmediğini ve yanıtın bunu
no_layersile söylediğini yazar. Alanlar, değerler ve davranış değişmedi.
OpenAPI1.0.0-preview.80. - 2026-10-31 —
PATCHile zaman bağlaması kaldırılır:config.temporal: null.PATCH /charts/{chartId}config.temporalanullı reddediyordu
(400); dağılımın kendiliğinden kurduğu bağlama (scatter_temporal_bound)
sonradan kaldırılamıyordu. Artıknullbağlamayı ayarlardan siler ve grafik
bağlamasız çizilir. Dağılımda okuma değişmez — satırları nokta okumak için
aynı istekteconfig.scatter.rowsAre: "entity"gönder.nulldışındaki
her istek önceki gibi kabul ya da reddedilir; grafik oluştururkennull
yine kabul edilmez.scatter_temporal_boundmesajı bu yolu da söyler.
OpenAPI1.0.0-preview.79. - 2026-10-31 — liste uçları sayfa sayfa:
limit,cursor,truncated,
nextCursor.GET /projects,GET /projects/{projectId}/chartsve
GET /projects/{projectId}/mapseskiden bütün kayıtları tek yanıtta
veriyordu. Artık bir sayfada varsayılan olarak en çok 50 kayıt gelir
(limitile 1–200). Her liste yanıtınatruncatedvenextCursoreklendi;
truncated: trueise devamınıcursorile 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 bunutruncated: trueile söyler.
Geçersizlimitya da işaret400 invalid_requestdö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ındandisplayMode·smallMultiplesBy·smallMultiplesColumns
·smallMultiplesScale·smallMultiplesAxisTitles·highlight·
cellNotes·showLabelsbu adı kullanır;displayModeaçıklaması
small_multiplesdeğerinin editördeki adını da söyler. Değerler (small_multiplesdahil), alan adları ve davranış
değişmedi. OpenAPI1.0.0-preview.77. - 2026-10-31 — dağılım yıl satırlı tabloda zaman bağlamasını kendiliğinden
kurar; yeni bilgi koduscatter_temporal_bound.POST /projects/{projectId}/chartsya da tipi dağılıma çevirenPATCH /charts/{chartId},config.temporalveconfig.scatter.rowsAre
göndermediğinde, satır etiketleri (ilk sütun) yıl olan ve en az ikivarlı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
warningslistesinin sonundascatter_temporal_boundgelir (countdö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ı istekteconfig.scatter.rowsAre: "entity"gönder.
OpenAPI1.0.0-preview.76. - 2026-10-31 — katmansız harita yanıtta uyarıyla söylenir:
no_layers.
layersboş dizi yazılabiliyor (POST /projects/{projectId}/mapsvePATCH /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,warningslistesinin başındano_layerstaşır;count
haritanın satır sayısıdır (veri yoksa 0). Veri korunur;layersa bir
koroplet katmanı yazınca uyarı kalkar. OpenAPI1.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 (extrudeseçiliyken dumbbell, dağılım ya da süre çizelgesi)
istek "… extrude edilemez" ile reddediliyordu; artıkdepthflatyazılır
ve istek geçer. Aynı istektedepthgö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ıztitlegibi ilgisiz bir alanı
değiştiren istek de reddediliyordu; stil ve derinlik denetimi artık yalnız
istekchartType,styleIdya dadepthtaşıdığında yapılır. Kayıtlı
derinliğe yalnız tip değişiminde dokunulur. Kendiliğinden düşürülen derinlik
(çizgi ve alandaextrude→ yumuşak çizim) eskisi gibi korunur. OpenAPI
1.0.0-preview.74. - 2026-10-30 —
nothing_drawndilimleri ç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 amawarningste
nothing_drawnyoktu. Artıknothing_drawnen önde gelir,countsatır
sayısıdır; mesaj nedeni söyler ve kategori sayısını azaltmayı (küçük
kategorileri tek satırda toplamayı), halkayı kapatmayı (pienesnesini
donut: falseile 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 (countve 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-templatesvecreateChartintemplate
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. OpenAPI1.0.0-preview.73. - 2026-10-30 — dağılım oluşturulurken gönderdiğin eksen adı korunur.
POST /projects/{projectId}/chartsve grafiği dağılıma çevirenPATCH /charts/{chartId},config.scatter.entitiesgönderilmediğinde eşlemeyi
seri adlarından türetirkenscatter.xLabelvescatter.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.entitiesile birlikte gönderilen adlar zaten
korunuyordu. Var olan grafikler değişmedi. OpenAPI1.0.0-preview.72. - 2026-10-29 — renk anahtarı yalnız lejantta olacak her yeni grafik lejant
açık doğar.POST /projects/{projectId}/chartslejantı 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ı velegend_hiddenuyarısıyla
doğuyordu. Artıklegend_hiddenuyarısının kapsadığı her yeni grafik
config.showLegend: trueile ve bu uyarı olmadan doğar.showLegendya da
legend.visiblegönderirsen seninki kalır (lejantı açıkça kapatırsan uyarı
yine gelir). Uyarının kuralı,PATCHvePUT …/dataile var olan grafikler
değişmedi. OpenAPI1.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şfindekivalues
ögeleri, coğrafya listesindekiparentGeographyId)anyOfyerine tek birtype
dizisiyle (["string", "number", "boolean"]) gösteriliyor; tarih alanlarının
(createdAt·updatedAt) deseni saniyeyi zorunlu yazıyor — yanıtlarımız zaten
hep saniyeli veZile biter. Kabul edilen istekler, yanıtların şekli ve anlamı
değişmedi. OpenAPI1.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; sonraPUT /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 (countdüşen varlık sayısı; mesaj düşen ve kurulan varlıkları,
hiçbir varlığa girmeyen serileri sayar) — yalnız oPUTyanı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}/dataayarlara 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 (countdüşen çift sayısı; mesaj düşen ve kurulan çiftleri,
hiçbir çifte girmeyen serileri sayar) — bu uyarı yalnız oPUTyanı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 olaylartimeline_unlabeled_eventsile
sayılır (yukarıda "Grafiğin içeriği"). Sayı çizimin genişliğine bağlı olduğu
içincountgörselin referans genişliğindeki sayıdır vemessageo 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.
OpenAPI1.0.0-preview.67. - 2026-10-29 — grafik oluştururken dumbbell çifti türetilir ve denetlenir.
POST /projects/{projectId}/chartsdumbbell ç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 çift201ve
missing_columnsile kaydediliyordu, aynı seriyi iki uçta kullanan çift ise
uyarısız kaydediliyordu. Artık oluşturmaPATCH /charts/{chartId}ile aynı
kuralı uygular:config.dumbbellverilmezse çiftler ve dönem adları seri
adlarından türetilip yanıtınconfigine yazılır; geçersiz çift400
invalid_requestalır (mesajPATCHtekiyle aynı). Çift artık oluşturmadan
itibaren kayıtlıdır; sonra seri adlarını değiştirenPUTiçin aşağıdaki
(aynı gün) madde. Var olan grafikler değişmez. OpenAPI1.0.0-preview.66. - 2026-10-29 — ayar keşfinin değerleri ayarın kendi türünde.
GET /chart-options
veGET /map-optionsyanıtındakivaluessayı alanlarında da metin
döndürüyordu (decimalPlacesiçin["0", "1", "2", "3"]); listeden aynen
yazılan"1"ise400invalid_requestalı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ğerconfige 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. OpenAPI1.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_seriesveduplicate_colorsda
onu saymıyor (önce sayıyordu:countve mesajdaki adlar o kategoriler kadar
azalabilir; tek pastada tek dilim kalınca ya da hiçbir dilim çizilmiyorsa uyarı
gelmez — boş grafiğinothing_drawnsö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
warningsbunu söylemiyordu. Artıkpie_negative_cellseksi değerleri sayar
(counteksi değer sayısı — tek pastada yalnız çizilen ilk görünür seride;
mesaj dilimleri kategori adıyla sayar). Hepsi eksi pastadanothing_drawn
eskisi gibi en önde, yeni kod arkasında. Çizim değişmedi. Var olan kodların
anlamı ve sırası aynı; yeni kodrace_negative_cellsin ardından. OpenAPI
1.0.0-preview.64. - 2026-10-27 — yeni uyarı kodu:
race_negative_cells;nothing_drawnhepsi
eksi yarışta da gelir. Yarış yalnız pozitif değere çubuk çizer; eksi değerli
varlığın çubuğu çizilmiyordu vewarningsboş dönüyordu. Artık
race_negative_cellseksi değerleri sayar (counteksi 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 amawarningsboş dönüyordu; artıknothing_drawnen
ö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. OpenAPI1.0.0-preview.63. - 2026-10-27 — gizleme nedenli
nothing_drawnmesajı 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).codeve OpenAPI belgesi aynı
(1.0.0-preview.62). - 2026-10-27 —
nothing_drawneksi 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
warningsboş (ya da yalnızempty_cells,text_cells,legend_hidden,
pie_series_not_drawn) dönüyordu. Artıknothing_drawngelir, 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 olannothing_drawnmesajı artık ilk görünür seri
kuralını söyler: gizlenen seriyihiddenSeriesten çıkarmak, ondan önce görünen
bir seri varken onu çizdirmez.codeaçıklaması kuralı sayar. OpenAPI
1.0.0-preview.62. - 2026-10-27 —
nothing_drawntek 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 amawarningstenothing_drawnyoktu (yalnız
pie_series_not_drawn,empty_cells,text_cellsya damissing_columns
geliyordu, bazen hiçbir şey). Artıknothing_drawnen önde gelir, mesaj
nedeni söyler;countsatır sayısıdır, öteki uyarılar eskisi gibi arkasından
gelir. Ayar keşfinde (/chart-options)showLabelsaçı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_drawngrafiğin boş çizildiği her durumda gelir.
Grafik boş çizildiği hâldewarningsçoğu durumda bunu söylemiyordu: değer
hücrelerinin hepsi boş, sıfır ya da sayı olarak okunamıyorken (çubukta
yalnızlegend_hiddengeliyordu), ölçümler yalnız gizlenen serilerde ya da
kategorilerdeyken, tabloda değer sütunu yokken, piramidin kanatları
çözülemiyorken (yalnızmissing_columns), yarışta gösterilecek varlık,
dağılımda çizilecek nokta (yalnızscatter_over_limit) ya da ağaç
haritasında pozitif değer yokken (yalnıztreemap_invalid_rows). Artık
nothing_drawngelir, mesaj nedeni söyler. Kural tek: grafiğin yerinde
nedeni yazan boş durum yazısı çıkıyorsa gelir, grafik çiziliyorsa gelmez.nothing_drawnen öndedir,countsatır sayısıdır; var
olan kodların anlamı ve sırası değişmedi, yanlarındaki uyarılar eskisi gibi
gelir.codeaçıklaması kuralı sayar. OpenAPI1.0.0-preview.60. - 2026-10-26 —
nothing_drawnyarış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ızconfig.hiddenSeriesile
gizlenen serilerdeyken grafik boş çiziliyor amawarningsboş (ya da yalnız
text_cells) dönüyordu; artıknothing_drawngelir 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 kanattaempty_cells/text_cells
eskisi gibi arkasından gelir.nothing_drawnen öndedir,countsatır
sayısıdır; var olan kodların anlamı ve sırası değişmedi,codeaçıklaması iki
kapsamı da sayar. OpenAPI1.0.0-preview.59. - 2026-10-26 —
nothing_drawndağılımda gizlemeyi de söyler. Dağılımda
noktası olan her varlığın x ya da y serisiconfig.hiddenSeriesile
gizliyken (ya da ölçümler yalnız gizlenen serilerdeyken) grafik boş
çiziliyor amawarningsboş dönüyordu. Artıknothing_drawngelir (en
önde,countsatı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;
codeaçıklaması bu kapsamı da sayar. OpenAPI1.0.0-preview.58. - 2026-10-26 —
empty_cellsvetext_cellsdumbbell'de gizli dönemi de
sayar. Dumbbell'de gizleme uygulanmaz:config.hiddenSeriesile 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/axisMaxaçıklaması.
GET /chart-optionsbu 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üfustablosunda
Nüfus). Grafik tipi açıklaması vemissing_columnsaçıklaması bunu söyler.
OpenAPI1.0.0-preview.56. - 2026-10-25 —
text_cellsyarış, 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 vewarningsboş dönüyordu. Artık bu tiplerde de
text_cellssayar (çizimin okuduğu hücrelerde); mesaj etkiyi tipe göre söyler.
Çizim değişmedi. Kod, sıra ve öteki tiplerin mesajı aynı;codeaçıklaması
kapsamı sayar. OpenAPI1.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,countve uyarıların
sırası değişmedi. OpenAPI1.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_drawnmesajı "hangi satırların neden
çizilmediğinitimeline_invalid_datessayar" 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. OpenAPI1.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) vewarningsboş dönüyordu (virgüllü
ondalık ve birim işareti zatencomma_decimal_cells·formatted_number_cells
ile söyleniyordu). Artıktext_cellssayar; çizim DEĞİŞMEDİ. Çubuk, çizgi,
alan, yığın, pasta, piramit ve dumbbell'de,empty_cellsile 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. OpenAPI1.0.0-preview.52. - 2026-10-25 —
missing_columnsdumbbell çiftini ve piramidi de kapsar.
VeriyiPUT /charts/{chartId}/dataile yazarken dumbbell çiftinin serisi ya
da piramidin kanadı tabloda kalmazsawarningsboş 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 bunlarmissing_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ızmissing_columnsın kapsamı genişledi.
PUT …/dataayarlara yine dokunmaz. OpenAPI1.0.0-preview.51. - 2026-10-25 —
nothing_drawnsü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_drawnmesajı "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,countve uyarıların sırası değişmedi;codealanının açıklaması bu
kapsamı da sayar. OpenAPI1.0.0-preview.50. - 2026-10-25 — Ayar keşfi:
showLabelsaçıklaması düzeltildi.
GET /chart-optionsshowLabelsiç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.showValuesaçı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. OpenAPI1.0.0-preview.49. - 2026-10-20 — Yeni uyarı:
missing_columns(ağaç haritası · zaman bağlaması).
timeline_missing_columnsin genel ikizi. VeriyiPUT /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 vewarningsboş
dönüyordu (zaman bağlaması yalnız yarıştanothing_drawnile görünüyordu):
kutular gruplanmadan, başka bir sütunun değeriyle çiziliyor; çizgi ve çubukta
zaman ekseni sessizce kayboluyordu. Artık bu durummissing_columnsile
söylenir (yukarıda "Grafiğin içeriği").PUT …/dataayarlara yine dokunmaz;
grafik editörde açılınca bayat ayar düşer. Var olan kodların anlamı ve sırası
değişmedi; yeni kodtimeline_missing_columnsin ardından, görsel uyarılardan
önce gelir. OpenAPI1.0.0-preview.48. - 2026-10-19 — Yeni uyarı:
timeline_missing_columns(süre çizelgesi).
VeriyiPUT /charts/{chartId}/dataile 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 vewarningsboş 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_columnsile söylenir (yukarıda "Grafiğin içeriği").
PUT …/dataayarlara yine dokunmaz. Var olan kodların anlamı ve sırası
değişmedi; yeni kodtimeline_invalid_datesin ardından, görsel uyarılardan
önce gelir. OpenAPI1.0.0-preview.47. - 2026-10-19 — Yeni uyarı:
timeline_invalid_dates(süre çizelgesi).
Tarihi kullanılamayan olaylarwarningste 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_datesile 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
kodtimeline_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.coloryalnız#RRGGBBkabul ediyordu:#abc,#0077B6CC,
rgba(0, 119, 182, 0.5),hsl(…)ya danavygibi geçerli bir renk400
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#RRGGBBdiyordu). OpenAPI
1.0.0-preview.45. - 2026-10-18 — Çok serili yeni grafik lejant açık doğar.
legend_hidden
uyarısı geldiğinden beriPOST /projects/{projectId}/chartsile 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: trueile oluşur ve uyarı gelmez.showLegendya da
legend.visiblegönderirsen seninki kalır; tek serili grafik, çoklu grafik,
pasta, dumbbell ve piramit eskisi gibi oluşur. Var olan grafikler değişmez ve
PATCHlejanta dokunmaz. Tuvelia'daki Yeni öğe de aynı kuralı izler.
OpenAPI1.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ğinfontFamilyalanına her metin
yazılabiliyordu:url(…),var(--x)ya da;içeren bir değer200alı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}/mapsvePATCH /maps/{mapId}geçerli bir CSS
biçiminde olmayan değeri400invalid_requestile 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 önce200alan bu değerler artık reddedilir.
Onaltılık renkler, yalnız sayılarlargb()/rgba()/hsl()/hsla(), CSS
renk adları vetransparenteskisi gibi kabul edilir. Kayıtlı grafikler ve
haritalar değişmez; Tuvelia'daki düzenleme ve marka kitleri bu kurala tabi
değildir. OpenAPI1.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 statesveamerikaeskiden 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.
OpenAPI1.0.0-preview.43. - 2026-10-18 — Yeni görsel uyarı:
point_names_hidden. Dağılımda
scatter.showNames: falseyazmak 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 — amawarningsboş dönüyordu. Artık bu
durumdapoint_names_hiddengelir;countadı 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.
OpenAPI1.0.0-preview.42. - 2026-10-18 —
decimalPlacesartık 0–3 arası tam sayı. Ondalık basamak
sayısı sınırsızdı:101,1e9ya da (decimalMode: "fixed"ile)-1
yazmak200alıyordu ama grafik Tuvelia'da, gömmede, dışa aktarmada ve
videoda hiç açılmıyordu. ArtıkPATCH /charts/{chartId}ve
POST /projects/{projectId}/charts0–3 dışını ve tam sayı olmayan değeri
400invalid_requestile reddeder; sınır Tuvelia'daki Ondalık
seçicisiyle aynıdır. ⚠ Daha önce 200 alan4…100de artık reddedilir
(önizleme kapsamında kısıtlayıcı değişiklik); kayıtlı grafikler etkilenmez.
GET /chart-optionsalanı 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 —
colorPresetartık 0–5 arası tam sayı. Hazır palet
indeksi sınırsızdı:9,-1ya da1.5yazmak200alıyordu ama grafik
Tuvelia'da, gömmede ve videoda hiç açılmıyordu. ArtıkPATCH /charts/{chartId}
vePOST /projects/{projectId}/chartsaralık dışı ve tam sayı olmayan değeri
400invalid_requestile reddeder; mesaj altı paleti adlarıyla sayar.
GET /chart-optionsalanı 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. OpenAPI1.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 vewarningsboş 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 durumdaduplicate_colorsgelir;countrenk 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. OpenAPI1.0.0-preview.39. - 2026-10-18 —
legend_hiddenvesingle_color_seriesüç durumu daha
kapsıyor. Renklerin anahtarı yalnız lejantta olduğu hâldewarningsboş
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ıykenlegend_hidden, etiketsiz tek pastada tek renk seçiliyse
single_color_seriesgelir (yukarıda "Grafiğin içeriği"). Ağaç haritasında
countbaşlığı sığmayan grup sayısıdır. Yeni kod yok; kodların anlamı
genişledi, açıklamaları güncellendi. OpenAPI1.0.0-preview.38. - 2026-10-18 —
GET /geographiesaraması Türkçe karakter ve aksan duyarsız.
qartık Tuvelia'daki Coğrafya panelinin Bölge ara kutusuyla aynı kuralla
eşleşir:turkiye,kibris,ISPANYAveilcelereskiden 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şanqartık süzmez.
Uç, alan ve yanıt biçimi değişmedi. OpenAPI1.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 amawarningsboş 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").warningsaçıklaması "çizilmeyen ya da çizilip okunamayan" diye
genişledi;countartık seri, dönem ya da kategori de sayabilir. Ekleme
yapıldı, var olan bir kodun anlamı değişmedi. OpenAPI1.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
warningsbunu 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. OpenAPI1.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}.labelsile çevrilir. OpenAPI1.0.0-preview.34. - 2026-10-08 — grafik
translationsiçindelabels: 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ı;translationsyine BÜTÜN yazılır.
Yalnız ad çevirisi olan dil depublished.urls.liveByLocaleda görünür. OpenAPI1.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):smallMultiplesColumnsartık 2–6 ·smallMultiplesScale(shared|independent) ·
highlight({ category, color }) ·cellNotes([{ category, series, text }], en çok 200).
highlightvecellNoteste veride olmayan ad ve aynı hücreye ikinci not 400 ile reddedilir (mevcut
adlar mesajda sayılır). - 2026-10-05 —
published.urls.liveByLocaleeklendi. 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" }.liveana 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
translationseklendi (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.localeana 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
localeeklendi. İsteğe bağlılocale: "tr" | "en"
(yoksatr): 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çiminumberFormatta kalır.sourceLabelvetooltipLabelkayıtlı
metinlerdir; dili değiştirirken eski dilin varsayılanını taşıyorlarsa yenisini
(Source/Value) de gönder.GET /chart-optionsalanı listeler. Ayrıca pasta
ipucundaki yüzde artık grafiğin ondalık ayracını kullanır (Türkçe biçimde
eskiden%25.0yazıyordu). - 2026-10-05 — harita ayarında
localeeklendi. İsteğe bağlılocale: "tr" | "en"
(yoksatr): haritaya sistemin bastığı metinlerin dili — künye ön ekinin
varsayılanı (Kaynak/Source;meta.sourceLabelyazı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 · enK/M/B). Başlık, kaynak adı, not ve bölge
adları çevrilmez; sayı ayraçları değişmez.GET /map-optionsalanı 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_cellsuyarı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_cellsile 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_drawnvecomma_decimal_cells
eksikti). - 2026-09-24 —
decimalModeeklendi. Grafik ayarında isteğe bağlı
decimalMode: "auto" | "fixed".autofazla basamağı gösterimde kırpar
(|değer| ≥ 1 ise en çok 2 ondalık, küçük değerlerde 2 anlamlı basamak);
fixeddecimalPlacesi aynen uygular (0 = tam sayıya yuvarla). Alan yoksa
decimalPlaces> 0 isefixed, 0 iseautosayılır. ÖncedendecimalPlaces: 0
hiç yuvarlamıyordu ve Türkçe biçimde ondalık noktayla yazılıyordu. - 2026-09-24 —
styleIddeğişimi değiştirilmiş alanları korur. Stil
değiştiğinde krom renkleri,fontFamily,borderRadiusvedepthyalnız
önceki stilin varsayılanında duruyorsa yeni stile geçer; marka kitinden ya da
elle yazılmış değer korunur. Seçilendepthyeni 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 —
showFooterartı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
showSourceile yönetilir. ÖncedenshowFooter: falsekaynak ve lisansı da
gizliyordu; bu grafiklerde kaynak artık görünür. - 2026-09-23 — harita
colorScale.modeaçıklaması düzeltildi (belge
düzeltmesi). Açıklama "thresholdsınırlarıdomainden okur" diyordu; bu,
eşiklerin elle verilebileceğini düşündürüyordu. Doğrusu:thresholdbugün
quantizeile aynı çizer — en küçük ile en büyük değer (domainya da veri)
arasını eşit basamaklara böler; elle eşik girişi yoktur. Davranış değişmedi. - 2026-09-23 —
sortOrderaçı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.colorModeyeni bir
değer alıyor:value. Tek serilibarvepiegrafikte 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. RampacolorPresetile seçilir (Pastel rampa
değildir, Okyanus kullanılır). Başka her grafiktevalue,presetgibi
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/v1altı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.sourceLabelverilmeden oluşturulan grafikler artıkKaynak
ile başlar (eskidenSource); 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.modeartıknaturaldeğ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ılanKaynak) 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.sourcealanı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,locatorveanimationgibi 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
geographyIddeğ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}vePATCHyanıtlarındaki
warnings, yazma yanıtıyla aynı kodları ve adları taşıyor; eskiden okuma
yanıtı her çizilmeyen satırıunmatched_rowsdiye bildiriyordu. Yeni uyarı
kodu:scheme_hidden_by_colors. - 2026-09-21 — harita verisinde sessiz kalan durumlar artık bildiriliyor.
PUT /maps/{mapId}/datayanıtına dört yeni uyarı kodu eklendi:
unreadable_values,ambiguous_number_cells,comma_decimal_cellsve
mixed_id_types. Aynı ad ve dönem iki kez geldiğinde, zamansız haritada da
aynı bölge iki kez geldiğinde,duplicate_rowsartı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}/dataaçıklaması ve bu sayfa "kısmi zaman
reddedilir" diyordu; doğru değildi. Zamanlı bir yazımdaattaşımayan ya da
hassasiyeti farklı olan satır kaydedilir, çizilmez veundeclared_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.dataSourceAPI'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.dataSourcebir 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.sourcekullanı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şmeyenleriwarningsalanı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-optionsartık her ayarın ne
işe yaradığını da yazıyor; ayrıcatemporalvelegendgibi 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ıkwarningssebebini 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.createChartintemplate
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ı.