Mobil proxy IP döndürme API: bağlantı veya API çağrısıyla IP değiştirin

Döndürme bağlantısı nasıl çalışır?

Döndürme bağlantısı, port ID’nizi içeren basit bir URL’dir (şu şekilde görünür: mob_2v8k1q; müşteri alanında her port için hazır bağlantı gösterilir) ve içinde bir API anahtarı barındırır. Bu bağlantıyı bir tarayıcıda, yer imi veya betikte açmak, modemin operatör bağlantısını kesip yeniden bağlanmasını ister. Operatör genellikle farklı bir IP adresi atar.

Yalnızca yeni IP’yi düz metin olarak almak için &format=text ekleyin, bu shell betiklerinde kullanışlıdır. Bağlantıyı şifre gibi saklayın: elimde olan herkes portunuzu döndürebilir ve aynı anahtar API çağrısında port ayarlarını, alt kullanıcıları veya IP izin listesini değiştirebilir. Yalnızca döndürme bağlantıları için ayrı bir anahtar oluşturun, bağlantıyı paylaşılan dokümanlar ve sohbet önizlemelerinden uzak tutun, eğer sızarsa müşteri alanından anahtarı iptal edin.

# 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"

REST API ile nasıl döndürebilirim?

Betikler, anahtarın sunucu kayıtlarında veya tarayıcı geçmişinde görünmemesi için Authorization başlığında anahtarla POST kullanmalıdır. Yanıt yeni IP’yi ve bir sonraki döndürmenin ne zaman yapılabileceğini bildirir.

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

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

Çok sık döndürürsem ne olur?

Bir port, en fazla 30 saniyede bir manuel döndürme kabul eder. Daha erken yapılan çağrı HTTP 429 hatası ile rotation_too_soon ve beklenmesi gereken saniyeyi belirten Retry-After başlığı döner. Hiçbir şey bozulmaz: port mevcut IP’sini korur.

Mümkün olduğunca hızlı döndürme nadiren faydalıdır. Her yeniden bağlanmada port trafik taşımaz ve operatör aynı adresi verebilir. Döndürme stratejisi rehberi her görev için aralık önerir.

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"
  }
}

Zamanlayıcıyla otomatik döndürmeyi nasıl ayarlarım?

Portun döndürme modunu interval olarak ayarlayın ve 2 ile 1.440 dakika (her 2 dakikada bir ila her 24 saatte bir) arasında bir sayı seçin. Zamanlayıcı, siz çağrı yapmasanız da portu döndürür. Durdurmak için tekrar manual seçin. Zamanlayıcı müşteri alanından da ayarlanabilir.

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}}'

Python veya Node.js ile nasıl döndürürüm?

Her iki örnek de portu döndürür ve yeni IP’yi yazdırır; Python örneği ardından port üzerinden bir istek gönderir. Python rehberi ise denemeler ve döndürme yardımcısı ekler.

import requests

API = "https://cellmast.com/api/v1"
KEY = "API_KEY"
PORT_ID = "PORT_ID"
PROXY = "http://USERNAME:[email protected]: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)

// 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);
}

Bir portu başka bir operatöre, şehre veya ülkeye taşıyabilir miyim?

Destek ile iletişime geçin. Başka bir ülkeye mi ihtiyacınız var? Destek ile iletişime geçin: orada bir port stokta ise, kalan günlerinizi ona taşırız ve fiyat farkını bakiyenizden tahsil ederiz (faturalama dönemi başına bir taşıma). Aynı ülke içinde başka bir operatör veya şehir içinde de geçerlidir. Taşıma sonrası host, port ve şifre değişebilir: müşteri alanında tekrar kontrol edin.

Portumun hangi IP’leri kullandığını görebilir miyim?

Evet. GET /api/v1/mobile/{portId}/ip-history, porta atanmış adresleri ve kullanım saatlerini listeler. Döndürmelerin yeni adresler ürettiğini kontrol etmek, kendi kayıtlarınızla karşılaştırmak veya her adresin seçilen operatöre ait olduğunu teyit etmek için kullanabilirsiniz. GET /api/v1/mobile/{portId}/usage bilgilendirme için günlük trafiği gösterir; özel portlarda veri limiti yoktur.

Döner GB başına havuzu bu API’yi gerektirir mi?

Hayır. Dönen mobil havuz kendisi IP değiştirir: Her yeni bağlantı havuzdan genellikle farklı bir IP alır; her istekte yeni IP için bir istek bağlantı başına gönderin (keep-alive kapalı). Kullanıcı adı ile kontrol edilir, örneğin USERNAME-country-us-session-abc123-ttl-15 15 dakikalık yapışkan oturum içindir. Döndürme API’si, size ait bir modem olan ve IP değişimini kendiniz belirlediğiniz özel portlar içindir.