Crear lista
Actualizado:
Objetivo:
Parámetros de ruta
Nombre | Valor | Descripción |
|---|---|---|
Autorización |
| Tu clave API personal |
Cuerpo de la solicitud
Nombre | Tipo | Descripción |
|---|---|---|
título | Cadena | Nombre de la lista que estás creando |
lista blanca | Cadena | Direcciones IP para la autorización. Déjalo en blanco si quieres autorizarte con credenciales de inicio de sesión. |
geo | objeto | Añade datos GEO a tu lista (país, región, ciudad, proveedor de servicios de Internet) |
país | Cadena | País seleccionado de la base de datos GEO (Se debe respetar el uso de mayúsculas y minúsculas) |
región | Cadena | Región seleccionada de la base de datos GEO (Se debe respetar el uso de mayúsculas y minúsculas) |
ciudad | Cadena | Ciudad seleccionada de la base de datos GEO (Se debe respetar el uso de mayúsculas y minúsculas) |
isp | Cadena | ISP seleccionado de la base de datos GEO (Se debe respetar el uso de mayúsculas y minúsculas) |
exportar | objeto | Aquí debes especificar el número de direcciones IP de tu lista y el tipo de exportación (números de puerto y formato de archivo). |
puertos | Número | Número de IP (máximo 1000) |
ext | Cadena | Tipo de exportación |
rotación | Número | «rotación: '-1' para que no haya rotación (fija), '0' para rotación por solicitud, de '1' a '3600' para rotación basada en el tiempo en segundos» |
Ejemplo
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
}Respuesta
{
"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
}
]
}Respuestas con error en el cuerpo de la solicitud
{
"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
}
]
}