Proxy-seller

Aktionen mit Proxys

Aktualisiert:

Verwalten Sie IP-Adressen im Rahmen Ihrer Proxy-Aufträge – listen Sie sie auf, wechseln Sie sie ab, verlängern Sie sie oder versehen Sie sie mit Anmerkungen.

Gemeinsamer Parameter. Jeder Endpunkt auf dieser Seite arbeitet mit einer bestimmten Reihenfolge. Übergeben Sie „orderNumber“ – diese entnehmen Sie GET /proxy/list.

GEThttps://proxy-seller.com/personal/api/v2/{apiKey}/proxy/list
Gibt aktive Proxys nach Typ gruppiert zurück.
GEThttps://proxy-seller.com/personal/api/v2/{apiKey}/proxy/list/{type}
Gibt aktive Proxys eines Typs zurück. Unterstützt dieselben Abfrageparameter wie /proxy/list

Pfadparameter

Name

Wert

Erforderlich

Beschreibung

Typ

ipv4, ipv6, mobile, isp, mix, mix_isp, oder resident

Ja

Legt fest, welche Art von Proxys in die heruntergeladene Liste aufgenommen werden sollen.


Autorisierung

<Your_API_Key>

Ja

Dein persönlicher API-Schlüssel (So erhalten Sie)

Abfrageparameter

Name

Typ

Erforderlich

Beschreibung

Aktuell

String

Nein

Ygibt Proxies aus dem zuletzt aktiven Auftrag zurück, wenn orderId wird nicht bereitgestellt.

orderId

String

Nein

Gib einen Proxy für eine bestimmte `orderId` oder `OrderPart.number` zurück

Land

String

Nein

Alpha3-Ländername (FRA oder DEU re…)

Ende

String

Nein

Y gibt nur zurück ENDED Proxys, die noch dateEnd in Zukunft. Andernfalls sind geschlossene Proxys ausgeschlossen.

Beispiel

So rufen Sie Proxys aller Art ab:

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

So rufen Sie Proxys eines bestimmten Typs (z. B. IPv4) ab:

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

Antwort

Alle Arten von Proxys

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

Eine Art von Proxy

{
    "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": []
}

Falsche Art von Proxy

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

Bitte beachten Sie: Wenn kein Proxy-Typ angegeben wird, werden alle verfügbaren Typen für Ihr Profil zurückgegeben.

GEThttps://proxy-seller.com/personal/api/v2/{apiKey}/proxy/download/{type}
IPs exportieren
Über diesen API-Endpunkt können Sie die Liste Ihrer Proxys herunterladen.

Pfadparameter:

Name

Wert

Erforderlich

Beschreibung

Typ

ipv4, ipv6, mobile, isp, mix, mix_isp, oder resident

Ja

Legt fest, welche Art von Proxys in die heruntergeladene Liste aufgenommen werden sollen.

Autorisierung

<Your_API_Key>

Ja

Dein persönlicher API-Schlüssel (So erhalten Sie)

Optionale Parameter

Name

Wert

Beschreibung

ext

txt

csv

Gibt das Format an, in dem die Proxy-Liste heruntergeladen wird.

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

Benutzerdefiniertes Format

proto

https

socks5

Gibt das von Ihnen bevorzugte Proxy-Port-Format für die Proxys an.

listId

Ganzzahl

Proxy-Listen-ID (nur für Resident; falls nicht festgelegt, wird die IP-Adresse aus allen Tabellen zurückgegeben)

package_key

String

Proxy-Liste „package_key“ (nur für Subresident)

Land

String

Alpha3-Ländername (FRA oder USA oder …)

Ende

String

Y - Liste der Endungs-Proxies

Beispiel

So rufen Sie Proxys eines bestimmten Typs (z. B. IPv4) ab:

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

Antwort

login:[email protected]:80;

login:[email protected]:81;

Fehler: Falscher Proxy-Typ

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

Bearbeiten

POSThttps://proxy-seller.com/personal/api/v2/{apiKey}/proxy/replace
IP-Adressen ersetzen
Wechseln Sie eine IP-Adresse, ohne den Platz in der Reihenfolge zu verlieren. Wird auf das monatliche Austauschkontingent angerechnet.

Pfadparameter

Name

Wert

Erforderlich

Beschreibung

Autorisierung

<Your_API_Key>

Ja

Dein persönlicher API-Schlüssel (So erhalten Sie)

Anfragetext

Name

Typ

Beschreibung

ids

Nummer

Eine einzelne ID oder ein Array von IDs in „[ ]“, durch Kommas getrennt

Kommentar

String

Optionaler Kommentar, der dem Auftrag beigefügt werden kann

Typ

String

Art der Ersetzung

Beispiel

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

Antwort

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

Ersetzungsarten: NOT_WORK, INCORRECT_LOCATION, CANT_CHANGE_NETWORK, LOW_SPEED, CUSTOM

POST https://proxy-seller.com/personal/api/v2/{apiKey}/prolong/calc/{type}
IPs verlängern
Verlängerung der Gültigkeitsdauer für ausgewählte IP-Adressen. Abrechnung pro IP-Tag.

Dieses Dokument enthält eine detaillierte Anleitung zur Einrichtung der automatischen Verlängerung für Ihre IP-Adressen verschiedener Typen. Bitte beachten Sie, dass IP-Adressen rechtzeitig verlängert werden müssen, um die gleichen Adressen beizubehalten.

Erweiterung berechnen

Über diesen Endpunkt können Sie die Kosten berechnen. Mengen- und Laufzeitrabatte entsprechen denen, die unser Service anbietet.

Pfadparameter

Name

Wert

Erforderlich

Beschreibung

Autorisierung

<Your_API_Key>

Ja

Dein persönlicher API-Schlüssel (So erhalten Sie)

Typ

ipv4

ipv6

mobile

isp

mix

mix_isp

Ja

Der Proxy-Typ, den Sie erweitern möchten

Anfragetext

Name

Typ

Beschreibung

ids

Nummer

Eine einzelne ID oder ein Array von IDs in „[ ]“, durch Kommas getrennt (so geht’s)

Gutschein

String

Der Kommentar, den Sie hinzufügen möchten

periodId

String

ID des Zeitraums, den Sie in der Anfrage /reference/list/{type} ausgewählt haben

Beispiel (z. B. IPv4)

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

Antwort

{
    "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}
IPs verlängern
In diesem Abschnitt erfahren Sie, wie Sie eine Verlängerungsbestellung erstellen.

Erstellen Sie einen Verlängerungsauftrag

Erstellt einen Erweiterungsauftrag.

Pfadparameter

Name

Wert

Erforderlich

Beschreibung

Autorisierung

<Your_API_Key>

Ja

Dein persönlicher API-Schlüssel (So erhalten Sie)

Typ

ipv4

ipv6

mobile

isp

mix

mix_isp

Ja

Der Proxy-Typ, den Sie erweitern möchten

Anfragetext

Name

Typ

Beschreibung

ids

Nummer

Eine einzelne ID oder ein Array von IDs in „[ ]“, durch Kommas getrennt (So erhalten Sie sie)

Gutschein

String

Promo-Code.

periodId

String

ID des Zeitraums, den Sie in der Anfrage /reference/list/{type} ausgewählt haben

paymentId

String

IDs des Zahlungssystems "69e799e7497b2c153b33faca„ – Balance, „69e799e8497b2c153b33faed„ – Karte, die du in deine Sammlung aufgenommen hast“

Beispiel (z. B. IPv4)

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

Antwort

{
    "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
Kommentare hinzufügen
Fügen Sie eine Freitext-Notiz (max. 256 Zeichen) hinzu, um die Identifizierung einer IP in der Benutzeroberfläche oder in Exportdateien zu erleichtern.

Pfadparameter

Name

Wert

Erforderlich

Beschreibung

Autorisierung

<Your_API_Key>

Ja

Dein persönlicher API-Schlüssel (So erhalten Sie)

Anfragetext

Name

Typ

Beschreibung

ids

Nummer

Eine einzelne ID oder ein Array von IDs in „[ ]“, durch Kommas getrennt (so geht’s)

Kommentar

String

Der Kommentar, den Sie hinzufügen möchten

Beispiel

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

Antwort

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

Gilt für alle Proxy-Endpunkte

  1. Basis-URL

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

  2. Authentifizierung

    API-Schlüssel im URL-Pfad.

  3. Fehlermodell

    Geschäftliche Fehler geben den HTTP-Status 200 zurück mit errors[] ausgefüllt.

Nachdem Sie Ihre IPs verwaltet haben

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

On this page

Pfadparameter
Abfrageparameter
Beispiel
Antwort
Pfadparameter:
Optionale Parameter
Beispiel
Antwort
Bearbeiten
Pfadparameter
Anfragetext
Beispiel
Antwort
Erweiterung berechnen
Pfadparameter
Anfragetext
Beispiel (z. B. IPv4)
Antwort
Erstellen Sie einen Verlängerungsauftrag
Pfadparameter
Anfragetext
Beispiel (z. B. IPv4)
Antwort
Pfadparameter
Beispiel
Antwort
Gilt für alle Proxy-Endpunkte
1
Basis-URL
2
Authentifizierung
3
Fehlermodell
Nachdem Sie Ihre IPs verwaltet haben