Özellikler ve kapsam
Aşağıdaki özellikler aynı ARNPROXY hesabına ve mevcut site işleyişine bağlıdır. Her işlem için gereken izin, uygun ürün ve doğrulama koşulları ilgili sayfada açıklanır.
Hesap ve bakiye
Hesap, para birimi, bakiye ve kullanılabilir izinleri okuyun. API anahtarı ilk uygun hesap ziyaretiyle otomatik hazırlanır; yönetici kısıtlamaları ve doğrulama koşulları korunur.
/capabilitiesHesap ve para birimiGET /accountSite bakiyesiGET /balanceSatın alma ve çok ülkeli sipariş
Tek product_id içinde en fazla 20 farklı location_id kullanılabilir. Her ülke ayrı sipariş kaydı olur; bağlı alışveriş tek faturada işlenir. Adet indirimi her ülkenin kendi adedine göre hesaplanır.
/productsÜlkeler, süreler ve kullanım amaçlarıGET /catalogSipariş fiyatı; kesinti yapmazPOST /quoteDiğer ilgili işlemler · 2
Kabul edildi, teslim edildi demek değildir
HTTP 201/202 veya state=accepted yalnız kabulü gösterebilir. purchase_status / residential_purchase_status ile aynı işlemi, order_delivery ile teslimatı takip edin. poll_after_seconds ve Retry-After varsa bunlara uyun. Zaman aşımından sonra yeni Idempotency-Key ile tekrar satın almayın.
/ordersSipariş özetiGET /orders/{id}Güncel teslimat/kuyruk durumuGET /orders/{id}/deliveryDiğer ilgili işlemler · 1
Aktif proxyler, notlar ve dışa aktarma
Yalnız kendi aktif proxylerinizi ve siparişe bağlı bağlantıları okuyun. Notları yönetin; uygun izinle bağlantı bilgilerini ve CSV/özel çıktıyı alın. Başka müşterilerin verileri gösterilmez.
/proxies/{id}/noteKendi proxynin notunu kaydet; boş metinle temizlePOST /proxies/noteAktif proxylerGET /proxiesDiğer ilgili işlemler · 3
Süre uzatma ve otomatik yenileme
Uzatılabilir proxyleri ve fiyatı öğrenin; bakiyeden uzatın. Otomatik yenileme API’si mevcut bakiye yöntemini yönetir; ayarı açmak o anda tahsilat yapmaz ve kartla yenileme ayarını değiştirmez.
/auto-renewalSeçili proxylerin bakiye yenileme ayarları ve uygun sürelerGET /auto-renewal/optionsBakiye otomatik yenilemesinin bugünkü fiyat tahminiPOST /auto-renewal/quoteDiğer ilgili işlemler · 7
IP değişim talepleri
Ücreti öğrenin, talep oluşturun ve durumunu takip edin. Talep mevcut yönetici incelemesine gider; her istekte otomatik/yeni IP verilmesi anlamına gelmez.
/replacements/quoteYönetim incelemesine değişim talebiPOST /replacements/createKaydedilmiş talep sonucuGET /replacements/statusDiğer ilgili işlemler · 1
Ana loginden bağımsız ek loginler
Ek login oluşturun, listeleyin, yenileyin ve silin; ana teslimat bilgisi korunur. Rastgele/özel seçim ve uzunluk kuralları options yanıtından alınır. Bazı işlemler paket/sipariş grubuna etki eder. Müşteri panelindeki Loginler sayfası görüntüleme ve silme içindir; oluşturma/yenileme API üzerinden yapılır.
/extra-logins/replace/optionsYeni ek login doğrulanınca eski ek logini kapatPOST /extra-logins/replaceAynı yenilemeyi yalnız sorgula; değişiklik göndermezGET /extra-logins/replace/statusDiğer ilgili işlemler · 9
- Yalnız gönderilmemiş yenileme adımına onaylı devam
- Ek login için kapsam ve seçenekler
- Ana logine dokunmadan ek login oluştur
- Ek login ve bağlı kendi proxyleri
- Yalnız seçilen ek logini kaldır
- Aynı ek login işlemini yalnız sorgula
- Yalnız gönderilmemiş adıma açık onay
- Yalnız API ek login kayıtları
- Ek login kontrol ve temizlik planı geçmişi
Proxy yetkili IP yönetimi
options/kapsam yanıtına göre desteklenen IP ekleme ve kaldırmayı kullanın. İşlem paket genelinde olabilir; kapsam/onay alanlarını atlamayın. API üzerinden kaldırma, hesabınızın kayıtlı API IP yetkileriyle sınırlıdır.
/proxies/{id}/accessDoğrulanmış kapsamda yetkili IP eklePOST /proxies/authorized-ips/addYalnız API ile eklediğiniz yetkili IP’yi kaldırPOST /proxies/authorized-ips/removeDiğer ilgili işlemler · 3
Residential: yeni paket ve GB ekleme farkı
Residential siparişlerinde müşteri kullanım amacı seçmez. Yeni pakette kullanım amacı, web sitesindeki siparişle aynı sabit değerle sunucuda otomatik atanır; purpose_id, subpurpose_id veya other_purpose göndermeniz gerekmez. GB ekleme mevcut paketin kullanım amacını korur.
/residential/catalogYeni paket / GB ekleme fiyatı; tahsilat yapmazPOST /residential/quoteSitedeki teslimat kuyruğuna bakiyeli Residential siparişiPOST /residential/orders/createDiğer ilgili işlemler · 1
Konumlar, IP havuzu ve bağlantı listeleri
Ülke/bölge/şehir/ISP seçeneklerini ve IP havuzu gözlemlerini okuyun. Liste oluşturun, adını/rotasyonunu değiştirin veya silin. Yeni listede desteklenen kullanıcı/şifre veya IP doğrulamasını seçin. Havuz sayıları önbellekli gözlem olabilir; her bağlantı için IP garantisi değildir.
/residential/locationsYalnız kendi kayıtlı loginlerinin saatlik trafik geçmişiGET /residential/trafficMevcut bağlantı listesini dışa aktar; yeni liste oluşturmazPOST /residential/exportDiğer ilgili işlemler · 13
- Sahip olunan paketler; kayıtlı gözlem
- Tek paket; kayıtlı gözlem
- Paketin bağlantı listeleri
- Tek bağlantı listesi
- Liste oluşturma/silme kapsamı ve sürümü
- Mevcut pakette bağlantı listesi oluştur; GB satın almaz
- Yalnız kendi bağlantı listesini sil; paketi silmez
- Liste işlemini GET ile doğrula; yeniden oluşturmaz/silmez
- Liste ayarlarını sağlayıcıdan kontrol et
- Paket gözlemini güncelle; GB satın almaz
- Bağlantı listesinin adını değiştir
- Bağlantı listesi rotasyonunu değiştir
- Aynı işlemi kontrol et; değişikliği yeniden göndermez
Oturum ve hedefleme
Önce uygun özel Residential listesini oluşturun ve doğrulayın; ardından session/TTL bağlantı metinleri hazırlayın. Bağlantı metni üretmek trafik harcamaz; gerçek kullanım trafik tüketir.
/residential/sessions/optionsAyrı bir oturum listesi oluştur; GB satın alma yokPOST /residential/sessions/createÖzel oturum listesinden hedefli bağlantı metni üretPOST /residential/sessions/exportDiğer ilgili işlemler · 1
Rotating proxyler
Uygun Rotating paketin IP değişim aralığını saniye olarak ayarlayın. Bu işlem anlık IP değiştirme düğmesi değildir; ayar paket kapsamına uygulanır.
/rotating/{id}/optionsRotating paketin IP değişim süresini değiştirPOST /rotating/rotationRotating işlemini yalnız okuyarak doğrula; yazmayı tekrarlamazGET /rotating/statusİki farklı IP izin listesi
Hesabım → API bölümündeki izin listesi, API anahtarını hangi adreslerin kullanabileceğini belirler; bu ayar hesap sayfasından yönetilir. Proxy yetkili IP işlemleri ise proxyye hangi adreslerin bağlanabileceğini belirler. Bu iki ayar birbirini değiştirmez.
Webhook ve hazır istemciler
Webhook isteğe bağlıdır; kullanmak zorunlu değildir. Kendi HTTPS alıcınızı kurup imzayı doğrulayabilir veya sonuçları durum sorgularıyla takip edebilirsiniz. PHP, Python, Node.js, Java ve Go SDK’ları ile Postman dosyaları hazırdır.
Sunulmayan işlemler ve önemli sınırlar
Kart/banka ile bakiye yükleme API’si yoktur; bakiye siteden yüklenir. Ana teslimat logini müşteri API’sinden değiştirilmez veya silinmez. IP değişimi mevcut yönetici değerlendirme sürecine bağlıdır. Residential bağlantı listesini silmek GB paketini silmez.
İzinler yöneticinin hesap ayarlarından gelir; müşteri ayrıca izin seçmez. Mevcut yönetici kısıtlamaları geçerlidir.