Değişiklikler
getMe yanıtındaki inki_api_version alanı geçerli sürümü verir. Sürüm MAJOR.MINOR.PATCH biçimindedir:
- MAJOR — uyumsuz değişiklik (önceden duyurulur),
- MINOR — yeni yöntem, bileşen ya da alan (mevcut kodun bozulmaz),
- PATCH — düzeltme.
İpucu: Bilinmeyen alanları yok sayacak şekilde yaz. Yeni bir MINOR sürümde nesnelere yeni alanlar eklenebilir.
1.5.0 — Bildirim kategorilerini okuma#
- Yeni:
inkiGetNotificationCategoriesAtölye → Bildirimler'deki kategorilerini[{key, name, description, type, position}]olarak döner. Kodundaki kategori anahtarlarının ve türlerinin Atölye'dekiyle aynı olduğunu denetlemek için — Kategorileri koddan okumak.
1.4.0 — Damla aramaları + Mini App bildirimleri + oyun odaları#
- Yeni: Damla aramaları.
inkiDamlaCallile kullanıcı, açık izniyle, inkiveta'nın sesli asistanı Damla'ya aratılır; sorduğun alanların cevaplarıinki_damla_call_resultile tipli değer olarak gelir. 1 dakika 5,00 TL (başlayan dakika), bağlanmayan arama ücretsiz. Bakiye yalnız dakika paketiyle, geliştirici panelinden (web) yüklenir. İzin:Inki.inkiRequestCallAccess/inkiRequestCallAccess, updateinki_call_access. Her istekte amaç beyanı (purpose_declaration+service_only) zorunludur; pazarlama araması İYS onayı ister — Damla aramaları. - Diğer yeni yöntemler:
inkiCancelDamlaCall,inkiGetDamlaCall,inkiGetDamlaCallBalance,inkiGetDamlaCallTransactions. - Yeni: Mini App bildirimleri.
inkiSendNotificationile kullanıcıya bildirim gönderirsin; bildirim kullanıcının bildirim merkezine düşer (sohbete yazılmaz, sohbet botu gerekmez), yanıt{notification_id}; dokununca sohbet değil doğrudan Mini App açılır vestart_paraminitData.start_param'da gelir (Mini App açıksainki_notification_openedolayı). Atölye → Bildirimler'de en çok 8 kategori (islem,hatirlatma,tanitim); tanıtım kategorisi kullanıcı açıkça açmadıkça kapalıdır. Kullanıcı tercih değiştirinceinki_notification_settingsupdate'i gelir. Sınırlar kayan 24 saatte kişi başınaislem20 ·hatirlatma3 ·tanitim1 — Mini App bildirimleri. - Yeni: gerçek zamanlı oyun odaları. Sunucun
inkiCreateGameRoomile oda açar; Mini AppInki.inkiJoinGameRoom(room_id, cb)ile tek kullanımlık, 30 saniyelik bir bilet alıpwss://app.inkiveta.com/oyun-ws'e doğrudan bağlanır. İki sınıf:relay(hamleler herkese; oyuncular birbirini tanımalı) vehost(hamleler yalnız senin hakem sunucuna; yabancılar eşleşebilir). Odada herkes koltuk numarasıyla görünür. Kapanışinki_game_roomupdate'iyle gelir;setGameScore'agame_room_idverince platform kişinin odada oynadığını doğrular (room_verified). Sunucusu olmayan Mini App odayıInki.inkiCreateGameRoomile açıp davet bağlantısı paylaşır. Oyun odaları şu an ücretsizdir; sınırlar ve fiyatlandırma ileride değişebilir, değişiklik Değişiklikler sayfasında önceden duyurulur. Ayrıntı: Oyun odaları. - Diğer yeni yöntemler:
inkiGetGameRoom,inkiAddGameRoomPlayer,inkiRemoveGameRoomPlayer,inkiCloseGameRoom,inkiGetGameRoomHostTicket.
Kısa uygulama bağlantısı (14 Kasım 2026; API sürümü değişmedi)#
- Uygulamanın bağlantısı artık kısa:
https://inkiveta.com/@<kullanici_adi>,?start=<parametre>ya da?startapp=<parametre>ile. Uzun biçimhttps://app.inkiveta.com/bot/<kullanici_adi>geçerli kalır; paylaşılmış bağlantılar bozulmaz. Eski uygulama sürümlerinde ve tarayıcıda kısa bağlantı uzun biçime yönlendirilir — Mini App → Nasıl açılır?.
1.3.1 — Mini App dosya isteği: 24 saatlik saklama#
inkiRequestFileile gelen dosya platformda 24 saat kalır. Bu sürede aynıfile_id'yi uygulamanın bir içeriğinde (mesaj gönderimi ya da düzenlemesi, bileşen ya da ana sayfa medyası, zengin mesaj, oyun fotoğrafı) kullanmazsan silinir; sonragetFilehata verir.getFileile indirmek kullanım sayılmaz. Dosyayı kalıcı tutman gerekiyorsa 24 saat içinde kendi sunucuna indir. İçerikte kullandığın dosya uygulamanın dosyası olur: kalır ve depo kotana girer — Mini App → Dosya isteği.
1.3.0 — Mini App dosya isteği#
- **Yeni köprü uzantısı
Inki.inkiRequestFile({type}, cb)** (olayinki_request_file,type=photo|video|document): Mini App'te<input type="file">çalışmaz; kullanıcıdan dosya almak için bunu kullan. Kullanıcı onaylayınca uygulamanın kendi seçicisi açılır, dosya uygulamana yüklenir ve sayfanafile_iddöner — Mini App → Dosya isteği.
1.2.0 — profil bilgisi izni, photo_url, last_name#
- Başlat ekranında izinler: kullanıcı uygulamayı başlatırken görünen adını, kullanıcı adını ve profil resmini paylaşıp paylaşmayacağını seçer; sonradan uygulama ayarlarından değiştirir.
- **
last_name:** görünen ad izniyle ad iki parçaya ayrılır (son kelimelast_name; tek kelimeyse yok). Updatefrom,getChat, Mini AppinitData.uservelogin_urlaynı kuralla. - **
photo_url:** profil resmi izni varsa Mini AppinitData.uservelogin_urlalanlarında 24 saat geçerli imzalı resim adresi. - **Yeni köprü uzantısı
Inki.inkiRequestProfileAccess(fields, cb)** (olayinki_request_profile_access): Mini App çalışırken eksik izni kullanıcıdan ister; onayda yeni imzalıinitDatadöner — Mini App → Profil bilgisi.
1.1.0 — Ink hediyesi, Mini App yön isteği, oyun liderlik tablosu#
- **
inkiGiftInk(user_id, amount, idempotency_key): uygulama, sahibinin Atölye'den yüklediği hediye bütçesinden** kullanıcıya 1–10.000 Ink gönderir. Hediye bütçesi satış kazancından ayrıdır. Aynıidempotency_keyikinci kez ödemez; farklı alıcı/tutarla tekrar400 IDEMPOTENCY_KEY_REUSEDdöner. HediyelergetStarTransactions'tagift_purchaseolarak listelenir. - **Mini App yön isteği
Inki.inkiRequestOrientation('landscape' | 'portrait' | 'auto')** — Mini App → Ekran yönü. - Oyun liderlik tablosu:
setGameScore/getGameHighScoresoyun başına uygulama genelinde tek tablo tutar;getGameHighScoresilk 20'yi ve istenen kişinin komşu satırlarını gerçekpositionile döner. Mini App oyunlarındachat_id/message_idyerinegame_short_nameile mesajsız da çağrılır (sunucuninitData'yı doğrulayıp skoru yazar).
1.0.0 — ilk sürüm#
- Telegram uyumu: Bot API 10.4'ün özel sohbet alt kümesi; her yöntemin durumu Yöntem listesi'nde.
- Update türleri:
message,edited_message,callback_query,message_reaction,my_chat_member,poll,poll_answer,pre_checkout_query,shipping_query,purchased_paid_media,subscription,managed_bot,stopped_message_generation,widget_queryve inkiveta uzantılarıinki_component_action,inki_feedback,inki_data_deletion_request. - Yerel bileşenler: 57 bileşen (
home_pagedahil), hepsiversion: 1— Bileşenler. - Uzantı yöntemleri:
inkiSendComponent,inkiEditMessageComponent,inkiSetHomePage,inkiSetQuickActions,inkiAnswerComponentAction,inkiConfirmDataDeletion. - **Bileşen eylemi
close:** kullanıcı bir form ya da sayfa bileşenini kapatıncaaction: "close",values: {}gelir; yanıt beklenmez.confirmbileşeninin "Vazgeç" düğmesiclosedeğil,submit+action_id'dir. - Bildirim sıklığı: kullanıcı sıklığı değiştirince
my_chat_member+inki_frequency. - Veri silme onayı:
inkiConfirmDataDeletion(user_id, request_id). - Ödemeler: Stars yerine Ink (
XTRveINKkabul), abonelik, ücretli medya, iade. - Mini App: Telegram uyumlu
initData(HMAC) + inkiveta Ed25519 imzası (getMe.inki_signature_public_key). - Keşfet: uygunluk ölçütleri ve başlangıç sıralama ağırlıkları — Yayına alma.