Geliştiriciler için API

Proxyleri kendi kodunuzdan satın alabilir ve yönetebilirsiniz: sipariş verebilir, paketleri okuyabilir, uzatabilir, olayları takip edebilirsiniz. Satın aldığınız her şey bir paket olur. Paketler iki türdür ve family alanıyla ayrılır:

	Residential	IPv4
family	traffic_gateway	dedicated
Ne satın alırsınız	gigabayt cinsinden trafik hacmi	süreli N adet özel adres
Neye ödersiniz	gigabayta, trafiğin süresi dolmaz	dönem başına adres başına: 1 hafta, 2 hafta, 1 ay, 2 veya 3 ay
Bağlantılar	herhangi bir coğrafya ile istediğiniz kadar satır oluşturursunuz	tek kullanıcı adı ve parolayla sabit adres listesi
IP değiştirme	rotasyon veya IP değiştirme bağlantısı	paketin tüm adreslerinin 30 günde bir değiştirilmesi
Ürün	Residential	IPv4

Satın alma, paket listesi ve paket kartı her iki tür için ortak rotalardır. Yalnızca bir türde bulunan işlemler ayrıca anlatılır: trafik ve sabit adresler.

Temel adres ve kimlik doğrulama

https://ipv.rent

curl https://ipv.rent/api/v1/balance \
  -H 'Authorization: Bearer YOUR_API_KEY'

Kayıt app.ipv.rent adresinde yapılır; ardından e-postanızı onaylayın: onay olmadan giriş açılmaz.

Anahtar panelde oluşturulur: Profil → API anahtarları → Anahtar oluştur. Gizli değer bir kez gösterilir; bir hesapta en fazla 20 etkin anahtar olabilir.

İptal edilen anahtar anında kabul edilmez olur ve günlüğe api_key.revoked olayı düşer.

401 invalid_api_key - anahtar kabul edilmedi. 403 insufficient_scope - anahtarda rotanın gerektirdiği yetki yok.

Tüm alanları ve örnekleriyle istek ve yanıt şemaları: OpenAPI başvurusu.

Anahtar yetkileri

Yetki belirtilmeden oluşturulan anahtar tüm yetkileri alır. Oluşturulmuş bir anahtarın yetki kümesi değiştirilemez.

Yetki	Neyi açar
catalog:read	ürünler ve parametreleri, geo kataloğu, fiyat hesaplama
packages:read	paket listesi, paket kartı, uzatma seçenekleri
packages:write	satın alma ve paketlerle ilgili tüm işlemler: hacim ekleme, bağlantılar, parola, uzatma, adres değişimi, parmak izi, otomatik yenileme
orders:read	siparişler
orders:write	ayrılmış - bugün hiçbir rota bunu gerektirmiyor
billing:read	bakiye ve işlemler
events:read	olay günlüğü

Rotalar

Katalog ve satın alma - her iki tür için:

Rota	Yetki	Idempotency-Key
GET /api/v1/products	catalog:read	-
GET /api/v1/products/{product}/options	catalog:read	-
POST /api/v1/quote	catalog:read	hayır
POST /api/v1/packages	packages:write	zorunlu
GET /api/v1/packages	packages:read	-
GET /api/v1/packages/{id}	packages:read	-
POST /api/v1/packages/{id}/password	packages:write	hayır

Yalnızca Residential:

Rota	Yetki	Idempotency-Key
GET /api/v1/geo/countries, /states, /cities, /asns	catalog:read	-
POST /api/v1/packages/{id}/proxies	packages:write	hayır
POST /api/v1/packages/{id}/topup	packages:write	zorunlu
POST /api/v1/packages/{id}/rotation-secret	packages:write	hayır

Yalnızca IPv4:

Rota	Yetki	Idempotency-Key
GET /api/v1/packages/{id}/prolong-options	packages:read	-
POST /api/v1/packages/{id}/prolong	packages:write	zorunlu
POST /api/v1/packages/{id}/replace	packages:write	hayır
POST /api/v1/packages/{id}/fingerprint	packages:write	hayır
POST /api/v1/packages/{id}/renewal	packages:write	hayır

Hesap:

Rota	Yetki	Idempotency-Key
GET /api/v1/orders, /orders/{id}	orders:read	-
GET /api/v1/balance, /transactions	billing:read	-
GET /api/v1/events	events:read	-

Bir pakette diğer türe ait işlem 422 unsupported_capability ile yanıtlanır.

Bakiye yükleme ve anahtar yönetimi yalnızca paneldedir.

Limitler

Anahtar başına dakikada 120 istek, ayrıca bir şeyi değiştiren istekler (POST) için dakikada 30. Her yanıtta RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset bulunur; aşım - retry_after ve Retry-After ile 429: belirtilen saniye kadar bekleyin ve tekrarlayın.

Destek

Telegram: @ipvrent_support, e-posta [email protected]. Ret gövdesindeki request_id değerini ekleyin.

Haberler ve hizmet durumu: t.me/ipvrent kanalı.