Geliştirici paneli inkiveta.com

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: inkiGetNotificationCategories Atö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ı. inkiDamlaCall ile kullanıcı, açık izniyle, inkiveta'nın sesli asistanı Damla'ya aratılır; sorduğun alanların cevapları inki_damla_call_result ile 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, update inki_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. inkiSendNotification ile 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 ve start_param initData.start_param'da gelir (Mini App açıksa inki_notification_opened olayı). 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ştirince inki_notification_settings update'i gelir. Sınırlar kayan 24 saatte kişi başına islem 20 · hatirlatma 3 · tanitim 1 — Mini App bildirimleri.
  • Yeni: gerçek zamanlı oyun odaları. Sunucun inkiCreateGameRoom ile oda açar; Mini App Inki.inkiJoinGameRoom(room_id, cb) ile tek kullanımlık, 30 saniyelik bir bilet alıp wss://app.inkiveta.com/oyun-ws'e doğrudan bağlanır. İki sınıf: relay (hamleler herkese; oyuncular birbirini tanımalı) ve host (hamleler yalnız senin hakem sunucuna; yabancılar eşleşebilir). Odada herkes koltuk numarasıyla görünür. Kapanış inki_game_room update'iyle gelir; setGameScore'a game_room_id verince platform kişinin odada oynadığını doğrular (room_verified). Sunucusu olmayan Mini App odayı Inki.inkiCreateGameRoom ile 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çim https://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#

  • inkiRequestFile ile 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; sonra getFile hata verir. getFile ile 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)** (olay inki_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 sayfana file_id dö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 kelime last_name; tek kelimeyse yok). Update from, getChat, Mini App initData.user ve login_url aynı kuralla.
  • **photo_url:** profil resmi izni varsa Mini App initData.user ve login_url alanlarında 24 saat geçerli imzalı resim adresi.
  • **Yeni köprü uzantısı Inki.inkiRequestProfileAccess(fields, cb)** (olay inki_request_profile_access): Mini App çalışırken eksik izni kullanıcıdan ister; onayda yeni imzalı initData dö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_key ikinci kez ödemez; farklı alıcı/tutarla tekrar 400 IDEMPOTENCY_KEY_REUSED döner. Hediyeler getStarTransactions'ta gift_purchase olarak listelenir.
  • **Mini App yön isteği Inki.inkiRequestOrientation('landscape' | 'portrait' | 'auto')** — Mini App → Ekran yönü.
  • Oyun liderlik tablosu: setGameScore / getGameHighScores oyun başına uygulama genelinde tek tablo tutar; getGameHighScores ilk 20'yi ve istenen kişinin komşu satırlarını gerçek position ile döner. Mini App oyunlarında chat_id/message_id yerine game_short_name ile mesajsız da çağrılır (sunucun initData'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_query ve inkiveta uzantıları inki_component_action, inki_feedback, inki_data_deletion_request.
  • Yerel bileşenler: 57 bileşen (home_page dahil), hepsi version: 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ınca action: "close", values: {} gelir; yanıt beklenmez. confirm bileşeninin "Vazgeç" düğmesi close değ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 (XTR ve INK kabul), 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.