Перейти к содержанию

Баланс и тариф (биллинг)

Получить список всех транзакций в рамках аккаунта

POST /user/billing/transactions/list

Метод возвращает список всех транзакций в рамках аккаунта.

В теле запроса можно использовать стандартные фильтры через массив filters.

curl 'https://cloud.roistat.com/api/v1/user/billing/transactions/list?project=12345' \
    --request POST \
    --header 'Content-type: application/json' \ 
    --header 'Api-key: {KEY}' \ 
    --data Тело запроса - см. ниже

Тело запроса:

{
    "period": {
        "from": "2016-09-01T07:36:00.000Z",
        "to": "2016-09-29T07:36:00.000Z"
    }
}
{
    "data": [
        {
            "date": "2016-09-02T18:59:15+0000",
            "type": "charge",
            "system_name": null,
            "display_name": null,
            "project_id": null,
            "sum": 16.600000000000001,
            "balance": -16.600000000000001,
            "virtual_balance": 0
        },
        {
            "date": "2016-09-26T13:51:29+0000",
            "type": "topup",
            "system_name": "top_up_balance",
            "display_name": "Пополнение баланса",
            "project_id": null,
            "sum": 1000,
            "balance": 691.57000000000005,
            "virtual_balance": 0
        }
    ],
    "status": "success"
}

Строка запроса:

Параметр Тип Описание Обязательный
project string Номер проекта да

Тело запроса:

Параметр Тип Описание Обязательный
period object Период транзакций да
from string Начальная дата транзакций в формате 2016-09-01T07:36:00.000Z да
to string Конечная дата транзакций в формате 2016-09-29T07:36:00.000Z да
Параметр Тип Описание
data array[object]
date string Дата операции
type string Тип операции: charge - списание, topup - пополнение
system_name null или string Системное название операции
display_name null или string Человекочитаемое название операции
project_id null или integer Номер проекта, если операции была применена к проекту
sum integer или number Сумма операции
balance integer или number Реальный баланс аккаунта после совершения операции
virtual_balance integer или number Виртуальный баланс аккаунта (т.е. бонусы от Roistat) после совершения операции
status string

Получить список всех транзакций в рамках аккаунта в формате Excel

POST /user/billing/transactions/list/export/excel

Данный метод аналогичен методу /user/billing/transactions/list, однако в ответ выдается файл Excel со списком транзакций для проекта.

curl 'https://cloud.roistat.com/api/v1/user/billing/transactions/list/export/excel?project=12345' \
    --request POST \
    --header 'Content-type: application/json' \ 
    --header 'Api-key: {KEY}' \ 
    --data Тело запроса - см. ниже

Тело запроса:

{
    "period": {
        "from": "2016-09-01T07:36:00.000Z",
        "to": "2016-09-29T07:36:00.000Z"
    }
}

Файл в формате Excel

Строка запроса:

Параметр Тип Описание Обязательный
project string Номер проекта да

Тело запроса:

Параметр Тип Описание Обязательный
period object Период транзакций да
from string Начальная дата транзакций в формате 2016-09-01T07:36:00.000Z да
to string Конечная дата транзакций в формате 2016-09-29T07:36:00.000Z да

Без параметров.