400Geçersiz istek: eksik ya da hatalı alan, bilinmeyen alan adı (validation_error).
401API anahtarı yok, geçersiz ya da iptal edilmiş (unauthorized).
403Kapsam yok (scope), plan izin vermiyor (plan_limit), rol yetmiyor (forbidden_role), e-posta doğrulanmamış (email_not_verified) ya da organizasyon askıda.
429Anahtar, kullanıcı ya da organizasyon istek sınırı (X-RateLimit-Scope) veya aylık mesaj kotası aşıldı; Retry-After başlığına uyun.
Şablonun hazır taslağıyla, yayınlanmamış başlar. Bot kanala bağlı olmalıdır (409 not_connected). form_preset yalnız form şablonunda kullanılır. Yönetici yetkisi gerekir. Kapsam: miniapps:write.
İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.len 1–255
400Geçersiz istek: eksik ya da hatalı alan, bilinmeyen alan adı (validation_error).
401API anahtarı yok, geçersiz ya da iptal edilmiş (unauthorized).
403Kapsam yok (scope), plan izin vermiyor (plan_limit), rol yetmiyor (forbidden_role), e-posta doğrulanmamış (email_not_verified) ya da organizasyon askıda.
404Kayıt bulunamadı ya da bu anahtar erişemiyor (not_found).
409İşlem bu durumda yapılamıyor; kod nedeni söyler.not_connected
429Anahtar, kullanıcı ya da organizasyon istek sınırı (X-RateLimit-Scope) veya aylık mesaj kotası aşıldı; Retry-After başlığına uyun.
400Geçersiz istek: eksik ya da hatalı alan, bilinmeyen alan adı (validation_error).
401API anahtarı yok, geçersiz ya da iptal edilmiş (unauthorized).
403Kapsam yok (scope), plan izin vermiyor (plan_limit), rol yetmiyor (forbidden_role), e-posta doğrulanmamış (email_not_verified) ya da organizasyon askıda.
404Kayıt bulunamadı ya da bu anahtar erişemiyor (not_found).
429Anahtar, kullanıcı ya da organizasyon istek sınırı (X-RateLimit-Scope) veya aylık mesaj kotası aşıldı; Retry-After başlığına uyun.
400Geçersiz istek: eksik ya da hatalı alan, bilinmeyen alan adı (validation_error).
401API anahtarı yok, geçersiz ya da iptal edilmiş (unauthorized).
403Kapsam yok (scope), plan izin vermiyor (plan_limit), rol yetmiyor (forbidden_role), e-posta doğrulanmamış (email_not_verified) ya da organizasyon askıda.
404Kayıt bulunamadı ya da bu anahtar erişemiyor (not_found).
429Anahtar, kullanıcı ya da organizasyon istek sınırı (X-RateLimit-Scope) veya aylık mesaj kotası aşıldı; Retry-After başlığına uyun.
notify true ise müşteriye bot üzerinden durum mesajı gider; bunun için messages:send kapsamı da gerekir. Durum değişip bildirim gidemezse yanıt yine 200'dür ve data.notification { sent: false, error } içerir. Kapsam: write.
400Geçersiz istek: eksik ya da hatalı alan, bilinmeyen alan adı (validation_error).
401API anahtarı yok, geçersiz ya da iptal edilmiş (unauthorized).
403Kapsam yok (scope), plan izin vermiyor (plan_limit), rol yetmiyor (forbidden_role), e-posta doğrulanmamış (email_not_verified) ya da organizasyon askıda.
404Kayıt bulunamadı ya da bu anahtar erişemiyor (not_found).
429Anahtar, kullanıcı ya da organizasyon istek sınırı (X-RateLimit-Scope) veya aylık mesaj kotası aşıldı; Retry-After başlığına uyun.
400Geçersiz istek: eksik ya da hatalı alan, bilinmeyen alan adı (validation_error).
401API anahtarı yok, geçersiz ya da iptal edilmiş (unauthorized).
403Kapsam yok (scope), plan izin vermiyor (plan_limit), rol yetmiyor (forbidden_role), e-posta doğrulanmamış (email_not_verified) ya da organizasyon askıda.
404Kayıt bulunamadı ya da bu anahtar erişemiyor (not_found).
429Anahtar, kullanıcı ya da organizasyon istek sınırı (X-RateLimit-Scope) veya aylık mesaj kotası aşıldı; Retry-After başlığına uyun.
400Geçersiz istek: eksik ya da hatalı alan, bilinmeyen alan adı (validation_error).miniapp_invalid
401API anahtarı yok, geçersiz ya da iptal edilmiş (unauthorized).
403Kapsam yok (scope), plan izin vermiyor (plan_limit), rol yetmiyor (forbidden_role), e-posta doğrulanmamış (email_not_verified) ya da organizasyon askıda.
404Kayıt bulunamadı ya da bu anahtar erişemiyor (not_found).
429Anahtar, kullanıcı ya da organizasyon istek sınırı (X-RateLimit-Scope) veya aylık mesaj kotası aşıldı; Retry-After başlığına uyun.
Uygulama, sürümleri ve gönderimleri geri alınamaz biçimde silinir; menü düğmesine bağlıysa Telegram menüsü varsayılana döner. Yönetici yetkisi gerekir. Kapsam: miniapps:write.
400Geçersiz istek: eksik ya da hatalı alan, bilinmeyen alan adı (validation_error).
401API anahtarı yok, geçersiz ya da iptal edilmiş (unauthorized).
403Kapsam yok (scope), plan izin vermiyor (plan_limit), rol yetmiyor (forbidden_role), e-posta doğrulanmamış (email_not_verified) ya da organizasyon askıda.
404Kayıt bulunamadı ya da bu anahtar erişemiyor (not_found).
429Anahtar, kullanıcı ya da organizasyon istek sınırı (X-RateLimit-Scope) veya aylık mesaj kotası aşıldı; Retry-After başlığına uyun.
Taslaktan yeni değişmez sürüm oluşur ve herkese açılır; yayın onayı açıksa sürüm onay bekler ve yayındaki sürüm değişmez. Plan Mini App içermiyorsa 403 plan_limit, taslak geçersizse 400 miniapp_invalid döner. Yönetici yetkisi gerekir. Kapsam: miniapps:write.
İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.len 1–255
400Geçersiz istek: eksik ya da hatalı alan, bilinmeyen alan adı (validation_error).miniapp_invalid
401API anahtarı yok, geçersiz ya da iptal edilmiş (unauthorized).
403Kapsam yok (scope), plan izin vermiyor (plan_limit), rol yetmiyor (forbidden_role), e-posta doğrulanmamış (email_not_verified) ya da organizasyon askıda.plan_limit
404Kayıt bulunamadı ya da bu anahtar erişemiyor (not_found).
429Anahtar, kullanıcı ya da organizasyon istek sınırı (X-RateLimit-Scope) veya aylık mesaj kotası aşıldı; Retry-After başlığına uyun.
İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.len 1–255
400Geçersiz istek: eksik ya da hatalı alan, bilinmeyen alan adı (validation_error).
401API anahtarı yok, geçersiz ya da iptal edilmiş (unauthorized).
403Kapsam yok (scope), plan izin vermiyor (plan_limit), rol yetmiyor (forbidden_role), e-posta doğrulanmamış (email_not_verified) ya da organizasyon askıda.
404Kayıt bulunamadı ya da bu anahtar erişemiyor (not_found).
429Anahtar, kullanıcı ya da organizasyon istek sınırı (X-RateLimit-Scope) veya aylık mesaj kotası aşıldı; Retry-After başlığına uyun.
Verilen sürüm yeniden yayına alınır, taslak değişmez. Plan Mini App içermiyorsa 403 plan_limit döner; sürüm bu uygulamanın değilse 404. Yönetici yetkisi gerekir. Kapsam: miniapps:write.
İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.len 1–255
400Geçersiz istek: eksik ya da hatalı alan, bilinmeyen alan adı (validation_error).
401API anahtarı yok, geçersiz ya da iptal edilmiş (unauthorized).
403Kapsam yok (scope), plan izin vermiyor (plan_limit), rol yetmiyor (forbidden_role), e-posta doğrulanmamış (email_not_verified) ya da organizasyon askıda.plan_limit
404Kayıt bulunamadı ya da bu anahtar erişemiyor (not_found).
429Anahtar, kullanıcı ya da organizasyon istek sınırı (X-RateLimit-Scope) veya aylık mesaj kotası aşıldı; Retry-After başlığına uyun.
enabled true botun menü düğmesini bu uygulamaya bağlar (uygulama yayında olmalı), false varsayılana döndürür. Bir botun tek menü düğmesi olur. Yayında değilse ya da bot bağlı değilse 409, Telegram reddederse 502 döner. Yönetici yetkisi gerekir. Kapsam: miniapps:write.
İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.len 1–255
400Geçersiz istek: eksik ya da hatalı alan, bilinmeyen alan adı (validation_error).
401API anahtarı yok, geçersiz ya da iptal edilmiş (unauthorized).
403Kapsam yok (scope), plan izin vermiyor (plan_limit), rol yetmiyor (forbidden_role), e-posta doğrulanmamış (email_not_verified) ya da organizasyon askıda.
404Kayıt bulunamadı ya da bu anahtar erişemiyor (not_found).
409İşlem bu durumda yapılamıyor; kod nedeni söyler.
429Anahtar, kullanıcı ya da organizasyon istek sınırı (X-RateLimit-Scope) veya aylık mesaj kotası aşıldı; Retry-After başlığına uyun.
400Geçersiz istek: eksik ya da hatalı alan, bilinmeyen alan adı (validation_error).
401API anahtarı yok, geçersiz ya da iptal edilmiş (unauthorized).
403Kapsam yok (scope), plan izin vermiyor (plan_limit), rol yetmiyor (forbidden_role), e-posta doğrulanmamış (email_not_verified) ya da organizasyon askıda.
404Kayıt bulunamadı ya da bu anahtar erişemiyor (not_found).
429Anahtar, kullanıcı ya da organizasyon istek sınırı (X-RateLimit-Scope) veya aylık mesaj kotası aşıldı; Retry-After başlığına uyun.
Taslağı gösteren, 2 saat geçerli imzalı adres ve taslak yapılandırma döner. Adresi yalnız güvendiğiniz kişilerle paylaşın. Taslak geçersizse valid false olur ve errors doldurulur. Kapsam: miniapps:read.
Kapsam
miniapps:read
SDK metodu
getMiniAppPreview · get_mini_app_preview
MCP aracı
getMiniAppPreviewsalt okunur
Parametreler
Ad
Tür
Zorunlu
Açıklama
idyol
uuid
evet
id kimliği
Örnek istek
curl -X GET "https://hiboty.com/api/v1/miniapps/3fa85f64-5717-4562-b3fc-2c963f66afa6/preview" \
-H "Authorization: Bearer $HIBOTY_API_KEY"
400Geçersiz istek: eksik ya da hatalı alan, bilinmeyen alan adı (validation_error).
401API anahtarı yok, geçersiz ya da iptal edilmiş (unauthorized).
403Kapsam yok (scope), plan izin vermiyor (plan_limit), rol yetmiyor (forbidden_role), e-posta doğrulanmamış (email_not_verified) ya da organizasyon askıda.
404Kayıt bulunamadı ya da bu anahtar erişemiyor (not_found).
429Anahtar, kullanıcı ya da organizasyon istek sınırı (X-RateLimit-Scope) veya aylık mesaj kotası aşıldı; Retry-After başlığına uyun.
En yeni önce. Üye rolü yalnız erişebildiği botların siparişlerini görür. Telegram Stars iadesi API'de yoktur: geri alınamaz para hareketi olduğu için panelde yapılır. Kapsam: miniapps:read.
400Geçersiz istek: eksik ya da hatalı alan, bilinmeyen alan adı (validation_error).
401API anahtarı yok, geçersiz ya da iptal edilmiş (unauthorized).
403Kapsam yok (scope), plan izin vermiyor (plan_limit), rol yetmiyor (forbidden_role), e-posta doğrulanmamış (email_not_verified) ya da organizasyon askıda.
429Anahtar, kullanıcı ya da organizasyon istek sınırı (X-RateLimit-Scope) veya aylık mesaj kotası aşıldı; Retry-After başlığına uyun.
Google Merchant XML/RSS, CSV ya da JSON beslemesini katalog şablonlu Mini App'in taslağına aktarır; yalnız url ya da content verilir. İlk 50 ürün alınır, fazlası warnings içinde bildirilir; aynı kimlikli ürünlerin yıldız fiyatı ve teslimat içeriği korunur. Yayındaki sürüm değişmez, yayın elle yapılır. dry_run true ise yalnız önizleme döner. auto_refresh true ise adres saklanır ve taslak günde bir yenilenir. ai_knowledge true ise katalog botun AI bilgi kaynağına da yazılır. Adres herkese açık olmalıdır; iç ağ adresleri 400 feed_invalid döner. Saatte en fazla 30 istek. Yönetici yetkisi gerekir. Kapsam: miniapps:write.
İsteğe bağlı, 1-255 görünür ASCII karakter. Aynı anahtar ve gövdeyle 24 saat içinde ilk yanıt aynen döner; farklı gövdede 409 idempotency_conflict.len 1–255
Gövde alanları
Ad
Tür
Zorunlu
Açıklama
url
string
hayır
Herkese açık http/https besleme adresilen ≤ 2000
content
string
hayır
Beslemenin kendisi (dosya içeriği)len ≤ 2000000
format
enum
hayır
Verilmezse içerikten tahmin edilirxml | csv | json
400Geçersiz istek: eksik ya da hatalı alan, bilinmeyen alan adı (validation_error).feed_invalid
401API anahtarı yok, geçersiz ya da iptal edilmiş (unauthorized).
403Kapsam yok (scope), plan izin vermiyor (plan_limit), rol yetmiyor (forbidden_role), e-posta doğrulanmamış (email_not_verified) ya da organizasyon askıda.
404Kayıt bulunamadı ya da bu anahtar erişemiyor (not_found).
409İşlem bu durumda yapılamıyor; kod nedeni söyler.
429Anahtar, kullanıcı ya da organizasyon istek sınırı (X-RateLimit-Scope) veya aylık mesaj kotası aşıldı; Retry-After başlığına uyun.
İçerik özeti (config_sha256) doğrulanır ve sürüm yayına girer; özet tutmazsa 409 integrity döner. Plan Mini App içermiyorsa 403 plan_limit. Yönetici yetkisi gerekir. Dört göz açıkken değişikliği yapan kişi onaylayamaz (403 four_eyes); API anahtarıyla onay verilemez. Kapsam: miniapps:write.
Kapsam
miniapps:write
SDK metodu
approveMiniAppVersion · approve_mini_app_version
MCP aracı
approveMiniAppVersiondış etkili
Parametreler
Ad
Tür
Zorunlu
Açıklama
idyol
uuid
evet
id kimliği
version_idyol
uuid
evet
version_id kimliği
Örnek istek
curl -X POST "https://hiboty.com/api/v1/miniapps/3fa85f64-5717-4562-b3fc-2c963f66afa6/versions/3fa85f64-5717-4562-b3fc-2c963f66afa6/approve" \
-H "Authorization: Bearer $HIBOTY_API_KEY"
400Geçersiz istek: eksik ya da hatalı alan, bilinmeyen alan adı (validation_error).
401API anahtarı yok, geçersiz ya da iptal edilmiş (unauthorized).
403Kapsam yok (scope), plan izin vermiyor (plan_limit), rol yetmiyor (forbidden_role), e-posta doğrulanmamış (email_not_verified) ya da organizasyon askıda.plan_limitfour_eyes
404Kayıt bulunamadı ya da bu anahtar erişemiyor (not_found).
409İşlem bu durumda yapılamıyor; kod nedeni söyler.integrity
429Anahtar, kullanıcı ya da organizasyon istek sınırı (X-RateLimit-Scope) veya aylık mesaj kotası aşıldı; Retry-After başlığına uyun.
400Geçersiz istek: eksik ya da hatalı alan, bilinmeyen alan adı (validation_error).
401API anahtarı yok, geçersiz ya da iptal edilmiş (unauthorized).
403Kapsam yok (scope), plan izin vermiyor (plan_limit), rol yetmiyor (forbidden_role), e-posta doğrulanmamış (email_not_verified) ya da organizasyon askıda.
404Kayıt bulunamadı ya da bu anahtar erişemiyor (not_found).
429Anahtar, kullanıcı ya da organizasyon istek sınırı (X-RateLimit-Scope) veya aylık mesaj kotası aşıldı; Retry-After başlığına uyun.