Ana içeriğe atla

Grafik API

Grafik API'si nedir#

Bildiğiniz gibi, dclist.net'in içinde grafikler var. Grafikler, verileri her geçen gün karşılaştırmak için gayet iyi bit yöntem.

Eğer hala grafiklerimizi görmediyseniz, onları botun sayfasında "Grafikler" sekmesinde görebilirsiniz.

Graifklerimizin en iyi özelliği ise onları sizinde kullanabilmeniz.

Grafik API'si nasıl kullanılır#

Grafik API'si aslında sadece grafikerleri render eden basit bir rest api. Ayrıca grafikleri cache liyerek daha kısa bir gecikme sağlıyor.

Grafik API'si için temel url: https://charts.dclist.net/

Bot Grafikleri#

Bot grafikleri "/bots/$botId/$chartId.$ext" yolundan ulaşılabilir durumda.

Örnek bir bot grafik url'si böyle gözükücektir : https://charts.dclist.net/bots/690214077490004030/views.svg

Grafik Çeşitleri#

Şuanda herkese açık olarak Grafik API'si ile erişeileceğiniz iki çeşit grafik var

Bot Görüntülenme Grafiği#

Örnek Bot Görüntülenme Grafiği

Bot Oy Grafiği#

Örnek Bot Oy Grafiği

Dosya Formatı#

Grafik API 3 tip dosya formatı destekliyor :

  • Scalable Vector Graphics (.svg)
  • Portable Network Graphics (.png)
  • Portable Network Graphics (.png)

İsteğiniz dosya tipini url'nin sonundaki uzantı ile control edebilirsiniz. Mesela views.svg, views.json vb.

Özelleştirme#

Grafiğinizi query parametreleri ile özelleştirebilirsiniz.

Bütün query parametreleri isteğe bağlı dır.

ÖzellikVarsayılanAçıklamaÖrnek
width1000Grafiğin genişliğini ayarlar/bots/690214077490004030/views.svg?width=1280
height500Grafiğin yüksekliğini ayarlar/bots/690214077490004030/views.svg?height=720
themedarkYazıların rengini değiştirir. dark yada light./bots/690214077490004030/views.svg?theme=light
localeenTarih yazılarının dilini değiştirir. en yada tr./bots/690214077490004030/views.svg?locale=tr

Bot Takma Adları#

Eğer botun takma adı varsa, botId yerine onuda kullanabilirsiniz.

Örnek : https://charts.dclist.net/bots/technobot/views.svg?width=1280&height=720