Temalar¶

Tema, kısa bir tanımlayıcı altında saklanan özel bir CSS stil sayfasıdır; tanımlayıcıya sahip olan herkes onu alabilir. HTTP API'de tek bir işlem vardır: tema saklamak. Saklanan stil sayfası daha sonra herkese açık bir dosya olarak sunulur.

Yol yalnızca kullanıcıya yöneliktir: bot token'ı 403 ACCESS_DENIED ile reddedilir.

Tema tanımlayıcısı¶

Tema tanımlayıcısı, rastgele seçilen 16 küçük harfli onaltılık karakterdir (^[a-f0-9]{16}$). Aynı CSS'i iki kez göndermek iki bağımsız tema oluşturur.

{
  "id": "3f0a91c7d2b84e65"
}

Belge sınırları¶

Sınır	Değer
En büyük boyut	8388608 bayt (8 MiB) UTF-8, dahil
En küçük boyut	1 bayt

Hesap başına tema kotası yoktur; bir hesabın kaç tema oluşturabileceğinin tek sınırı theme:share:create hız sınırıdır.

TEBHOS CSS'i olduğu gibi saklar. CSS ayrıştırılmaz, doğrulanmaz, küçültülmez veya yeniden yazılmaz.

Tema oluştur¶

POST /users/@me/themes

Bir CSS belgesini saklar ve tema tanımlayıcısıyla birlikte 201 döndürür. Hiçbir izin gerekmez.

JSON gövdesi¶

Alan	Tür	Açıklama
css	string	Saklanacak CSS metni (1 bayt ile 8 MiB arası)

Yanıt¶

Durum	Gövde	Koşul
201	`{"id": string}`	Belge saklandı
400	hata yanıtı	`css` boş veya 8 MiB'den büyük (`BAD_REQUEST`) ya da gövde, dize türünde `css` içeren bir JSON nesnesi değil
403	hata yanıtı	Çağıran bir bot (`ACCESS_DENIED`)

Yan etkiler¶

Belge, tanımlayıcı döndürülmeden önce text/css; charset=utf-8 içerik türüyle themes/{id}.css olarak saklanır. Herkese açık olarak şu adreste sunulur:

https://tebhos.com/api/v1/files/themes/{id}.css

Tema CSS'i herkese açık ve kalıcıdır

Saklanan bir belgeyi koruyan tek şey tanımlayıcıdır ve okuma URL'si kimlik doğrulama gerektirmez. API saklanan bir temayı değiştiremez veya silemez. Bir temaya asla token veya başka bir gizli bilgi koymayın.

Hız sınırı¶

theme:share:create kovasında, istemci başına dakikada 20 istek.

Örnek¶

curl -X POST "https://tebhos.com/api/v1/users/@me/themes" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"css":":root { --background-primary: #101014; }"}'