Ce guide explique comment acheter de nouveaux proxys via l'API, à partir de zéro : vérifier la disponibilité, calculer le prix, passer la commande et récupérer les IP achetées.
Chaque requête utilise votre clé API personnelle depuis le tableau de bord de votre compte (comment obtenir votre clé API). Dans les exemples ci-dessous, remplacez YOUR_API_KEY par votre propre clé. Pour payer avec le solde de votre compte, utilisez paymentId = 1.
⚠️ L'étape de commande débite votre solde. Vérifiez toujours d'abord le coût à l'étape de calcul.
Le déroulement en un coup d'œil
Vérifiez votre solde.
Voyez ce qui peut être commandé (pays, période).
Choisissez un moyen de paiement (ou utilisez votre solde).
Calculez le prix.
Passez la commande.
Récupérez les proxys achetés.
Étape 1 — Vérifiez votre solde
Assurez-vous d'avoir un solde suffisant pour l'achat.
Endpoint
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/balance/get
Réponse
{
"status": "success",
"data": { "summ": 10 },
"errors": []
}
Étape 2 — Voyez ce qui peut être commandé
La Reference List renvoie tout ce qu'il faut pour commander : pays, périodes, cibles, opérateurs et rotations (pour mobile). Copiez le countryId et le periodId nécessaires.
Endpoint
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/reference/list/{type}
Paramètres de chemin
Nom | Valeur | Description |
type |
| Le type de proxy (ipv4, ipv6, mobile, isp, mix, mix_isp). |
Exemple
https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/reference/list/ipv4
Réponse
{
"status": "success",
"data": {
"items": [
{
"country": [ { "id": 561, "name": "France", "alpha3": "FRA" } ],
"period": [ { "id": "1m", "name": "1 month" } ]
}
]
},
"errors": []
}
Étape 3 — Choisissez un moyen de paiement
Listez les systèmes de paiement disponibles et copiez l'id souhaité comme paymentId. Pour payer avec le solde, utilisez simplement paymentId = 1.
Endpoint
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/balance/payments/list
Réponse
{
"status": "success",
"data": {
"items": [
{ "id": "30", "name": "Visa / MasterCard" },
{ "id": "41", "name": "USDT (TRC-20)" },
{ "id": "29", "name": "PayPal" },
{ "id": "35", "name": "Binance" }
]
},
"errors": []
}
Étape 4 — Calculez le prix
Calculez le prix de la commande avant l'achat. Les remises sur volume et durée s'appliquent comme sur le site. Cette étape ne débite rien.
Les champs du corps dépendent du type de proxy. Les champs communs sont ci-dessous ; pour IPv6, passez aussi protocol, pour mobile operatorId + rotationId, pour résidentiel tarifId — le tout depuis la Reference List.
Endpoint
POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/order/calc
Corps de la requête
Nom | Type | Description |
countryId | Number | ID du pays issu de la Reference List (étape 2). |
periodId | String | ID de la période de location issu de la Reference List. |
quantity | Number | Le nombre de proxys à commander. |
paymentId | Number | ID du système de paiement. |
coupon (optionnel) | String | Un code promo, si vous en avez un. |
authorization (optionnel) | String | Méthode d'autorisation. Laissez vide pour utiliser identifiant:mot de passe. |
customTargetName (optionnel) | String | Un nom de cible personnalisé, si nécessaire. |
Exemple
https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/order/calc
Réponse — shows the total, your balance, the discount and the per-proxy price:
{
"status": "success",
"data": {
"warning": "",
"balance": 2000,
"total": 9,
"quantity": 5,
"currency": "USD",
"discount": 0.45,
"price": 1.8
},
"errors": []
}
Étape 5 — Passez la commande (débite votre solde)
Lorsque le prix calculé vous convient, passez la commande. Cette étape débite votre solde. Utilisez les mêmes paramètres qu'à l'étape 4. Copiez l'orderId depuis la réponse.
Endpoint
POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/order/make
Corps de la requête
Nom | Type | Description |
countryId | Number | ID du pays issu de la Reference List (étape 2). |
periodId | String | ID de la période de location issu de la Reference List. |
quantity | Number | Le nombre de proxys à commander. |
paymentId | Number | ID du système de paiement. |
coupon (optionnel) | String | Un code promo, si vous en avez un. |
authorization (optionnel) | String | Méthode d'autorisation. Laissez vide pour utiliser identifiant:mot de passe. |
generateAuth (optionnel) | String | Y/N — créer une autorisation personnalisée (défaut N). |
Exemple
https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/order/make
Réponse — returns the new order ID and your updated balance:
{
"status": "success",
"data": {
"orderId": 2426273,
"total": 16.2,
"listBaseOrderNumbers": [ "3388485_57471911" ],
"balance": 1776.88
},
"errors": []
}
Étape 6 — Récupérez les proxys achetés
Récupérez les proxys achetés. Filtrez par l'orderId de l'étape précédente pour voir exactement ce qui a été acheté.
Endpoint
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/proxy/list/{type}
Réponse
{
"status": "success",
"data": {
"items": [
{
"id": "0678564",
"order_id": "123456",
"ip": "31.6.33.97",
"protocol": "HTTP",
"port_http": 12345,
"port_socks": 12345,
"login": "ruht5734hg",
"password": "gou5h437g",
"country": "Belgium",
"country_alpha3": "BEL",
"status_type": "ACTIVE",
"date_start": "23.06.2024",
"date_end": "23.07.2024"
}
]
},
"errors": []
}
Référence API complète
Order actions — liste de référence, calcul et commande
Retrieve active proxy — lister vos proxys
Balance — solde et systèmes de paiement