# API rotasi IP proxy seluler: ganti IP lewat link atau panggilan API

> Ganti IP proxy seluler 4G/5G lewat link atau panggilan API: endpoint, kode curl/Python/Node, batas 429. CellMast, tanpa KYC, pembayaran crypto.

- URL: https://cellmast.com/id/ip-rotation-api/
- Terakhir diperbarui: 2026-10-13
- Publisher: CellMast (https://cellmast.com)

Setiap port khusus CellMast dilengkapi link rotasi yang bisa dibuka di browser, endpoint REST untuk skrip, dan timer untuk rotasi otomatis. Halaman ini menampilkan ketiganya, beserta batasan dan responsnya.

*Putar ulang, lalu cek IP baru*

```
# 1. change the IP of your port
$ curl "https://cellmast.com/api/v1/mobile/{port}/rotate?key=API_KEY&format=text"
# 2. send a request through the port
$ curl -x http://USERNAME:PASSWORD@gw.cellmast.com:7777 https://api.ipify.org
```

**Jawaban cepat — Bagaimana cara ganti IP proxy seluler lewat link, API, atau timer?**

Dengan **CellMast**, buka link rotasi port Anda, `https://cellmast.com/api/v1/mobile/{port}/rotate?key=API_KEY`, atau panggil endpoint yang sama dengan POST dan kunci Bearer. Modem akan reconnect ke operator dan dapat IP baru. Setiap rotasi menyambungkan ulang port ke operator dan biasanya butuh 5–15 detik; operator kadang memberi IP yang sama: cukup rotasi lagi. Rotasi tersedia di semua port khusus 4G/5G, mulai dari $2.63/hari, tanpa KYC dan bayar pakai crypto.

## Rotasi sekilas

| Atribut | Nilai |
| --- | --- |
| Rotation link | `GET https://cellmast.com/api/v1/mobile/{port}/rotate?key=API_KEY` |
| Panggilan skrip | `POST /api/v1/mobile/{portId}/rotate` dengan `Authorization: Bearer API_KEY` |
| Timer | `PATCH /api/v1/mobile/{portId}` dengan `rotation.mode = interval`, dari setiap 2 menit hingga setiap 24 jam |
| Apa fungsi rotasi | Setiap rotasi menyambungkan ulang port ke operator dan biasanya butuh 5–15 detik; operator kadang memberi IP yang sama: cukup rotasi lagi |
| Jeda minimum | 30 detik antara dua rotasi manual pada satu port; panggilan lebih awal akan menerima HTTP 429 dengan `Retry-After` |
| Respon | IP baru, IP sebelumnya, waktu rotasi, rotasi berikutnya yang diperbolehkan |
| Kembali ke IP yang sama? | Mungkin: operator memilih alamat dari pool-nya |
| Biaya | Termasuk di setiap port khusus; tanpa biaya per rotasi |
| Ruang lingkup kunci | Kunci API dengan ruang lingkup `proxies` |

## Bagaimana cara kerja tautan rotasi?

Tautan rotasi adalah URL biasa dengan ID port Anda (terlihat seperti `mob_2v8k1q`; area klien menampilkan tautan siap pakai untuk setiap port) dan kunci API di dalamnya. Membukanya di browser, bookmark, atau skrip akan meminta modem untuk memutus sambungan operator dan menghubungkan kembali. Operator kemudian menetapkan alamat IP, biasanya yang berbeda.

Tambahkan `&format=text` untuk hanya mendapatkan IP baru dalam teks biasa, yang berguna dalam skrip shell. Perlakukan tautan seperti kata sandi: siapa saja yang memilikinya bisa merotasi port Anda, dan kunci yang sama yang dikirim dalam panggilan API juga bisa mengubah pengaturan port Anda, sub-user, atau daftar izinkan IP. Buat kunci terpisah hanya untuk tautan rotasi, simpan tautan agar tidak tersebar di dokumen bersama atau pratinjau chat, dan cabut kunci di area klien jika bocor.

*Rotasi dengan tautan (curl)*

```bash
# Replace {port} with your port ID (e.g. mob_2v8k1q, not 7777) and API_KEY with your key
curl "https://cellmast.com/api/v1/mobile/{port}/rotate?key=API_KEY"

# Plain-text answer: just the new IP
curl "https://cellmast.com/api/v1/mobile/{port}/rotate?key=API_KEY&format=text"
```

## Bagaimana saya merotasi dari skrip dengan REST API?

Skrip harus menggunakan POST dengan kunci di header `Authorization`, agar kunci tidak tercatat di log server atau riwayat browser. Respon akan memberitahu IP baru dan kapan rotasi berikutnya diperbolehkan.

*POST /api/v1/mobile/{portId}/rotate*

```bash
curl -X POST "https://cellmast.com/api/v1/mobile/PORT_ID/rotate" \
  -H "Authorization: Bearer API_KEY"
```

*Contoh respon (200)*

```json
{
  "ip": "203.0.113.24",
  "previousIp": "198.51.100.7",
  "rotatedAt": "2026-10-13T09:41:07Z",
  "nextRotationAvailableAt": "2026-10-13T09:41:37Z"
}
```

Alamat dan waktu dalam contoh ini hanya ilustratif. `previousIp` memungkinkan kode Anda memeriksa apakah operator benar-benar memberikan alamat baru.

## Apa yang terjadi jika saya sering melakukan rotasi?

Satu port hanya menerima satu rotasi manual setiap 30 detik. Panggilan sebelum waktu tersebut akan mengembalikan HTTP **429** dengan kesalahan `rotation_too_soon` dan header `Retry-After` yang menunjukkan detik menunggu. Tidak ada yang rusak: port tetap mempertahankan IP saat ini.

Rotasi sesering mungkin jarang berguna. Saat setiap sambungan ulang, port tidak mengangkut trafik, dan operator bisa memberikan IP yang sama kembali. [Panduan strategi rotasi](https://cellmast.com/id/guides/mobile-ip-rotation-strategy/) menyarankan interval berdasarkan tugas.

*Contoh respon (429)*

```http
HTTP/1.1 429 Too Many Requests
Retry-After: 22
Content-Type: application/json

{
  "error": {
    "code": "rotation_too_soon",
    "message": "Next rotation available in 22 seconds",
    "details": { "retryAfter": 22 },
    "requestId": "req_2b7c11"
  }
}
```

## Bagaimana saya mengatur rotasi otomatis dengan timer?

Setel mode rotasi port ke `interval` dan pilih jumlah menit dari 2 sampai 1.440 (setiap 2 menit hingga 24 jam). Timer akan merotasi port tanpa Anda harus memanggilnya. Beralih kembali ke `manual` untuk menghentikan. Anda juga dapat mengatur timer dari area klien.

*Rotasi setiap 10 menit*

```bash
curl -X PATCH "https://cellmast.com/api/v1/mobile/PORT_ID" \
  -H "Authorization: Bearer API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"rotation": {"mode": "interval", "intervalMinutes": 10}}'

# back to manual rotation
curl -X PATCH "https://cellmast.com/api/v1/mobile/PORT_ID" \
  -H "Authorization: Bearer API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"rotation": {"mode": "manual", "intervalMinutes": null}}'
```

## Bagaimana saya merotasi di Python atau Node.js?

Kedua contoh merotasi port dan menampilkan IP baru; contoh Python kemudian mengirim permintaan melalui port. [Panduan Python](https://cellmast.com/id/guides/python-mobile-proxy/) menambahkan retry dan helper rotasi.

*Python (requests)*

```python
import requests

API = "https://cellmast.com/api/v1"
KEY = "API_KEY"
PORT_ID = "PORT_ID"
PROXY = "http://USERNAME:PASSWORD@gw.cellmast.com:7777"

r = requests.post(f"{API}/mobile/{PORT_ID}/rotate",
                  headers={"Authorization": f"Bearer {KEY}"}, timeout=60)
if r.status_code == 429:
    print("too soon, retry after", r.headers.get("Retry-After"), "s")
else:
    r.raise_for_status()
    print("new IP:", r.json()["ip"])

print(requests.get("https://api.ipify.org",
                   proxies={"http": PROXY, "https": PROXY}, timeout=30).text)
```

*Node.js 18+ (simpan sebagai rotate.mjs)*

```javascript
// save as rotate.mjs (ES module), then: node rotate.mjs
const API = "https://cellmast.com/api/v1";
const res = await fetch(`${API}/mobile/PORT_ID/rotate`, {
  method: "POST",
  headers: { Authorization: "Bearer API_KEY" },
  signal: AbortSignal.timeout(60000),
});
if (res.status === 429) {
  console.log("retry after", res.headers.get("retry-after"), "s");
} else if (!res.ok) {
  throw new Error(`HTTP ${res.status}`);
} else {
  const { ip, previousIp } = await res.json();
  console.log(previousIp, "->", ip);
}
```

## Bisakah saya memindahkan port ke operator, kota, atau negara lain?

Tanyakan ke support. Butuh negara lain? Tanyakan ke dukungan: jika port tersedia di sana, kami memindahkan sisa hari Anda ke port tersebut dan menyelesaikan selisih harga melalui saldo Anda (satu kali pemindahan per periode tagihan). Hal ini juga berlaku untuk operator atau kota lain di negara yang sama. Setelah pindah, host, port, dan password bisa berubah: baca ulang di area klien.

## Bisakah saya melihat IP yang pernah digunakan port saya?

Ya. `GET /api/v1/mobile/{portId}/ip-history` menampilkan alamat yang diberikan ke port beserta waktunya. Gunakan untuk memastikan rotasi menghasilkan alamat baru, mencocokkan dengan log Anda sendiri, atau memastikan setiap alamat milik operator yang Anda pilih. `GET /api/v1/mobile/{portId}/usage` menunjukkan trafik harian untuk informasi; data pada port khusus tidak terbatas.

## Apakah pool per-GB yang berotasi butuh API ini?

Tidak. [pool seluler 4G berotasi](https://cellmast.com/id/mobile-proxies/rotating/) mengubah IP secara otomatis: Setiap koneksi baru dapat IP dari pool, biasanya berbeda; untuk dapat IP baru tiap request, kirim satu request per koneksi (matikan keep-alive). Anda mengendalikannya dengan username, misalnya `USERNAME-country-us-session-abc123-ttl-15` untuk sesi sticky 15 menit. API rotasi untuk port khusus, di mana satu modem milik Anda dan Anda menentukan kapan IP-nya berganti.

## Pertanyaan tentang rotasi

### Berapa lama waktu perubahan IP di proxy seluler?

Pada port khusus CellMast biasanya 5–15 detik: modem putus sambungan dari operator dan menghubungkan kembali, lalu operator menetapkan alamat. Selama waktu itu port tidak mengangkut trafik, jadi jeda permintaan Anda sampai API mengembalikan IP baru.

### Apakah ada batas rotasi?

Rotasi tidak dikenakan biaya tambahan. API menetapkan satu batas: maksimal satu rotasi manual setiap 30 detik per port. Timer dapat diatur dari setiap 2 menit hingga setiap 24 jam.

### Mengapa saya mendapatkan IP yang sama setelah rotasi?

Karena operator memilih alamatnya. Operator berbagi alamat IPv4 publik di antara banyak pelanggan melalui CGNAT, dan reconnect bisa mendapatkan alamat yang sama. Periksa `previousIp` dalam respons dan lakukan rotasi lagi setelah 30 detik jika Anda memerlukan alamat yang berbeda. Lihat panduan [CGNAT](https://cellmast.com/id/guides/cgnat-mobile-ips/).

### Apakah tautan rotasi aman untuk dibagikan?

Hanya dengan orang yang mungkin mengendalikan port. Tautan tersebut berisi API key: siapa pun yang memilikinya dapat merotasi port Anda, dan API key yang sama dalam panggilan API juga dapat mengubah pengaturan port, sub-pengguna, atau daftar IP yang diizinkan. Gunakan API key terpisah untuk tautan rotasi, pilih endpoint POST dengan key di header dalam skrip, dan cabut key di area klien jika tautan bocor.

### Bisakah saya memilih IP berikutnya atau mempertahankan IP selamanya?

Tidak. Operator yang menetapkan alamat, jadi tidak ada yang bisa memilih alamat berikutnya, dan operator dapat mengubah alamat secara sendiri. Jika Anda membutuhkan alamat yang sama dalam waktu lama, atur rotasi ke manual dan hindari reconnect; jika Anda membutuhkan IP tetap untuk daftar yang diizinkan, proxy seluler 4G bukanlah produk yang tepat.

**Rotasi termasuk pada setiap port** Port 4G/5G khusus dari $2.63/hari, data tanpa batas, rotasi melalui tautan, API atau timer. Bayar dengan crypto. [Lihat harga port](https://cellmast.com/id/pricing/) · [Referensi API seluler](https://cellmast.com/docs/api/mobile/)

---

CellMast: CellMast adalah penyedia proxy seluler 4G/5G: modem operator khusus dengan lalu lintas tanpa batas, plus pool proxy seluler rotasi per-GB, dibayar dengan crypto tanpa upload ID.