API anahtarları

API anahtarı, başka bir uygulamanın Tuvelia'ya senin adına bağlanmasını
sağlayan kişisel bir anahtardır. Bu uygulama bir WordPress eklentisi ya da
kendi yazdığın bir betik olabilir. Anahtarı bilen herkes bu bağlantıyı senin
adına kurabilir; onu bir parola gibi sakla.

Sayfaya sol menüden Hesap, sonra alt menüden API anahtarları ile
ulaşırsın. Sayfanın notu: "Başka bir uygulamanın (ör. bir WordPress
eklentisinin) Tuvelia'ya senin adına bağlanması için kişisel anahtarlar." Notun
devamı API'nin şu an önizlemede olduğunu söyler: uçlar ve alanlar değişebilir,
her değişiklik API belgesindeki değişiklik günlüğüne yazılır.

Anahtar oluşturmak

Etkin anahtarlar kartındaki Yeni anahtar düğmesi Yeni API anahtarı
penceresini açar. Pencerede iki alan vardır:

• Ad: anahtarı hangi uygulamanın kullandığını hatırlaman için; listede bu
  adla görünür. En çok 100 karakter olabilir. Boş bırakırsan pencere "Anahtara
  bir ad ver." der.
• Geçerlilik süresi: 7 gün, 30 gün, 90 gün, 180 gün ya da 1 yıl;
  varsayılan 90 gündür. Alanın altında anahtarın biteceği gün yazar
  ("Bitiş: …"). Süresiz anahtar yoktur.

Anahtarı oluştur anahtarı üretir. Anahtar türü seçilmez: her anahtar
aynıdır ve Tuvelia'nın API'sinin izin verdiği işleri senin adına yapar:
projelerini, grafiklerini ve haritalarını okur; yeni proje, grafik ve harita
oluşturur; anahtarla oluşturduğu grafiklerin ve haritaların verisini ve
ayarlarını günceller. Tuvelia'da oluşturduğun grafikleri ve haritaları
değiştiremez. Hiçbir anahtar içeriğini silemez ya da
yayınlayamaz; yayınlamak her zaman Tuvelia'da, senin elinle yapılır.

Anahtar yalnız bir kez gösterilir

Anahtar Anahtarın hazır penceresinde tam hâliyle görünür: tuv_pat_ ile
başlayan 51 karakterlik bir dizi. Pencerenin uyarısı "Bu anahtarı şimdi
kopyala" der. Pencere kapandıktan sonra anahtar bir daha gösterilmez, çünkü
Tuvelia anahtarın kendisini saklamaz; yalnız onu tanımaya yetecek bir özet ve
son dört karakteri tutar.

Kopyala düğmesi anahtarı panoya kopyalar ve "Kopyalandı" olur. Tarayıcı
panoya erişime izin vermezse "Panoya kopyalanamadı." uyarısı çıkar ve anahtar
seçili bırakılır; klavyeyle kopyalarsın (⌘C ya da Ctrl+C).

Anahtarı kopyalamadan pencereyi kapatmaya çalışırsan (Tamam, çarpı, Esc
ya da pencerenin dışına tıklama) pencere kapanmaz, önce "Anahtarı henüz
kopyalamadın" uyarısını gösterir. Geri dön anahtara döner, Yine de
kapat pencereyi kapatır. Anahtarı kopyalamadan sayfayı yenilemeye ya da
kapatmaya çalışırsan tarayıcı da kendi sorusunu sorar.

Anahtarı kaybedersen geri getirmenin yolu yoktur: onu iptal edip yeni bir
anahtar oluşturursun.

Anahtarı kullanmak

Anahtarı, Tuvelia'ya bağlayacağın uygulamanın ayarlarına yapıştırırsın.
Kendi betiğini yazıyorsan anahtarı her istekte Authorization başlığıyla
gönderirsin:

Authorization: Bearer tuv_pat_…

Anahtar geçersizse, süresi dolmuşsa ya da iptal edildiyse istek reddedilir ve
yanıt, yeni bir anahtar oluşturmanı söyler.

Anahtarla projelerini, grafiklerini ve haritalarını okuyabilir; yeni proje,
grafik ve harita oluşturabilir ve anahtarla oluşturduğun grafikleri ve
haritaları güncelleyebilirsin. Anahtarla
yapılan her yazma, hangi anahtarla ve ne zaman yapıldığıyla kayda geçer. Uç
noktalar, istek ve yanıt biçimi, hata kodları ve hız sınırı API
sayfasında; makinece okunur tarif https://tuvelia.com/api/v1/openapi.json
adresinde.

Liste

Etkin anahtarlar en yenisi üstte sıralanır. Her satırda şunlar yazar:

• anahtarın adı ve tanınma işareti: tuv_pat_… ve son dört karakter;
• Oluşturma tarihi;
• Son kullanım: "Bugün", "Dün", bir tarih ya da "Hiç kullanılmadı".
  Bu bilgi saatte en çok bir kez güncellenir (geniş ekranda sütun başlığındaki
  "?" işareti de bunu söyler); son birkaç dakikadaki kullanım henüz
  görünmeyebilir;
• Bitiş tarihi ve kaç gün kaldığı. Bitişine 7 gün ya da daha az kalan
  anahtarda kalan gün turuncu bir uyarıyla yazılır: o anahtarı kullanan
  uygulama yakında duracak. Süre uzatılamaz; yeni bir anahtar oluşturup
  uygulamaya onu verirsin.

Kart, kaç etkin anahtarın olduğunu başlığının altında yazar, ör. "3 / 10 etkin
anahtar". Hiç anahtarın yoksa kart "Henüz bir API anahtarın yok." der.

Bazı eski anahtarlar "Yalnız okuma" rozeti taşır: bu anahtarlar veriyi
okuyabilir ama hiçbir şey oluşturamaz. Yeni oluşturulan anahtarlarda bu kısıt
yoktur.

Etkin anahtar sınırı

Bir hesapta en çok 10 etkin anahtar olabilir; süresi dolan ya da iptal edilen
anahtar bu sayıya girmez. Sınıra ulaştığında Yeni anahtar düğmesi kapanır
ve kart bunu söyler: "En çok 10 etkin anahtarın olabilir. Yenisini oluşturmak
için önce kullanmadığın birini iptal et."

İptal etmek

Satırdaki İptal et düğmesi önce onay sorar. Onay penceresi hangi anahtarı
iptal edeceğini adıyla ve son dört karakteriyle gösterir ve şunu söyler: "Bu
anahtarı kullanan uygulama Tuvelia'ya hemen erişemez olur. İptal geri
alınamaz; gerekirse yeni bir anahtar oluşturursun." Anahtarı iptal et ile
onaylarsın; Vazgeç hiçbir şeyi değiştirmez.

İptal anında etkilidir: anahtarı kullanan uygulamanın bir sonraki isteği
reddedilir. Bir anahtarın başkasının eline geçtiğinden şüphelenirsen onu
hemen iptal et.

Geçmiş

İptal edilen ve süresi dolan anahtarlar Geçmiş kartında durur. Kart
açılışta kapalıdır; başlığına tıklayınca açılır. Her satır anahtarın ne zaman
bittiğini yazar: "İptal edildi · 15 Eyl 2026" ya da "Süresi doldu · 12 Eyl
2026". Geçmişteki anahtarlar silinemez ve yeniden etkinleştirilemez; kayıt
için listede kalırlar.

Güvenli kullanım

• Anahtarı yalnız onu kullanacak uygulamaya ver. E-postayla ya da sohbetle
  paylaşma, bir kod deposuna yazma.
• Her uygulamaya ayrı anahtar oluştur. Biri sızarsa yalnız onu iptal edersin,
  diğer bağlantılar çalışmaya devam eder.
• İşine yeten en kısa süreyi seç. Kısa süreli bir anahtar unutulsa bile
  kendiliğinden geçersiz olur.