API Referansı

Proxynet API, organizasyonunuzun proxy hizmetlerini kendi sisteminizden okumanızı, yeni sipariş açmanızı ve mevcut hizmetleri yönetmenizi sağlar. Tüm istekler ve yanıtlar JSON'dur; kimlik bir Bearer token ile doğrulanır.

Temel adres

https://api.proxynet.io/api/v1

Sunucudan sunucuya tüm çağrılarda bu adresi kullanın. Panel adresi (app.proxynet.io) Cloudflare korumasındadır ve bazı sunucu IP'lerinden gelen isteklere tarayıcı doğrulaması uygulayabilir; api.proxynet.io yalnızca API'yi sunar ve doğrulama yapmaz. Token ve yollar ikisinde de aynıdır.

Kimlik doğrulama

Her isteğe Authorization başlığını ekleyin. Çerez kabul edilmez, token adres satırında gönderilemez.

curl -H "Authorization: Bearer pxn_live_…" \
  https://api.proxynet.io/api/v1/me

Token oluşturma ve yetkiler için Kimlik doğrulama ve Token'lar ve yetkiler sayfalarına bakın.

Yanıt biçimi

Başarılı yanıtlar veriyi data altında döner; listeler sayfalama bilgisini meta altında taşır.

{
  "data": [ … ],
  "meta": { "total": 6, "limit": 25, "offset": 0, "has_more": false }
}

Hatalar her uçta aynı zarfla döner; mesaj metnine göre değil code alanına göre dallanın. Kodların tamamı Hatalar sayfasında.

Uç noktalar

Uçlar bir siparişin yaşam döngüsü sırasıyla dizildi: önce katalogdan ne alabileceğinize bakın, sonra sipariş açın, açılan hizmetiürününün sayfalarından izleyin.

Organizasyon

• GET/meToken ve organizasyon bilgisi · Token'ın geçerliliğini, yetkilerini, bağlı olduğu organizasyonu, planı, bakiyeyi ve istek limitini döner.

Katalog ve fiyat

• GET/catalogKatalog · Satın alınabilecek her şeyi, planınıza göre fiyatlarıyla tek yanıtta döner.
• GET/locationsLokasyonlar · Seçilebilir lokasyonları ve anlık stoğu döner.
• GET/target-urlsHedef alan adları · Hedefli modda seçilebilecek alan adlarını döner.
• GET/stockStok kontrolü · Sipariş oluştururken yapılan stok kontrolünün aynısını çalıştırır.
• GET/pricingFiyat teklifi · Bir tip, adet ve ek seçenekler için kesilecek tutarı hesaplar.

Siparişler

• GET/ordersSipariş listesi · Organizasyonun proxy hizmetlerini listeler; beş tip bir arada gelir.
• POST/ordersSipariş oluştur · Panelden verilen siparişin aynısını açar ve bakiyenizden ücret keser.
• GET/orders/{id}Sipariş detayı · Tek hizmetin durumunu, kalan gününü ve kullanım sayaçlarını döner.

Ürün bazında uçlar

Yollar ürünler arasında aynıdır (/orders/…); ürün sayfaları gövdeyi ve örnekleri o ürünün alanlarına göre daraltır. Diğer ürünün aynı işlemine geçmek için sol menüyü kullanın.

IP başına ürünlerde lokasyon ve adet seçilir, hizmet 30 günlük dönemle yenilenir; GB başına ürünlerde tek bir gateway adresi vardır, ülke/şehir hedefleme Endpoint oluşturucu ile yapılır ve kullanım bakiyenizden GB başına düşer.