İfadeler¶

İfade, özel bir emoji ya da bir çıkartmadır. Sunuculara ait ifadeler Sunucu emojileri ve Sunucu çıkartmaları üzerinden yönetilir. Bu sayfa; bir ifadeyi sunucusuna üye olmadan okuyan yolları, çağıranın kullanabileceği tüm ifadelerin listelerini ve ifade paketlerini kapsar.

Tüm yollar https://tebhos.com/api/v1 adresine görelidir ve kimlik doğrulama gerektirir. Yalnızca kullanıcı olarak işaretlenen yollar geçerli bir bot token'ını 403 ACCESS_DENIED ile reddeder; diğerleri bot token'larını da kabul eder. Hata gövdeleri Hatalar sayfasına uyar.

İfade kimlikleri snowflake dizeleridir. emoji_id veya sticker_id alan her yol, Emoji kimlikleri bölümünde anlatılan eski UUID biçimini de kabul eder. Bilinmeyen bir kimlik 404 NOT_FOUND döndürür.

Emoji meta verisi nesnesi¶

Sunucusunun dışından görüldüğü biçimiyle özel bir emoji.

{
  "id": "1501314428688998182",
  "legacy_id": "b4497791-c19c-4b6b-9a2f-df4bc155a9f7",
  "guild_id": "1489002177550843904",
  "name": "party_parrot",
  "animated": true,
  "allow_cloning": true
}

Çıkartma meta verisi nesnesi¶

Sunucusunun dışından görüldüğü biçimiyle bir çıkartma.

Emoji meta verisini al¶

GET /emojis/{emoji_id}/metadata

Herhangi bir sunucu emojisinin emoji meta verisi nesnesini döndürür. Sahip sunucuya üyelik veya herhangi bir izin gerekmez.

Hız sınırı: guild:emoji:metadata, istemci başına 10 saniyede 60.

curl https://tebhos.com/api/v1/emojis/1501314428688998182/metadata \
  -H "Authorization: Bot $TEBHOS_BOT_TOKEN"

Çıkartma meta verisini al¶

GET /stickers/{sticker_id}/metadata

Herhangi bir sunucu çıkartmasının çıkartma meta verisi nesnesini döndürür. Sahip sunucuya üyelik veya herhangi bir izin gerekmez.

Hız sınırı: guild:sticker:metadata, istemci başına 10 saniyede 60.

Çıkartmayı al¶

GET /stickers/{sticker_id}

Görüntüleme için tek bir çıkartma döndürür; örneğin bir mesaj, okuyanın üyesi olmadığı bir sunucunun çıkartmasını gösterdiğinde. Üyelik gerekmez. Diğer yollardan farklı olarak alanlar camelCase'tir:

Sunucu emojilerimi listele¶

GET /users/@me/guild-emojis

Çağıranın üyesi olduğu her sunucunun her özel emojisini {"items": [...]} olarak döndürür. İstemciler bunu emoji seçici oluşturmak için kullanır. Her öğede id, legacy_id, guild_id, guild_name, name, image_url ve animated bulunur. Sunucular sunucu adı sırasına göre gruplanır.

Bir sunucu kanalında, mesajda veya yeni bir tepki olarak başka bir sunucunun emojisini göndermek hem o sunucuda USE_EXTERNAL_EMOJIS iznini hem de TEBHOS Pro'yu gerektirir; aksi hâlde istek 403 FORBIDDEN ile başarısız olur. DM'lerde böyle bir denetim yoktur.

Sunucu çıkartmalarımı listele¶

GET /users/@me/guild-stickers

Çağıranın üyesi olduğu her sunucunun her çıkartmasını {"items": [...]} olarak döndürür. Her öğede id, legacy_id, guild_id, guild_name, name, description ve image_url bulunur.

Bir sunucu kanalında başka bir sunucunun çıkartmasını göndermek hem o sunucuda USE_EXTERNAL_STICKERS iznini hem de TEBHOS Pro'yu gerektirir; aksi hâlde istek 403 FORBIDDEN ile başarısız olur. Bir mesaj en fazla 3 çıkartma taşıyabilir.

İfade paketleri¶

İfade paketi, bir sunucu yerine tek bir hesaba ait kişisel bir emoji (emoji paketi) veya çıkartma (çıkartma paketi) koleksiyonudur. Paketler bir TEBHOS Pro özelliğidir: bir hesap yalnızca TEBHOS Pro'su olduğu sürece paket oluşturabilir ve kurabilir.

Her paket yolu yalnızca kullanıcıya açıktır ve yol hız sınırı yoktur.

Paket sınırları¶

Bir sınıra ulaşmak 400 BAD_REQUEST döndürür.

Paket özeti nesnesi¶

{
  "id": "1502001122334455667",
  "name": "Workshop reactions",
  "description": null,
  "type": "emoji",
  "creator_id": "1489002177550843905",
  "created_at": "2026-09-14T09:12:44+00:00",
  "updated_at": "2026-09-14T09:12:44+00:00"
}

Paketlerimi listele¶

GET /packs

Çağıranın oluşturduğu ve kurduğu paketleri türe göre gruplanmış olarak döndürür:

{
  "emoji": {"installed_limit": 50, "created_limit": 50, "installed": [], "created": []},
  "sticker": {"installed_limit": 50, "created_limit": 50, "installed": [], "created": []}
}

Her liste paket özeti nesnelerini tutar. TEBHOS Pro'su olmayan bir hesap için sınırlar 0 olur.

Paket oluştur¶

POST /packs/{pack_type}

Boş bir paket oluşturur ve paket özeti nesnesini döndürür. {pack_type} değeri emoji veya sticker'dır; diğer her değer 400 BAD_REQUEST döndürür.

Paketi değiştir¶

PATCH /packs/{pack_id}

Bir paketi yeniden adlandırır ve paket özeti nesnesini döndürür. Paketi yalnızca oluşturan değiştirebilir (aksi hâlde 403 FORBIDDEN).

Paketi sil¶

DELETE /packs/{pack_id}

Bir paketi siler. Yalnızca oluşturan silebilir. 204 döndürür.

Paket öğeleri¶

Oluşturan, bir paketin öğelerini bu yollarla yönetir. Paket eşleşen türde olmalıdır, aksi hâlde istek 400 BAD_REQUEST ile başarısız olur; başkasına ait bir paket 403 FORBIDDEN döndürür.

Paket öğeleri için image bir data: URL'si (örneğin data:image/png;base64,...) olmalıdır; ham base64 reddedilir. Biçimi bildirilen medya türü belirler; GIF, animasyonlu PNG veya animasyonlu WebP animated olarak işaretlenir. Öğe yolları oluşturulan veya güncellenen öğeyi user olmadan döndürür.

Silme yolları purge=true sorgu parametresini kabul eder; bu, saklanan görsel dosyasını da siler.

Paket davetleri¶

GET /packs/{pack_id}/invites paketin davet kodlarını listeler, POST /packs/{pack_id}/invites ise bir tane oluşturur. Bunları yalnızca oluşturan kullanabilir.

Bir paketin en fazla 1000 daveti olabilir. Her paket davet nesnesinde code, type (emoji paketi için 2, çıkartma paketi için 3), pack (paket özeti artı creator), inviter, expires_at, temporary, created_at, uses ve max_uses bulunur.

Paketi kur¶

POST /packs/{pack_id}/install

Bir paketi çağıranın kurulu paketlerine ekler ve 204 döndürür. Mevcut herhangi bir paket kurulabilir. Kurulum TEBHOS Pro gerektirir ve paketin türü için kurulu paket sınırına sayılır.

DELETE /packs/{pack_id}/install kurulu bir paketi kaldırır ve 204 döndürür.