IP kaufen und verwalten

Lebenszyklus-Endpunkte für die Arbeit mit Proxys auf dem Konto. Dieselbe Reihe von Vorgängen funktioniert für alle vier Proxy-Typen (ipv4,ipv6,isp,mobile), wobei in jedem Abschnitt auf kleinere Besonderheiten pro Typ hingewiesen wird.

Konzepte

proxyType. Immer eine deripv4,ipv6,isp,mobile. In jeder Anfrage entweder als Abfrageparameter oder als Textfeld erforderlich.

id gegenorderId. Die meisten Typen adressieren Proxys individuell nachid.IPv6 ist die Ausnahme - IPv6-Proxys werden gekauft, gelistet und erneuert vonorderIdda jeder IPv6-Auftrag als unteilbare Gruppe behandelt wird.

mobile-nur Felder. Mobile Proxys haben ein paar zusätzliche Konzepte: eine Liste von Betreibern, eine Rotationszeit pro Betreiber und einen Neustart-Link, um die IP manuell zu rotieren. SieheMobile Tarife.

Gemeinsamer Antwortumschlag. Jeder Endpunkt auf dieser Seite gibt bei Erfolg diese Top-Level-Form zurück - nur die vorgangsspezifischen Felder unterscheiden sich:

{
  "success": true,
  "user": "[email protected]",
  "balance": 13.09,
  "currency": "USD",
  "proxyType": "ipv4"
}

Feld	Typ	Beschreibung
`success`	boolean	Betriebsstatus.
`user`	string	E-Mail-Konto.
`balance`	nummer	Kontostand nach der Operation, in`currency`.
`currency`	string	ISO-Währungscode.
`proxyType`	string	Gibt den angeforderten Typ wieder.

Für alle anderen Top-Level-Felder und Proxy-Objektformen pro Typ siehe die einzelnen Operationen unten.

Operation	Methode	Pfad
Liste gekaufter Vollmachten	`GET`	`/get/proxies`
Mobile Tarife	`GET`	`/get/mobile/tariffs`
Berechnen Sie den Kaufpreis	`GET`	`/get/order/price`
Berechnen Sie den Preis der Verlängerung	`GET`	`/get/extend/price`
Eine Bestellung aufgeben	`POST`	`/order`
Proxys erweitern	`POST`	`/extend`

Alle Pfade sind relativ zu/client-api/v1/<apiKey>/.

Liste gekaufter Vollmachten

GET/de-DE/client-api/v1/<apiKey>/get/proxies?proxyType=<type>

Gibt alle aktiven Proxys des angeforderten Typs zurück.

Abfrage-Parameter

Name	Typ	Erforderlich	Beschreibung
`proxyType`	string	ja	Einer von:`ipv4`,`ipv6`,`isp`,`mobile`.

Beispielanfrage

curl "https://proxy-ipv4.com/client-api/v1/$KEY/get/proxies?proxyType=ipv4"

Beispielhafte Antwort

Top-Level fügt hinzucountOfProxy undproxies. Registerkarten wechseln - die Form des Proxy-Objekts unterscheidet sich je nach Typ, und IPv6 ist nach Reihenfolge gruppiert.

json
{
  "success": true,
  "user": "[email protected]",
  "balance": 13.09,
  "currency": "USD",
  "proxyType": "ipv4",
  "countOfProxy": 2,
  "proxies": [
    {
      "id": "id1",
      "ip": "185.81.112.215",
      "country": "GBR",
      "dateStart": "2022-08-29T14:55:38.293+00:00",
      "dateEnd":   "2022-08-30T23:59:38.293+00:00",
      "httpsPort": "49162",
      "socks5Port": "49163",
      "authInfo": { "login": "authLogin123", "password": "authPassword" }
    }
  ]
}

json
{
  "success": true,
  "user": "[email protected]",
  "balance": 13.09,
  "currency": "USD",
  "proxyType": "ipv4",
  "countOfProxy": 2,
  "proxies": [
    {
      "id": "id1",
      "ip": "185.81.112.215",
      "country": "GBR",
      "dateStart": "2022-08-29T14:55:38.293+00:00",
      "dateEnd":   "2022-08-30T23:59:38.293+00:00",
      "httpsPort": "49162",
      "socks5Port": "49163",
      "authInfo": { "login": "authLogin123", "password": "authPassword" }
    }
  ]
}

json
{
  "success": true,
  "user": "[email protected]",
  "balance": 13.09,
  "currency": "USD",
  "proxyType": "ipv6",
  "countOfProxy": 2,
  "proxies": [
    {
      "orderId": "orderId1",
      "ips": [
        {
          "id": "id1",
          "ip": "140.82.53.23:10002",
          "country": "FRA",
          "dateStart": "2022-08-03T14:04:59.131+00:00",
          "dateEnd":   "2022-10-02T14:04:59.159+00:00",
          "protocol": "SOCKS5",
          "authInfo": { "login": "authLogin123", "password": "authPassword" }
        }
      ]
    }
  ]
}

json
{
  "success": true,
  "user": "[email protected]",
  "balance": 13.09,
  "currency": "USD",
  "proxyType": "mobile",
  "countOfProxy": 2,
  "proxies": [
    {
      "id": "id1",
      "ip": "61.62.63.64",
      "country": "FRA",
      "dateStart": "2022-08-30T14:54:25.414+00:00",
      "dateEnd":   "2022-09-29T23:59:25.414+00:00",
      "httpsPort": "7781",
      "socks5Port": "8891",
      "mobileOperator": "freemobilesas_france",
      "rotationTime": 0,
      "rebootLink": "https://proxy-ipv4.com/modem/reboot/448eac96-8546-4389-8f56-54b2b4798d12",
      "authInfo": { "login": "authLogin123", "password": "authPassword" }
    }
  ]
}

Felder der obersten Ebene

Feld	Typ	Beschreibung
`countOfProxy`	nummer	Gesamtzahl der Bevollmächtigten des angeforderten Typs.
`proxies`	array	Liste der Proxys. Bei IPv6 sind die Elemente Auftragsgruppen mit`ips`.

Felder des Proxy-Objekts

Feld	Typ	Anwesend in	Beschreibung
`id`	string	Alle	Proxy-ID. Verwenden Sie diese, wenn Sie IPv4, ISP oder Mobile erweitern.
`orderId`	string	Nur IPv6	Bestell-ID. IPv6 kann nur um eine ganze Bestellung erweitert werden - verwenden Sie dies füroperationen ausweiten.
`ips`	array	Nur IPv6	Liste der einzelnen Proxy-Objekte pro Auftrag.
`ip`	string	Alle	Die IP-Adresse. Bei IPv6 enthält der Wert einen Port (z. B.`140.82.53.23:10002`).
`country`	string	Alle	ISO 3166-1 Alpha-3 Ländercode.
`dateStart` /`dateEnd`	string	Alle	ISO 8601 Zeitstempel für das Mietfenster.
`httpsPort` /`socks5Port`	string	IPv4, ISP, Mobil	Ports für HTTP/HTTPS und SOCKS5.
`protocol`	string	Nur IPv6	`HTTPS` oder`SOCKS5` - zum Zeitpunkt der Bestellung festgelegt.
`mobileOperator`	string	Nur mobil	Operator-Tag, z.B.`freemobilesas_france`.
`rotationTime`	nummer	Nur mobil	IP-Rotationsintervall in Minuten.`0` bedeutet Rotation nur über die Verbindung.
`rebootLink`	string	Nur mobil	URL, um die IP-Rotation manuell auszulösen.
`authInfo`	objekt	Alle	`{ login, password }` für die Proxy-Authentifizierung.

Mobile Tarife

GET/de-DE/client-api/v1/<apiKey>/get/mobile/tariffs

Nur für Mobiltelefone. Gibt verfügbare Kombinationen von Land, Betreiber und Rotationszeit zurück. Verwenden Sie dies, um gültigemobileOperator undrotationTime werte, bevor Sie Kaufpreis berechnen oder Bestellung für mobile Proxys aufgeben aufrufen.

Beispielanfrage

curl "https://proxy-ipv4.com/client-api/v1/$KEY/get/mobile/tariffs"

Beispielhafte Antwort

{
  "success": true,
  "user": "[email protected]",
  "balance": 13.09,
  "currency": "USD",
  "tariffs": [
    {
      "country": "GBR",
      "mobileOperator": [
        { "name": "Three", "rotationTime": [0, 5, 10] },
        { "name": "O2",    "rotationTime": [5, 10] }
      ]
    },
    {
      "country": "USA",
      "mobileOperator": [
        { "name": "AT&T Wireless", "rotationTime": [0, 5, 10] }
      ]
    }
  ]
}

Antwortfelder

Feld	Typ	Beschreibung
`tariffs`	array	Liste der Zolleinträge auf Länderebene.
`tariffs[].country`	string	ISO 3166-1 Alpha-3 Ländercode.
`tariffs[].mobileOperator`	array	In diesem Land verfügbare Betreiber.
`tariffs[].mobileOperator[].name`	string	Operator-Tag - übergeben als`mobileOperator` in Bestellanforderungen.
`tariffs[].mobileOperator[].rotationTime`	zahlenreihe	Erlaubt`rotationTime` werte in Minuten.`0` bedeutet Rotation nur über die Verbindung.

Berechnen Sie den Kaufpreis

GET/de-DE/client-api/v1/<apiKey>/get/order/price?<params>

Liefert die Gesamtkosten und den Preis pro Proxy für eine hypothetische Bestellung. Verwenden Sie diese Option, bevor Sie eine Bestellung aufgeben, um Validierungsfragen zu klären, ohne das Guthaben auszugeben.

Abfrage-Parameter

Name	Typ	Erforderlich	Beschreibung
`proxyType`	string	ja	Einer von:`ipv4`,`ipv6`,`isp`,`mobile`.
`days`	nummer	ja	Mietzeitraum. Gültige Werte erhalten Sie vonVerfügbare Mietzeiträume.
`country`	string	ja	ISO 3166-1 Alpha-3-Code. Gültige Werte erhalten Sie vonVerfügbare Länder.
`count`	nummer	ja	Anzahl der Bevollmächtigten.Bei IPv6 muss sie ≥ 10 sein.
`goal`	string	bedingt	Zweck der Verwendung. Erforderlich, sofern nicht`customGoal` gesendet wird.
`customGoal`	string	bedingt	Benutzerdefinierter Zweck, ≥ 5 Zeichen.Nur mobil - verwenden, wenn`goal` keinem vordefinierten Wert entspricht. Einer der`goal` oder`customGoal` muss vorhanden sein.
`mobileOperator`	string	nur mobil	Operator Tag vonMobile Tarife.
`rotationTime`	nummer	nur mobil	Rotationsintervall in Minuten vonMobile Tarife.

Beispiele

bash
curl "https://proxy-ipv4.com/client-api/v1/$KEY/get/order/price\

bash
curl "https://proxy-ipv4.com/client-api/v1/$KEY/get/order/price\

Note `count=10` — IPv6 requires at least 10.

bash
curl "https://proxy-ipv4.com/client-api/v1/$KEY/get/order/price\

curl "https://proxy-ipv4.com/client-api/v1/$KEY/get/order/price\
?proxyType=mobile&days=7&goal=instagram&country=FRA&count=1\
&mobileOperator=freemobilesas_france&rotationTime=5"

Beispielhafte Antwort

{
  "success": true,
  "user": "[email protected]",
  "balance": 13.09,
  "currency": "USD",
  "proxyType": "ipv4",
  "days": 7,
  "count": 2,
  "goal": "instagram",
  "amount": 2.78,
  "price": 1.39
}

Für Mobiltelefone ist die Antwort zusätzlich ein EchomobileOperator undrotationTime.

Antwortfelder

Feld	Typ	Beschreibung
`days`,`count`,`goal`	gemischt	Gibt die angeforderten Werte wieder.
`amount`	nummer	Gesamtkosten in`currency`.
`price`	nummer	Pro-Proxy-Kosten.
`mobileOperator`,`rotationTime`	gemischt	Nur mobil - gibt die angeforderten Werte aus.

Berechnen Sie den Preis der Verlängerung

GET/de-DE/client-api/v1/<apiKey>/get/extend/price?<params>

Gibt die Gesamtkosten und den Preis pro Proxy für die Erweiterung bestehender Proxys zurück. Verwendung vorProxys erweitern.

Abfrage-Parameter

Name	Typ	Erforderlich	Beschreibung
`proxyType`	string	ja	Einer von:`ipv4`,`ipv6`,`isp`,`mobile`.
`days`	nummer	ja	Verlängerungszeitraum. Es gelten die gleichen Werte wie beim Kauf.
`IpId`	string	für IPv4, ISP, Mobile	Durch Kommata getrennte Proxy-IDs.
`orderId`	string	für IPv6	Durch Kommata getrennte Auftrags-IDs. IPv6 erweitert ganze Aufträge.

Beispiele

curl "https://proxy-ipv4.com/client-api/v1/$KEY/get/extend/price\
?proxyType=ipv4&days=7&IpId=id1,id2,id3"

curl "https://proxy-ipv4.com/client-api/v1/$KEY/get/extend/price\
?proxyType=ipv4&days=7&IpId=id1,id2,id3"

Uses `orderId` instead of `IpId`.
curl "https://proxy-ipv4.com/client-api/v1/$KEY/get/extend/price\
?proxyType=ipv6&days=30&orderId=orderId1,orderId2"

curl "https://proxy-ipv4.com/client-api/v1/$KEY/get/extend/price\
?proxyType=ipv4&days=7&IpId=id1,id2,id3"

Beispielhafte Antwort

{
      "success": true,
      "user": "[email protected]",
      "balance": 13.09,
      "currency": "USD",
      "proxyType": "ipv4",
      "days": 7,
      "count": 3,
      "amount": 9.13,
      "price": 3.04,
      "ipId": ["id1", "id2", "id3"]
    }

{
      "success": true,
      "user": "[email protected]",
      "balance": 13.09,
      "currency": "USD",
      "proxyType": "ipv4",
      "days": 7,
      "count": 3,
      "amount": 9.13,
      "price": 3.04,
      "ipId": ["id1", "id2", "id3"]
    }

Adds `ordersId` (the requested order IDs) and expanded `ipId` (every
proxy contained in those orders).
{
      "success": true,
      "user": "[email protected]",
      "balance": 13.09,
      "currency": "USD",
      "proxyType": "ipv6",
      "days": 30,
      "count": 20,
      "amount": 123.42,
      "price": 6.17,
      "ordersId": ["orderId1", "orderId2"],
      "ipId": ["id1", "id2", "id3", "id4", "id5", "id6", "id7", "id8", "id9", "id10",
               "id11", "id12", "id13", "id14", "id15", "id16", "id17", "id18", "id19", "id20"]
    }

{
      "success": true,
      "user": "[email protected]",
      "balance": 13.09,
      "currency": "USD",
      "proxyType": "ipv4",
      "days": 7,
      "count": 3,
      "amount": 9.13,
      "price": 3.04,
      "ipId": ["id1", "id2", "id3"]
    }

Antwortfelder

Feld	Typ	Beschreibung
`days`	nummer	Gibt den gewünschten Zeitraum wieder.
`count`	nummer	Summe der Proxys, die erweitert werden. Für IPv6 - Summe der Proxys für alle angeforderten Aufträge.
`amount`	nummer	Gesamtkosten der Verlängerung.
`price`	nummer	Kosten pro Proxy-Erweiterung.
`ipId`	array	Proxy-IDs, die in dieser Erweiterung enthalten sind. Für IPv6, erweitert um die angeforderten Aufträge.
`ordersId`	array	Nur IPv6 - gibt die angeforderten Auftragskennungen per Echo aus.

Eine Bestellung aufgeben

POST/de-DE/client-api/v1/<apiKey>/order

Körper der Anfrage

Name	Typ	Erforderlich	Beschreibung
`proxyType`	string	ja	Einer von:`ipv4`,`ipv6`,`isp`,`mobile`.
`days`	nummer	ja	Mietdauer.
`country`	string	ja	ISO 3166-1 Alpha-3-Code.
`count`	nummer	ja	Anzahl der Bevollmächtigten.Bei IPv6 muss sie ≥ 10 sein.
`goal`	string	ja	Verwendungszweck.
`authType`	string	ja	`login` oder`ip`.
`authIp`	string	bedingt	IP, die für die Authentifizierung zugelassen ist. Erforderlich, wenn`authType` ist`ip`.
`protocol`	string	Nur IPv6	`HTTPS` oder`SOCKS5`.
`mobileOperator`	string	nur mobil	Betreiberkennzeichnung von Mobilfunktarifen.
`rotationTime`	nummer	nur mobil	Rotationsintervall in Minuten von Mobilfunktarifen.

Beispielanfrage

curl -X POST https://proxy-ipv4.com/client-api/v1/API_KEY/order \
      -H "Content-Type: application/json" \
      -d '{
        "proxyType": "ipv4",
        "days": 90,
        "goal": "instagram",
        "country": "GBR",
        "count": 2,
        "authType": "login"
      }'

curl -X POST https://proxy-ipv4.com/client-api/v1/API_KEY/order \
      -H "Content-Type: application/json" \
      -d '{
        "proxyType": "ipv4",
        "days": 90,
        "goal": "instagram",
        "country": "GBR",
        "count": 2,
        "authType": "login"
      }'

Adds `protocol`. Requires `count >= 10`.

curl -X POST https://proxy-ipv4.com/client-api/v1/API_KEY/order \
      -H "Content-Type: application/json" \
      -d '{
        "proxyType": "ipv6",
        "days": 30,
        "goal": "instagram",
        "country": "GBR",
        "count": 10,
        "authType": "login",
        "protocol": "SOCKS5"
      }'

Adds `mobileOperator` and `rotationTime`.

curl -X POST https://proxy-ipv4.com/client-api/v1/$KEY/order \
      -H "Content-Type: application/json" \
      -d '{
        "proxyType": "mobile",
        "days": 30,
        "goal": "instagram",
        "country": "FRA",
        "count": 1,
        "authType": "login",
        "mobileOperator": "freemobilesas_france",
        "rotationTime": 5
      }'

When `authType=ip`, add `authIp`. Works for any `proxyType`.

curl -X POST https://proxy-ipv4.com/client-api/v1/$KEY/order \
      -H "Content-Type: application/json" \
      -d '{
        "proxyType": "ipv4",
        "days": 90,
        "goal": "instagram",
        "country": "GBR",
        "count": 2,
        "authType": "ip",
        "authIp": "203.0.113.42"
      }'

Beispielhafte Antwort

{
  "success": true,
  "user": "[email protected]",
  "balance": 4.09,
  "currency": "USD",
  "proxyType": "ipv4",
  "orderNumber": "DV-16620211552356-jA"
}

Antwortfelder

Feld	Typ	Beschreibung
`orderNumber`	string	Die Nummer des neuen Auftrags. Verwenden Sie sie zum Nachschlagen von Vollmachten inListe gekaufter Vollmachten - für IPv6 erscheint sie als`orderId` in Antworten.
`balance`	nummer	Verbleibender Saldo nach der Aufladung.

Proxys erweitern

POST/de-DE/client-api/v1/<apiKey>/extend

Verlängert bestehende Vollmachten und berechnet den Saldo.

Körper der Anfrage

Name	Typ	Erforderlich	Beschreibung
`proxyType`	string	ja	Einer von:`ipv4`,`ipv6`,`isp`,`mobile`.
`days`	nummer	ja	Verlängerungszeitraum.
`IpId`	array von Zeichenketten	für IPv4, ISP, Mobile	Zu erweiternde Proxy-IDs.
`orderId`	array von Zeichenketten	für IPv6	Zu erweiternde Auftrags-IDs.

Beispielanfrage

```bash
curl -X POST https://proxy-ipv4.com/client-api/v1/$KEY/extend \
  -H "Content-Type: application/json" \
  -d '{
    "proxyType": "ipv4",
    "days": 30,
    "IpId": ["id1", "id2"]
  }'
```

```bash
curl -X POST https://proxy-ipv4.com/client-api/v1/$KEY/extend \
  -H "Content-Type: application/json" \
  -d '{
    "proxyType": "ipv4",
    "days": 30,
    "IpId": ["id1", "id2"]
  }'
```

```bash
curl -X POST https://proxy-ipv4.com/client-api/v1/$KEY/extend \
  -H "Content-Type: application/json" \
  -d '{
    "proxyType": "ipv4",
    "days": 30,
    "IpId": ["id1", "id2"]
  }'
```

Uses `orderId` array.

```bash
curl -X POST https://proxy-ipv4.com/client-api/v1/$KEY/extend \
  -H "Content-Type: application/json" \
  -d '{
    "proxyType": "ipv6",
    "days": 30,
    "orderId": ["orderId1"]
  }'
```

Beispielhafte Antwort

{
  "success": true,
  "user": "[email protected]",
  "balance": 4.09,
  "currency": "USD"
}

Antwortfelder

Feld	Typ	Beschreibung
`balance`	nummer	Verbleibender Saldo nach der Aufladung.

IP kaufen und verwalten

Konzepte

Liste gekaufter Vollmachten

Abfrage-Parameter

Beispielanfrage

Beispielhafte Antwort

Felder der obersten Ebene

Felder des Proxy-Objekts

Mobile Tarife

Beispielanfrage

Beispielhafte Antwort

Antwortfelder

Berechnen Sie den Kaufpreis

Abfrage-Parameter

Beispiele

Beispielhafte Antwort

Antwortfelder

Berechnen Sie den Preis der Verlängerung

Abfrage-Parameter

Beispiele

Beispielhafte Antwort

Antwortfelder

Eine Bestellung aufgeben

Körper der Anfrage

Beispielanfrage

Beispielhafte Antwort

Antwortfelder

Proxys erweitern

Körper der Anfrage

Beispielanfrage

Beispielhafte Antwort

Antwortfelder

On this page