# モバイルプロキシIP回転API：リンクまたはAPIでIP変更

> リンクまたはAPI呼び出しで4G/5GモバイルプロキシのIPを変更：エンドポイント、curl/Python/Nodeコード、429制限。CellMast、KYC不要、暗号対応。

- URL: https://cellmast.com/ja/ip-rotation-api/
- 最終更新日: 2026-10-13
- Publisher: CellMast (https://cellmast.com)

すべてのCellMast専用ポートにはブラウザで開く回転リンク、スクリプト用RESTエンドポイント、手間いらず回転用タイマーが付属。このページに制限やレスポンスと共に掲載。

*回転後に新しいIPを確認*

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

**クイックアンサー — モバイルプロキシのIPをリンク、API、タイマーでどう変える？**

**CellMast**なら、ポート専用の回転リンクか`https://cellmast.com/api/v1/mobile/{port}/rotate?key=API_KEY`を開くか、同エンドポイントにPOSTとBearerキーで呼び出し。モデムがキャリアに再接続し新IPを取得。ローテーションごとにポートはキャリア接続を再確立し、通常5～15秒かかる。キャリアが同じIPを返すこともあるため、その場合は再度ローテーション要。。回転は専用4G/5Gポートすべてに含まれ、1日あたり2.63ドルからKYC不要、暗号支払い対応。

## 回転の概要

| 属性 | 値 |
| --- | --- |
| ローテーションリンク | `GET https://cellmast.com/api/v1/mobile/{port}/rotate?key=API_KEY` |
| スクリプト呼び出し | `POST /api/v1/mobile/{portId}/rotate`と`Authorization: Bearer API_KEY` |
| タイマー | `PATCH /api/v1/mobile/{portId}` を使った`rotation.mode = interval`、2分ごとから24時間ごとまで設定可能 |
| 回転で何が起きるのか | ローテーションごとにポートはキャリア接続を再確立し、通常5～15秒かかる。キャリアが同じIPを返すこともあるため、その場合は再度ローテーション要。 |
| 最小間隔 | 同じポートの手動回転は30秒間隔。早すぎる呼び出しは HTTP 429 と `Retry-After` を返す |
| レスポンス | 新しいIP、前のIP、回転時間、次に許可される回転時間 |
| 同じIPに戻ることは？ | 可能です：キャリアが自身のプールからアドレスを選びます |
| コスト | 専用ポートごとに含まれており、回転ごとの追加料金はありません |
| キーの範囲 | `proxies` スコープ付きのAPIキー |

## 回転リンクはどう機能する？

回転リンクはポートID入りのシンプルなURL（`mob_2v8k1q` のように見えます。クライアントエリアで各ポートの用意されたリンクを確認できます）とAPIキーが含まれています。それをブラウザやブックマーク、スクリプトで開くとモデムにキャリア接続を切断し再接続するよう指示します。キャリアは通常別のIPアドレスを割り当てます。

`&format=text` を追加すると新しいIPだけをプレーンテキストで取得可能です。これはシェルスクリプトで便利です。リンクはパスワードのように扱ってください：持つ人は誰でもポートを回転でき、同じキーはAPI呼び出しでポート設定、サブユーザー、IP許可リストも変更可能です。回転リンク専用のキーを作成し、共有ドキュメントやチャットのプレビューにリンクを出さず、流出したらクライアントエリアでキーを取り消してください。

*リンクで回転（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"
```

## REST APIでスクリプトから回転するには？

スクリプトはPOSTを使い、キーを`Authorization`ヘッダーに入れることでサーバーログやブラウザ履歴にキーが残らないようにします。レスポンスは新しいIPと次の回転可能時刻を教えます。

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

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

*レスポンス例 (200)*

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

例のアドレスと時間は説明用です。`previousIp` でキャリアが本当に新しいアドレスを割り当てたか確認できます。

## 回転を頻繁に行うとどうなる？

ポートは手動回転を30秒に1回まで受け付けます。それより早い呼び出しは HTTP **429** とエラー `rotation_too_soon`、そして待ち秒数を示す `Retry-After` ヘッダーを返します。問題は起きません：ポートは現在のIPを維持します。

できるだけ早く回転してもあまり意味がありません。再接続中はポートでトラフィックを扱えず、キャリアは同じアドレスを再割り当てすることがあります。[回転戦略ガイド](https://cellmast.com/ja/guides/mobile-ip-rotation-strategy/) にタスク別の間隔推奨があります。

*レスポンス例 (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"
  }
}
```

## タイマーで自動回転を設定するには？

ポートの回転モードを`interval`に設定し、2分から1440分（24時間）の間の分数を選びます。設定するとあなたが呼び出さなくてもタイマーがポートを回転します。止めるには`manual`に戻します。クライアントエリアからも設定可能です。

*10分ごとに回転*

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

## PythonやNode.jsで回転するには？

両方の例はポートを回転し、新IPを表示します。Python例はその後ポート経由のリクエストも送信します。[Pythonガイド](https://cellmast.com/ja/guides/python-mobile-proxy/) はリトライや回転補助も追加しています。

*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+ (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);
}
```

## ポートを別のキャリアや都市、国に移動できますか？

サポートに問い合わせてください。他の国が必要ですか？サポートにお問い合わせください：その国にポートが在庫があれば、残りの日数を移行し、差額は残高で精算します（請求期間につき1回の移行可能）。同じ国内の別キャリアや同一キャリアの別都市も同様です。移動後はホスト、ポート、パスワードが変わることがあるのでクライアントエリアで再確認してください。

## 自分のポートが使ったIPを見られますか？

見られます。`GET /api/v1/mobile/{portId}/ip-history` は割り当てられたIPと時間を一覧表示します。回転が新しいアドレスを生んでいるか、自分のログと照合したいとき、あるいはIPが指定したキャリアに属するか確認に便利です。`GET /api/v1/mobile/{portId}/usage` は日別トラフィックを表示します。専用ポートのデータは無制限です。

## 回転するGBプールはこのAPIを使う必要がありますか？

いいえ。[回転モバイルプール](https://cellmast.com/ja/mobile-proxies/rotating/) は独自にIPを変えます：接続ごとにプールからIPを割り当て、通常は異なるIP。リクエストごとに新IP取得したい場合は1接続1リクエスト（keep-aliveオフ）推奨。。ユーザー名で制御します。例：15分のスティッキーセッションは`USERNAME-country-us-session-abc123-ttl-15`。回転APIは専用ポート用で、モデムがあなたのものでIP変更のタイミングを決められます。

## 回転：よくある質問

### モバイルプロキシのIP変更にどれくらいかかる？

CellMast 専用ポートでは通常5～15秒です：モデムがキャリアから切断して再接続しキャリアがアドレスを割り当てます。その間ポートはトラフィックを扱わないのでAPIから新IPのレスポンスが来るまでリクエストを止めてください。

### 回転回数に制限はありますか？

回転は追加料金なしです。APIは1つの制限を設けています：ポートごとに手動回転は30秒に1回までです。タイマーは2分から24時間まで設定可能です。

### なぜ回転後に同じIPが割り当てられたのですか？

キャリアがアドレスを選んでいるためです。キャリアはCGNATを通じて多くの加入者とパブリックIPv4アドレスを共有しており、再接続で同じIPになることがあります。異なるアドレスが必要な場合は、レスポンスの`previousIp`を確認し、30秒後に再度回転してください。[CGNATガイド](https://cellmast.com/ja/guides/cgnat-mobile-ips/)をご覧ください。

### 回転リンクは安全に共有できますか？

ポートを操作できる可能性のある人とだけ共有してください。リンクにはAPIキーが含まれており、それを持つ人は誰でもポートを回転させることができ、APIコールで同じキーを使うとポート設定、サブユーザー、IP許可リストを変更できます。回転リンク用には別のキーを使い、スクリプトではヘッダー内にキーを含むPOSTエンドポイントを推奨し、リンクが漏れた場合はクライアントエリアでキーを無効化してください。

### 次のIPを選べるか、同じIPを永続的に使えますか？

いいえ。キャリアがアドレスを割り当てているため、誰も次のIPを自由に選べませんし、キャリアは独自にアドレスを変更することがあります。同じアドレスを長期間使いたい場合は回転を手動にし、再接続を避けてください。許可リスト用の固定IPが必要ならば、モバイルプロキシは適していません。

**すべてのポートに回転機能が含まれています** 専用の4G/5Gポートを1日あたり2.63ドルから提供、無制限データ、リンク・API・タイマーによる回転対応。暗号通貨で支払い可能。 [ポート価格を見る](https://cellmast.com/ja/pricing/) · [モバイルAPIリファレンス](https://cellmast.com/docs/api/mobile/)

---

CellMast: CellMastは4G/5Gのレジデンシャルプロキシプロバイダーです：専用キャリアモデム（トラフィック無制限）と、回転式のGB単位モバイルプールを提供。KYC不要で暗号通貨決済対応。