В этом руководстве показано, как узнать, сколько трафика израсходовал residential-пакет и сколько это стоило.
Каждый запрос использует ваш персональный API-ключ из личного кабинета (как получить API-ключ). В примерах ниже замените YOUR_API_KEY на свой ключ. Чтобы оплатить с баланса аккаунта, используйте paymentId = 1.
Шаг 1 — Получите информацию о пакете
Получите статус пакета и остаток трафика. Скопируйте package_key.
Эндпоинт
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/package
Ответ
{
"status": "success",
"data": {
"rotation": 60,
"traffic_limit": "7516192768",
"traffic_usage": "10",
"traffic_left": "10",
"package_key": "1234567890abcdefedcb",
"expired_at": "d.m.Y",
"is_active": true,
"tarif_id": 2
},
"errors": []
}
Шаг 2 — Получите расход трафика
Получите детальный расход трафика по пакету. Можно отфильтровать по логину листа или диапазону дат.
Эндпоинт
POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/traffic/details
Тело запроса
Имя | Тип | Описание |
packageKey | String | Ключ пакета (из информации о пакете). |
login (необязательный) | String | Необязательно: фильтр по логину листа. |
date_start (необязательный) | String | Необязательный фильтр по дате, формат DD.MM.YYYY. |
date_end (необязательный) | String | Необязательный фильтр по дате, формат DD.MM.YYYY. |
Ответ
{
"status": "success",
"data": {
"package_key": "1234567890abcdefedcb",
"traffic_usage": "275414777856",
"traffic_usage_formated": "256.5 GB"
},
"errors": []
}
Шаг 3 — Получите отчёт о расходах
Получите отчёт о расходах: сумма, цена за ГБ и разбивка по листам.
Эндпоинт
POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/consumption
Тело запроса
Имя | Тип | Описание |
login (необязательный) | String | Необязательно: фильтр по логину листа. |
date_start (необязательный) | String | Необязательный фильтр по дате, формат DD.MM.YYYY. |
date_end (необязательный) | String | Необязательный фильтр по дате, формат DD.MM.YYYY. |
Ответ
{
"status": "success",
"data": {
"package_key": "1234567890abcdefedcb",
"orders_amount": "$557.99",
"orders_bytes_formated": "256.5 GB",
"price_per_gb": "$2.17"
},
"errors": []
}