brapi_get_call function

Internal Function for Core BrAPI GET Calls

Internal Function for Core BrAPI GET Calls

Fetches data from an API endpoint, handles pagination by retrieving all pages, and consolidates the results into a single data frame.

brapi_get_call(call_url, nested = TRUE)

Arguments

  • call_url: Character string specifying the base URL of the API endpoint to request.
  • nested: Logical value indicating whether to flatten nested lists in the JSON responses. Defaults to TRUE.

Returns

A list containing the consolidated data and associated metadata from the API response.

Details

This function performs the following steps:

  1. Fetches the first page synchronously to determine the total number of pages.
  2. If multiple pages exist, it asynchronously fetches the remaining pages using get_async_pages().
  3. Consolidates the data from all pages into a single data frame.
  4. Updates global state variables with pagination information.

It relies on global variables from qbms_globals to manage state and configuration.

Author(s)

Khaled Al-Shamaa, k.el-shamaa@cgiar.org

  • Maintainer: Khaled Al-Shamaa
  • License: GPL (>= 3)
  • Last published: 2024-09-18