Değişiklik günlüğü

v3.2: Yeni bir sipariş sistemi: tek hata listesi, daha basit kademeli gönderim, daha net iptal ve yenileme

Aşağıdakilerin hepsi X-NotPanel-API-Version: 2026-10 başlığı altında birlikte yayımlanır. Önceki her işlem çalışmaya devam eder ve /api/v1, /api/v2 ve /api/v3 adresleri aynı şekilde davranır.

• Her siparişin panelde, destekte ve API'de geçerli tek bir numarası vardır. API siparişleri eski numaralarını korur.
• Kademeli gönderim: interval ile runs hâlâ çalışır. Yeni basit biçim toplam quantity ve drip_feed_total_minutes değerini alır, 48 saate kadar.
• İptal, ilk 15 saniye boyunca anında ve tam iadelidir. Sonrasında, hizmetin desteklediği yerlerde otomatik iadeyle iptal talebinde bulunabilirsiniz. order eskisi gibi tek bir nesne döndürür; orders bir dizi döndürür.
• Yenileme, sipariş başına 6 saatte bir, bitiş tarihi olmadan ve reddedildiğinde net bir nedenle çalışır.
• Telegram tepkileri tek bir reactions alanıdır; ya karışım (👍,❤️,🔥) ya da kesin sayılar (👍:60,❤️:40), ücretlendirilmeden önce denetlenir.
• Hizmet listesi etiketleri, sınırlarıyla ek alanları, kademeli gönderim sınırlarını ve kullanılabilirliği gösterir. cancel: true artık iptal taleplerinin gerçekten çalıştığı anlamına gelir.
• Her hatanın sabit bir kodu, bir HTTP durumu ve bir retryable bayrağı vardır. Önceki kodlar ve güncel kodlar aşağıda listelenmiştir.
• Bir siparişi request_id değerinizle de bulabilen yeni order_details.
• status iadeyi de içerir: iptal edilmiş veya kısmi bir siparişte refund iade edilen tutardır, bu yüzden ayrı bir çağrı gerekmez. refund_quote, status ile aynı yanıtı döndüren eski bir addır.
• Webhook'lar artık tek sistemdir: çağrı başına bir imzalı olay, sürümlü, iptal edilen ve kısmi siparişler ile yenileme sonuçları için yeni olaylarla.
• Kaldırıldı: toplu webhook gövdeleri, coupon parametresi ve status içindeki refund_pending alanları ile iki iade politikası alanı. Eski delay parametresi artık okunmuyor; drip_feed_total_minutes kullanın.
• Eklendi: status içinde can_cancel ve add yanıtında instant_cancel_until. Eski cancel_available ikisinde de kalır; cancel_window_seconds ve cancel_before ise add yanıtında kalır.
• Korundu: catalog ve account_status işlemleri eskisi gibi çalışmaya devam eder ve catalog artık Servisleri listeleme sayfasında belgelenir. Eski parametre adları hâlâ çalışır: referer, lpost_count, hashtag listeleri için hashtag, virgülle ayrılmış usernames ve eski tepki eşlemesi. webhook.add ayrıca order.refunded ve order.refill_completed olay adlarını da kabul eder.
• /api/v1, /api/v2 ve /api/v3 çalışmaya devam eder ve aynı şekilde davranır. Belgelenen /api/v3 adresidir.
• Tamamlanmış bir sipariş her zaman remains değerini 0 gösterir.

v3.1: Pazara doğal gelen servis adları

services ve catalog eylemleri artık on desteklenen dilde seçilmiş pazar terminolojisiyle yerelleştirilmiş servis adları için isteğe bağlı dil kodu kabul ediyor. Açık istekler kanonik ad ve gerçek dil meta verisi ekliyor; çeviri eksik veya eskiyse güvenle İngilizceye dönüyor. language olmadan eski İngilizce yanıt biçimi değişmiyor. Yöneticiler her adı inceleyebilir veya düzeltebilir.

v3.0: v3 varsayılan API oldu

/api/v3, tanıdık reseller sözleşmesi için kanonik endpoint ve doğrudan temel URL değişimi oldu. v3; isteğe bağlı kesin anahtarlar, 60 saniyelik eski istemci koruması, gelişmiş katalog, sayısal ID'ler, refund_quote, account_status, tekli veya sıralı toplu iptal ve imzalı webhook'lar ekler. API kapasitesi artık lifetime successful spend seviyesine ve hesabın tüm anahtarlarınca paylaşılan tek bir 60 saniyelik kayan pencereye dayanır. /api/v1 ve /api/v2 aynı güncel sözleşmenin tam takma adlarıdır.

v2.5: Gelişmiş katalog, iade mutabakatı ve iptal

Sayfalanmış catalog ve salt okunur refund_quote işlemleri eklendi; add ve status meta verileri genişletildi; API üzerinden verilen normal siparişler için 15 saniyelik iptal penceresi getirildi. API webhook olayları artık kararlı bir olay id'si taşır; deliveryId ise aynı partinin tekrar denemelerinde sabit kalır. Her yeniden deneme yeni bir zaman damgası ve imza alır. Webhook teslimatı, en az bir kez teslim için kalıcı bir garanti olmaksızın, tekrar denemelerle birlikte mümkün olduğunca yapılır.

v2.4: Katalogda 12 yeni medya platformu

Google, Rumble, Audiomack, Tumblr, Kwai, Clubhouse, Vimeo, Deezer, Tidal, Apple Music, Quora ve GitHub için hizmetler eklendi. Bunlar, diğer hizmetler gibi services eyleminde görünür ve her birinin kendine ait herkese açık bir platform sayfası vardır. İstemci tarafında değişiklik gerekmez — yeni hizmet ID'leri katalogda basitçe görünür.

v2.3: Add işleminde servis kullanılabilirliği uygulandı

Kullanılamayan servisler yeni siparişi sessizce kabul veya kuyruğa almak yerine action=add çağrısını reddeder. Yeniden denemeden önce kataloğu yenileyip kullanılabilir servis seçin.

v2.2: İsteğe bağlı sipariş parametreleri

add eylemi artık başlangıç gecikmesi ve tür bazlı etkileşim seçenekleri gibi desteklenen servis-türü özel alanlarını kabul eder. Servis türünce tanımlanmış alanlar belgelenmiş anlamını korur.

v2.1: Sipariş vermede kademeli gönderim parametreleri

add eylemi dripfeed=true servislerinde runs ve interval değerlerini birlikte kabul eder. Toplam teslimat quantity × runs olup servis üst sınırını aşamaz. Drip olmayan servisler ikisini de reddeder.