Liste erstellen
Aktualisiert:
Endpunkt:
Pfadparameter
Name | Wert | Beschreibung |
|---|---|---|
Autorisierung |
| Dein persönlicher API-Schlüssel |
Anfragetext
Name | Typ | Beschreibung |
|---|---|---|
Titel | String | Name der Liste, die Sie erstellen |
Whitelist | String | IP-Adressen für die Autorisierung. Lassen Sie das Feld leer, wenn Sie sich mit Anmeldedaten autorisieren möchten. |
geo | Objekt | Füge deiner Liste GEO-Daten hinzu (Land, Region, Stadt, Internetanbieter) |
Land | String | Aus der GEO-Datenbank ausgewähltes Land (Die Groß- und Kleinschreibung ist wichtig) |
Region | String | Aus der GEO-Datenbank ausgewählte Region (Die Groß- und Kleinschreibung ist wichtig) |
Stadt | String | Aus der GEO-Datenbank ausgewählte Stadt (Die Groß- und Kleinschreibung ist wichtig) |
isp | String | ISP aus der GEO-Datenbank ausgewählt (Die Groß- und Kleinschreibung ist wichtig) |
export | Objekt | Hier geben Sie die Anzahl der IP-Adressen in Ihrer Liste sowie die Art des Exports (Portnummern und Dateiformat) an. |
Ports | Nummer | Anzahl der IPs (maximal 1000) |
ext | String | Art des Exports |
Rotation | Nummer | „Rotation: ‚-1‘ für keine Rotation (Sticky), ‚0‘ für Rotation auf Anfrage, ‚1‘ bis ‚3600‘ für zeitbasierte Rotation in Sekunden“ |
Beispiel
https://proxy-seller.com/personal/api/v2/fj4948ffhg58gh843gh/resident/list/add
{
"title": "myList",
"whitelist": "",
"geo": {
"country": "AD",
"region": "Andorra la Vella",
"city": "Andorra la Vella",
"isp": "Andorra Telecom, S.a.u."
},
"export": {
"ports": 1,
"ext": "csv"
},
"rotation": -1
}Antwort
{
"status": "success",
"data": {
"id": 21829782,
"title": "myList",
"login": "123123",
"password": "123123",
"whitelist": "",
"rotation": -1,
"geo": [
{
"country": "AD",
"region": "Andorra la Vella",
"city": "Andorra la Vella",
"isp": "Andorra Telecom, S.a.u."
}
],
"export": {
"ports": "1",
"ext": "csv"
}
},
"errors": []
}{
"status": "error",
"data": null,
"errors": [
{
"message": "Error api key",
"code": 503,
"customData": null
},
{
"message": "IP not allowed",
"code": 503,
"customData": null
},
{
"message": "Request limit reached",
"code": 503,
"customData": null
}
]
}{
"status": "error",
"data": null,
"errors": [
{
"message": "IP not allowed",
"code": 503,
"customData": null
}
]
}{
"status": "error",
"data": null,
"errors": [
{
"message": "Tarif not found",
"code": 0,
"customData": null
}
]
}Antworten mit einem Fehler im Request-Body
{
"status": "error",
"data": null,
"errors": [
{
"message": "Incorrect IP address 0.0.0.0 entered",
"code": 409,
"customData": null
}
]
}{
"status": "error",
"data": null,
"errors": [
{
"message": "IP 127.0.0.1 already linked",
"code": 0,
"customData": null
}
]
}Same error may be in case with wrong "region", "city", "isp"!
{
"status": "error",
"data": null,
"errors": [
{
"message": "Invalid country (region, city, isp) ISO code",
"code": 400,
"customData": null
},
{
"message": "Invalid country ISO code (400)",
"code": 0,
"customData": null
}
]
}