v3 API'sinde kırıcı ve dikkate değer değişiklikler. Şunu izleriz: semver — ekleyici değişiklikler (yeni isteğe bağlı parametreler, yeni eylemler, yanıtlarda yeni alanlar) bir ana sürüm içinde yayınlanır; kırıcı değişiklikler yeni bir ana sürüme gider.
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.
/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.
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 ve ilk oluşturulmasından 7 gün sonra hâlâ çözümlenmemiş normal bir sipariş için tam iade 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.
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.
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.
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.
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.
Form-encoded v2 işlem API’si; hız kontrolleri, yeniden denemeli imzalı best-effort webhook’lar ve idempotent sipariş oluşturma ile kullanıma sunuldu. Güncel v1 ve v2 URL’leri v3 sözleşmesinin diğer adlarıdır ve belgelenen paylaşılan hesap limitini kullanır.