Calcular un pedido
Actualizado:
Devuelve el precio del pedido antes de pasar por caja, incluyendo descuento, comprobación de saldo y advertencias. Llame siempre a esta opción antes deCrear un pedidopara aflorar los problemas de validación sin gastar saldo.
Punto final:
Parámetros de la ruta
Nombre | Tipo | Descripción |
|---|---|---|
apiKey* | Cadena | Su clave personal de API. |
Cuerpo de la solicitud
Nombre | Tipo | Descripción |
|---|---|---|
| cadena | Para qué tipo de proxy calcular.
|
| número | Número de direcciones IP a pedir. |
| número | Duración del alquiler en días. Obtener valores válidos dePeríodo de alquiler. |
| cadena | Código ISO 3166-1 alfa-3 (por ejemplo, EE.UU.). Obtener valores válidos dePaís. |
| cadena | Etiqueta de meta personalizada para el pedido. |
| cadena | Código promocional de descuento. Obtenga valores válidos a partir deCódigos promocionales. |
Campos adicionales cuandoproxyType=MOBILE
Nombre | Tipo | Descripción |
|---|---|---|
rotationTime* | número | Intervalo de rotación en segundos. Obtener valores válidos deOperador de telefonía móvil. |
mobileOperator* | cadena | Etiqueta de operador. Obtener valores válidos deOperador de telefonía móvil. |
Ejemplos
curl -X POST https://youproxy.io/client/api/v1/$KEY/calculate/order \
-H "Content-Type: application/json" \
-d '{
"proxyType": "IPv4",
"quantity": 5,
"rentPeriodDays": 30,
"country": "USA",
"goal": "scraping",
"promoCode": "SAVE10"
}'curl -X POST https://youproxy.io/client/api/v1/$KEY/calculate/order \
-H "Content-Type: application/json" \
-d '{
"proxyType": "IPv6",
"quantity": 5,
"rentPeriodDays": 30,
"country": "USA",
"goal": "scraping",
"promoCode": "SAVE10"
}'# MOBILE — note the extra fields
curl -X POST https://youproxy.io/client/api/v1/$KEY/calculate/order \
-H "Content-Type: application/json" \
-d '{
"proxyType": "MOBILE",
"quantity": 5,
"rentPeriodDays": 30,
"country": "USA",
"goal": "scraping",
"rotationTime": 300,
"mobileOperator": "verizon"
}'curl -X POST https://youproxy.io/client/api/v1/$KEY/calculate/order \
-H "Content-Type: application/json" \
-d '{
"proxyType": "ISP",
"quantity": 5,
"rentPeriodDays": 30,
"country": "USA",
"goal": "scraping",
"promoCode": "SAVE10"
}'Respuesta
{
"success": true,
"proxyType": "IPv4",
"balance": 7.18,
"price": 1.31,
"currency": "USD",
"discount": 0,
"promoCodeStatus": null,
"error": null,
"warnings": null
}Si hay advertencias, no se ejecutará la orden con los datos actuales.
{
"success": true,
"proxyType": "IPv4",
"balance": 7.18,
"price": 22.61,
"currency": "USD",
"discount": 0,
"promoCodeStatus": null,
"error": null,
"warnings": [
{
"code": 14,
"message": "Incorrect goal"
},
{
"code": 16,
"message": "Insufficient funds on balance"
}
]
}{
"success": true,
"proxyType": "IPv4",
"balance": 7.18,
"price": 1.18,
"currency": "USD",
"discount": 10,
"promoCodeStatus": "VALID",
"error": null,
"warnings": null
}{
"success": true,
"proxyType": "IPv4",
"balance": 7.18,
"price": 1.31,
"currency": "USD",
"discount": 0,
"promoCodeStatus": "NO_VALID",
"error": null,
"warnings": null
}{
"success": false,
"proxyType": null,
"balance": 7.18,
"price": null,
"currency": "USD",
"discount": null,
"promoCodeStatus": null,
"error": {
"code": 4,
"message": "Incorrect proxy type"
},
"warnings": null
}Campos de respuesta
Campo | Tipo | Descripción |
|---|---|---|
| booleano |
|
| cadena | null | Se hace eco del tipo solicitado. |
| número | Saldo de la cuenta en |
| número | null | Total calculado. |
| cadena | Código de moneda ISO (por ejemplo, USD). |
| número | null | Porcentaje de descuento aplicado (por ejemplo, 10 significa 10%). |
| cadena | null |
|
| array | null | Problemas de no bloqueo. Si se produce, la orden no se procesa con los datos actuales. |
| objeto | null |
|