Proxy-seller

プロキシを用いた操作

Updated:

プロキシ注文内のIPアドレスを管理してください — リスト化、ローテーション、有効期間の延長、または注釈の追加を行ってください。

共通パラメータ。このページにあるすべてのエンドポイントは、特定の順序で動作します。orderNumber を渡してください。これはGET /proxy/list.

GEThttps://proxy-seller.com/personal/api/v2/{apiKey}/proxy/list
タイプ別にグループ化されたアクティブなプロキシを返します。
GEThttps://proxy-seller.com/personal/api/v2/{apiKey}/proxy/list/{type}
1つのタイプのアクティブなプロキシを返します。/proxy/list と同じクエリパラメータをサポートしています。

パスパラメータ

名前

価値

必須

説明

種類

ipv4,ipv6,mobile,isp,mix,mix_isp、またはresident

はい

ダウンロードするリストに含めるプロキシの種類を指定します。


承認

<Your_API_Key>

はい

ご自身のAPIキー（入手方法)

クエリパラメータ

名前

種類

必須

説明

最新

文字列

いいえ

Y最新のアクティブな注文からプロキシを返す場合、orderId は提供されていません。

orderId

文字列

いいえ

特定の orderId または OrderPart.number からプロキシを返す

国

文字列

いいえ

Alpha3の国名（FRAまたはDEUなど…）

終わり

文字列

いいえ

Y のみを返すENDED まだ残っているプロキシdateEnd 将来的に。それ以外の場合、クローズドプロキシは除外されます。

例

すべての種類のプロキシを取得するには：

https://proxy-seller.com/personal/api/v2/afoov21vcoodewq/proxy/list

特定のタイプ（例：IPv4）のプロキシを取得するには：

https://proxy-seller.com/personal/api/v2/afoov21vcoodewq/proxy/list/ipv4

回答

あらゆる種類のプロキシ

{
  "status": "success",
  "data": {
    "ipv4": [],
    "ipv6": [],
    "mobile": [],
    "isp": [],
    "mix": [],
    "mix_isp": [],
    "resident": []
  },
  "errors": []
}

プロキシの一種

{
    "status": "success",
    "data": {
        "items": [
            {
                "id": "69fa4b7f256cae5b70a79478",
                "order_id": "69fa4b795a1f522c7a53d589",
                "order_number": "TEST_1778011001948-uc_e_UUf2Z3RtGH",
                "basket_id": "69fa4b7a5a1f522c7a53d58b",
                "ip": "11.55.11.0",
                "ip_only": "11.55.11.0",
                "protocol": "HTTP",
                "port_socks": 49453,
                "port_http": 49353,
                "login": "login",
                "password": "password",
                "authIp": "",
                "rotation": null,
                "link_reboot": "#",
                "country": "Germany",
                "country_alpha3": "DEU",
                "status": "Active",
                "status_type": "ACTIVE",
                "can_prolong": true,
                "date_start": "05.05.2026",
                "date_end": "11.06.2026",
                "comment": "",
                "auto_renew": "N",
                "auto_renew_period": ""
            }
        ]
    },
    "errors": []
}

不適切なプロキシの種類

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "Could not find description of list/{type} in CrmUserApiProxy",
            "code": 22002,
            "customData": null
        }
    ]
}

なお、プロキシの種類が指定されていない場合、そのプロファイルに対して利用可能なすべての種類が返されることにご注意ください。

GEThttps://proxy-seller.com/personal/api/v2/{apiKey}/proxy/download/{type}
IPのエクスポート
このAPIエンドポイントを使用すると、自身のプロキシの一覧をダウンロードできます。

パスパラメータ：

名前

価値

必須

説明

種類

ipv4,ipv6,mobile,isp,mix,mix_isp、またはresident

はい

ダウンロードするリストに含めるプロキシの種類を指定します。

承認

<Your_API_Key>

はい

ご自身のAPIキー（入手方法)

オプションのパラメータ

名前

価値

説明

ext

txt

csv

プロキシリストのダウンロード形式を指定します。

%login%:%password%@%ip%:%port%

カスタム形式

proto

https

socks5

プロキシに使用するポート形式を指定します。

listId

整数

プロキシリストID（常駐ユーザーのみ。設定されていない場合は、すべてのシートからIPを返します）

package_key

文字列

プロキシリスト package_key（サブレジデントのみ）

国

文字列

Alpha3の国名（FRA、USAなど）

終わり

文字列

Y - エンディングプロキシの一覧

例

特定のタイプ（例：IPv4）のプロキシを取得するには：

https://proxy-seller.com/personal/api/v2/afoov21vcoodewq/proxy/download/ipv4?ext=txt&proto=https

回答

login:[email protected]:80;

login:[email protected]:81;

応答：プロキシの種類が間違っています

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "Could not find description of list{type} in CrmUserApiProxy",
            "code": 22002,
            "customData": null
        }
    ]
}

修正

POSThttps://proxy-seller.com/personal/api/v2/{apiKey}/proxy/replace
IPアドレスの置換
順序スロットを失うことなくIPをローテーションする。月間の置換枠にカウントされる。

パスパラメータ

名前

価値

必須

説明

承認

<Your_API_Key>

はい

ご自身のAPIキー（入手方法)

リクエスト本文

名前

種類

説明

ids

番号

単一のID、または「[ ]」で囲まれたIDの配列（カンマ区切り）

コメント

文字列

依頼に含める任意のコメント

タイプ

文字列

置換の種類

例

https://proxy-seller.com/personal/api/v2/afoov21vcoodewq/proxy/replace
{
    "ids": ["10"],
    "type": "CUSTOM",
    "comment": "Test replace IP"
}

回答

{
    "status": "success",
    "data": {
        "ok": {
            "ips": [
                "11.55.11.0"
            ],
            "msg": "Replacement request submitted"
        }
    },
    "errors": []
}
{
    "status": "error",
    "data": null,
    "errors": [
        {
            "code": 503,
            "message": "Error api key",
            "customData": null
        },
        {
            "code": 503,
            "message": "IP not allowed",
            "customData": null
        },
        {
            "code": 503,
            "message": "Request limit reached",
            "customData": null
        }
    ]
}
{
    "status": "error",
    "data": null,
    "errors": [
        {
            "code": 0,
            "message": "Set coorect type: NOT_WORK / INCORRECT_LOCATION / CANT_CHANGE_NETWORK / LOW_SPEED / CUSTOM",
            "customData": null
        }
    ]
}

置換の種類：NOT_WORK、INCORRECT_LOCATION、CANT_CHANGE_NETWORK、LOW_SPEED、CUSTOM

POST https://proxy-seller.com/personal/api/v2/{apiKey}/prolong/calc/{type}
IPの延長
指定されたIPアドレスの有効期限を延長します。課金はIPアドレス1つにつき1日単位で行われます。

このドキュメントでは、各種IPアドレスの自動更新設定方法について詳しく解説します。同じIPアドレスを維持するためには、期限内に更新を行う必要がある点にご注意ください。

拡張子の計算

このエンドポイントを使用すると、費用を計算できます。数量やレンタル期間に応じた割引は、当社のサービスで提供されているものと同様です。

パスパラメータ

名前

価値

必須

説明

承認

<Your_API_Key>

はい

ご自身のAPIキー（入手方法)

種類

ipv4

ipv6

mobile

isp

mix

mix_isp

はい

拡張したいプロキシの種類

リクエスト本文

名前

種類

説明

ids

番号

単一のID、または『[ ]』で囲まれ、コンマで区切られたIDの配列（取得方法）

クーポン

文字列

追加したいコメント

periodId

文字列

/reference/list/{type} リクエストで選択した期間のID

例（例：ipv4）

https://proxy-seller.com/personal/api/v2/afoov21vcoodewq/prolong/calc/ipv4
{
    "ids": ["10"],
    "periodId": "1m",
    "coupon": "",
    "paymentId": "balance"
}

回答

{
    "status": "success",
    "data": {
        "warning": "",
        "balance": 498648.72,
        "total": 3.49,
        "quantity": 1,
        "currency": "USD",
        "discount": 3.00,
        "items": [
            {
                "id": "69fa4b7f256cae5b70a79478",
                "order_id": "69fa4b795a1f522c7a53d589",
                "order_number": "TEST_1778011001948-uc_e_UUf2Z3RtGH",
                "basket_id": "69fa4b7a5a1f522c7a53d58b",
                "ip": "11.55.11.0",
                "ip_only": "11.55.11.0",
                "protocol": "HTTP",
                "port_socks": 49453,
                "port_http": 49353,
                "login": "login ",
                "password": "password",
                "authIp": "",
                "rotation": null,
                "link_reboot": "#",
                "country": "Germany",
                "country_alpha3": "DEU",
                "status": "Active",
                "status_type": "ACTIVE",
                "can_prolong": true,
                "date_start": "05.05.2026",
                "date_end": "11.06.2026",
                "comment": "",
                "auto_renew": "N",
                "auto_renew_period": ""
            }
        ],
        "orders": 1
    },
    "errors": []
}
{
    "status": "error",
    "data": {
        "warning": "Insufficient funds. Total $3.49. Not enough $2.49",
        "balance": 1.00,
        "total": 3.49,
        "quantity": 1,
        "currency": "USD",
        "discount": 3.00,
        "items": [
            {
                "id": "69fa4b7f256cae5b70a79478",
                "order_id": "69fa4b795a1f522c7a53d589",
                "order_number": "TEST_1778011001948-uc_e_UUf2Z3RtGH",
                "basket_id": "69fa4b7a5a1f522c7a53d58b",
                "ip": "11.55.11.0",
                "ip_only": "11.55.11.0",
                "protocol": "HTTP",
                "port_socks": 49453,
                "port_http": 49353,
                "login": "login",
                "password": "password",
                "authIp": "",
                "rotation": null,
                "link_reboot": "#",
                "country": "Germany",
                "country_alpha3": "DEU",
                "status": "Active",
                "status_type": "ACTIVE",
                "can_prolong": true,
                "date_start": "05.05.2026",
                "date_end": "11.06.2026",
                "comment": "",
                "auto_renew": "N",
                "auto_renew_period": ""
            }
        ],
        "orders": 1
    },
    "errors": []
}
{
    "status": "error",
    "data": null,
    "errors": [
        {
            "code": 0,
            "message": "Set existed [periodId] from reference",
            "customData": null
        }
    ]
}
{
    "status": "error",
    "data": null,
    "errors": [
        {
            "code": 0,
            "message": "IP not found",
            "customData": null
        }
    ]
}

POSThttps://proxy-seller.com/personal/api/v2/{apiKey}/prolong/make/{type}
IPの延長
このセクションでは、更新注文の作成方法について学びます。

更新注文を作成する

拡張注文を作成します。

パスパラメータ

名前

価値

必須

説明

承認

<Your_API_Key>

はい

ご自身のAPIキー（入手方法)

種類

ipv4

ipv6

mobile

isp

mix

mix_isp

はい

拡張したいプロキシの種類

リクエスト本文

名前

種類

説明

ids

番号

単一のID、または「[ ]」で囲まれたカンマ区切りのIDの配列（取得方法）

クーポン

文字列

プロモーションコード。

periodId

文字列

/reference/list/{type} リクエストで選択した期間のID

paymentId

文字列

決済システムのID「69e799e7497b2c153b33faca" - バランス、 "69e799e8497b2c153b33faed" - キャビネットに追加したカード

例（例：ipv4）

https://proxy-seller.com/personal/api/v2/afoov21vcoodewq/prolong/make/ipv4
{
    "ids": ["10"],
    "periodId": "1m",
    "coupon": "",
    "paymentId": "balance"
}

回答

{
    "status": "success",
    "data": {
        "orderId": "69fa4b795a1f522c7a53d589",
        "total": 3.49,
        "listBaseOrderNumbers": [
            "TEST_1778011001948-uc_e_UUf2Z3RtGH"
        ],
        "balance": 1.00
    },
    "errors": []
}
{
    "status": "error",
    "data": {
        "warning": "Insufficient funds. Total $3.49. Not enough $2.49",
        "balance": 1.00,
        "total": 3.49,
        "quantity": 1,
        "currency": "USD",
        "discount": 3.00,
        "items": [
            {
                "id": "69fa4b7f256cae5b70a79478",
                "order_id": "69fa4b795a1f522c7a53d589",
                "order_number": "TEST_1778011001948-uc_e_f7iNLfHqK8",
                "base_order_number": "TEST_1778011001948-uc_e_f7iNLfHqK8",
                "ip": "11.55.11.0",
                "port_http": null,
                "port_socks": null,
                "login": "x2alltop0qRU6",
                "password": "gwBwtL9LMM",
                "authIp": "",
                "country": "Germany",
                "date_start": "05.05.2026 19:56:42",
                "date_end": "10.08.2026 23:59:59",
                "comment": "",
                "status": "Active",
                "rotation": null,
                "link_reboot": "#",
                "can_prolong": true
            }
        ],
        "orders": 1
    },
    "errors": []
}
{
    "status": "error",
    "data": null,
    "errors": [
        {
            "code": 0,
            "message": "Set existed [periodId] from reference",
            "customData": null
        }
    ]
}
{
    "status": "error",
    "data": null,
    "errors": [
        {
            "code": 0,
            "message": "IP not found",
            "customData": null
        }
    ]
}
POSThttps://proxy-seller.com/personal/api/v2/{apiKey}/proxy/comment/set
コメントを追加
UIやエクスポートデータ内でIPを識別しやすくするため、自由記述のメモ（最大256文字）を添付してください。

パスパラメータ

名前

価値

必須

説明

承認

<Your_API_Key>

はい

ご自身のAPIキー（入手方法)

リクエスト本文

名前

種類

説明

ids

番号

単一のID、または「[ ]」で囲まれ、カンマで区切られたIDの配列（取得方法）

コメント

文字列

追加したいコメント

例

https://proxy-seller.com/personal/api/v2/afoov21vcoodewq/proxy/comment/set
{
    "ids": ["10"],
    "comment": "My server"
}

回答

{
    "status": "success",
    "data": {
        "updated": 1
    },
    "errors": []
}
{
    "status": "error",
    "data": null,
    "errors": [
        {
            "code": 0,
            "message": "IP not found",
            "customData": null
        }
    ]
}

すべてのプロキシエンドポイントに共通する事項

  1. ベースURL

    https://proxy-seller.com/personal/api/v2/{YourApiKey}/

  2. 認証

    URLパス内のAPIキー。

  3. エラーモデル

    ビジネス上のエラーは、HTTP 200 を返します。errors[] 入力済み。

IPの管理が完了したら

Authorizationissue per-order credentialsOpenOrder actionsbuy more proxies when you need additional IPsOpenBalancecheck funds before bulk prolongationOpen

承認

Previous Page

アクティブなプロキシを取得する

Next Page

On this page

パスパラメータ
クエリパラメータ
例
回答
パスパラメータ：
オプションのパラメータ
例
回答
修正
パスパラメータ
リクエスト本文
例
回答
拡張子の計算
パスパラメータ
リクエスト本文
例（例：ipv4）
回答
更新注文を作成する
パスパラメータ
リクエスト本文
例（例：ipv4）
回答
パスパラメータ
例
回答
すべてのプロキシエンドポイントに共通する事項
1
ベースURL
2
認証
3
エラーモデル
IPの管理が完了したら