GraphQL API позволяет получать текущий баланс проекта и детализацию расходов за выбранный период.
Результат:
Получены баланс проекта, бонусы и детализация списаний по дням.
| productId | Описание |
|---|---|
| 1 | Облачная платформа на базе OpenStack |
| 2 | Объектное хранилище |
| 3 | Облачная платформа на базе VMware |
Важно:
Использование неверного productId приведет к отсутствию данных или некорректному ответу.
Результат:
Выбран корректный продукт для API-запроса.
Важно:
Токен отображается только один раз. Сохраните его сразу.
Результат:
Получен токен для работы с API.
Используйте заголовок:
X-User-Token: <ваш_токен>
Важно:
Использование Authorization: Bearer приведет к ошибке 401.
Результат:
Настроена корректная авторизация.
Необходимо определить:
Для облачных проектов:
productId = 1
Пример:
externalSubscriptionId = 12345
Важно:
Используется именно ID проекта.
Результат:
Подготовлены параметры для выполнения запроса.
Создайте запрос
Метод: POST
URL: https://console.ps.kz/bill/graphql
Добавьте Headers
Content-Type: application/json
X-User-Token: <ваш_токен>
Настройте Body
{
"query": "query { bill { getSubscriptionBalance(externalSubscriptionId: <ВАШ_PROJECT_ID>, productId: 1) { balance bonuses } } }"
}
Нажмите Send
Результат:
Получены баланс и бонусы проекта.
Откройте Playground
Вставьте запрос
query {
bill {
getSubscriptionBalance(
externalSubscriptionId: <ВАШ_PROJECT_ID>,
productId: 1
) {
balance
bonuses
}
}
}
Выполните запрос
Результат:
Получены баланс и бонусы проекта.
Для получения используется метод:
reportSubscriptionConsuming
Параметры:
Формат даты:
YYYY-MM-DDTHH:mm:ss.sssZ
Важно:
Некорректный период приведет к отсутствию данных.
Результат:
Подготовлены параметры для получения расходов.
Создайте запрос
Метод: POST
URL: https://console.ps.kz/bill/graphql
Добавьте Headers
Content-Type: application/json
X-User-Token: <ваш_токен>
Настройте Body
{
"query": "query { bill { reportSubscriptionConsuming(filter: { periodFrom: \"2026-03-04T19:00:00.000Z\", periodTo: \"2026-03-05T19:59:59.999Z\", externalSubscriptionId: <ВАШ_PROJECT_ID>, productId: 1 }) { items { day totalAmount totalBonuses } } } }"
}
Нажмите Send
Результат:
Получена детализация расходов по дням.
Откройте Playground
Вставьте запрос
query {
bill {
reportSubscriptionConsuming(
filter: {
periodFrom: "2026-03-04T19:00:00.000Z"
periodTo: "2026-03-05T19:59:59.999Z"
externalSubscriptionId: <ВАШ_PROJECT_ID>
productId: 1
}
) {
items {
day
totalAmount
totalBonuses
}
}
}
}
Выполните запрос
Результат:
Получена детализация расходов по дням.
Результат:
Баланс и расходы проекта успешно получены через GraphQL API.
