Créer une liste
Updated:
Objectif :
Paramètres de chemin
Nom | Valeur | Description |
|---|---|---|
Autorisation |
| Votre clé API personnelle |
Corps de la requête
Nom | Type | Description |
|---|---|---|
titre | Chaîne de caractères | Nom de la liste que vous créez |
liste blanche | Chaîne de caractères | Adresses IP pour l'autorisation. Laissez ce champ vide si vous souhaitez vous authentifier à l'aide de vos identifiants de connexion. |
geo | objet | Ajoutez des données géographiques à votre liste (pays, région, ville, FAI) |
pays | Chaîne de caractères | Pays sélectionné dans la base de données GEO (La casse est importante) |
région | Chaîne de caractères | Région sélectionnée dans la base de données GEO (La casse est importante) |
ville | Chaîne de caractères | Ville sélectionnée dans la base de données GEO (La casse est importante) |
isp | Chaîne de caractères | FAI sélectionné dans la base de données GEO (La casse est importante) |
export | objet | Vous indiquez ici le nombre d'adresses IP de votre liste ainsi que le type d'exportation (numéros de port et format de fichier). |
ports | Nombre | Nombre d'IP (1 000 maximum) |
ext | Chaîne de caractères | Type d'exportation |
rotation | Nombre | « rotation : « -1 » pour aucune rotation (Sticky), « 0 » pour une rotation à la demande, « 1 » à « 3600 » pour une rotation temporisée en secondes » |
Exemple
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
}Réponse
{
"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
}
]
}Réponses comportant une erreur dans le corps de la requête
{
"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
}
]
}