Подключение Power BI к API ChargeBee

Вопрос или проблема

let
    Source = Json.Document(Web.Contents("https://{COMPANY.NAME}.chargebee.com/api/v2/subscriptions")),
    #"Converted to Table" = Table.FromRecords({Source}),
    #"Expanded list" = Table.ExpandListColumn(#"Converted to Table", "list"),
    #"Expanded list1" = Table.ExpandRecordColumn(#"Expanded list", "list", {"subscription", "customer"})
in
    #"Expanded list1"

Ответ или решение

Подключение Power BI к API ChargeBee: Паттерн Пагинации

Для получения полного набора данных из API ChargeBee, вам необходимо учитывать пагинацию, которую использует этот сервис. Как вы уже заметили, ChargeBee по умолчанию возвращает только 10 записей на запрос. При этом вы можете использовать параметры пагинации, такие как offset, для получения следующих наборов данных. В вашем коде потребуется небольшое изменение, чтобы внедрить логику для итерации через все страницы данных.

Обновленный Код для Пагинации

Предлагаю вам модифицировать ваш код, чтобы включить логику, которая будет выполнять запросы к API до тех пор, пока не будут получены все данные. Вот пример, как это можно реализовать:

let
    // Функция для получения данных с учетом пагинации
    GetSubscriptions = (offset as nullable number) as table =>
    let
        // Создание URL с параметром offset
        Url = "https://{COMPANY.NAME}.chargebee.com/api/v2/subscriptions?limit=100" & (if offset <> null then "&offset=" & Number.ToText(offset) else ""),
        // Получение данных
        Source = Json.Document(Web.Contents(Url)),
        // Преобразование в таблицу
        Records = Source[subscriptions],
        // Конвертация в таблицу
        Result = Table.FromRecords(Records),
        // Возврат результатов
        FinalTable = if Source[next_offset] <> null then 
                        Table.Combine({Result, GetSubscriptions(Source[next_offset])})
                      else 
                        Result
    in
        FinalTable,

    // Вызов функции с начальным значением offset
    AllSubscriptions = GetSubscriptions(null)

in
    AllSubscriptions

Объяснение кода

1. Функция GetSubscriptions: Создает функцию, которая принимает offset как параметр. Это позволяет нам динамически запрашивать данные с различных страниц.

2. URL с параметрами: URL строится с учетом переданного offset, а также с параметром limit, который уменьшает количество запросов, разрешая запрашивать до 100 строк за один раз (значение можно изменять в зависимости от ваших нужд и лимитов API).

3. Проверка наличия следующей страницы: Мы проверяем наличие next_offset в полученных данных. Если он существует, мы производим рекурсивный вызов самой функции для получения следующей страницы данных.

4. Сбор всех данных: Используя Table.Combine, вы объединяете данные с каждой страницы в один итоговый набор.

Заключение

Используя предложенный код, вы сможете получить весь набор данных из ChargeBee без необходимости делать множество ручных запросов. Обратите внимание на документацию ChargeBee и настройки вашего API, чтобы гарантировать, что вы работаете в рамках их лимитов.

При правильной настройке этот подход позволит вам интегрировать полные данные из ChargeBee в Power BI, обеспечивая эффективность и точность ваших отчетов.