API untuk developer

Anda dapat membeli dan mengelola proxy dari kode Anda sendiri: membuat pesanan, membaca paket, memperpanjang, memantau peristiwa. Semua yang Anda beli menjadi paket. Ada dua jenis paket, dibedakan oleh field family:

	Residential	IPv4
family	traffic_gateway	dedicated
Yang Anda beli	volume trafik dalam gigabyte	N alamat khusus untuk suatu periode
Cara membayar	per gigabyte, trafik tidak hangus	per alamat per periode: seminggu, 2 minggu, sebulan, 2 atau 3 bulan
Koneksi	Anda membuat baris sebanyak apa pun dengan geo apa pun	daftar alamat tetap dengan satu login dan kata sandi
Ganti IP	rotasi atau tautan ganti IP	penggantian semua alamat paket sekali setiap 30 hari
Produk	Residential	IPv4

Pembelian, daftar paket, dan kartu paket adalah rute bersama untuk kedua jenis. Operasi yang hanya ada pada satu jenis dijelaskan terpisah: trafik dan alamat tetap.

Alamat dasar dan autentikasi

https://ipv.rent

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

Pendaftaran - di app.ipv.rent, setelah itu konfirmasi email Anda: tanpa konfirmasi, Anda tidak bisa masuk.

Kunci dibuat di panel: Profil → Kunci API → Buat kunci. Secret ditampilkan satu kali, kunci aktif per akun - hingga 20.

Kunci yang dicabut langsung tidak diterima lagi, dan peristiwa api_key.revoked masuk ke log.

401 invalid_api_key - kunci tidak diterima. 403 insufficient_scope - kunci tidak memiliki izin yang dibutuhkan rute.

Skema permintaan dan respons dengan semua field dan contohnya - di referensi OpenAPI.

Izin kunci

Kunci yang dibuat tanpa menyebutkan izin mendapat semuanya. Kumpulan izin pada kunci yang sudah dibuat tidak dapat diubah.

Izin	Yang dibuka
catalog:read	produk dan parameternya, katalog geo, perhitungan harga
packages:read	daftar paket, kartu paket, opsi perpanjangan
packages:write	pembelian dan semua operasi paket: penambahan volume, koneksi, kata sandi, perpanjangan, penggantian alamat, sidik jari, perpanjangan otomatis
orders:read	pesanan
orders:write	dicadangkan - saat ini tidak ada rute yang memerlukannya
billing:read	saldo dan transaksi
events:read	log peristiwa

Rute

Katalog dan pembelian - untuk kedua jenis:

Rute	Izin	Idempotency-Key
GET /api/v1/products	catalog:read	-
GET /api/v1/products/{product}/options	catalog:read	-
POST /api/v1/quote	catalog:read	tidak
POST /api/v1/packages	packages:write	wajib
GET /api/v1/packages	packages:read	-
GET /api/v1/packages/{id}	packages:read	-
POST /api/v1/packages/{id}/password	packages:write	tidak

Hanya Residential:

Rute	Izin	Idempotency-Key
GET /api/v1/geo/countries, /states, /cities, /asns	catalog:read	-
POST /api/v1/packages/{id}/proxies	packages:write	tidak
POST /api/v1/packages/{id}/topup	packages:write	wajib
POST /api/v1/packages/{id}/rotation-secret	packages:write	tidak

Hanya IPv4:

Rute	Izin	Idempotency-Key
GET /api/v1/packages/{id}/prolong-options	packages:read	-
POST /api/v1/packages/{id}/prolong	packages:write	wajib
POST /api/v1/packages/{id}/replace	packages:write	tidak
POST /api/v1/packages/{id}/fingerprint	packages:write	tidak
POST /api/v1/packages/{id}/renewal	packages:write	tidak

Akun:

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

Operasi untuk jenis lain pada sebuah paket dijawab 422 unsupported_capability.

Pengisian saldo dan pengelolaan kunci - hanya di panel.

Batas permintaan

120 permintaan per menit per kunci, ditambah 30 per menit untuk permintaan yang mengubah sesuatu (POST). Setiap respons membawa RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset; jika batas terlampaui - 429 dengan retry_after dan Retry-After: tunggu sejumlah detik yang disebutkan, lalu ulangi.

Dukungan

Telegram: @ipvrent_support, email [email protected]. Lampirkan request_id dari body penolakan.

Berita dan status layanan - di kanal t.me/ipvrent.