Request Gitlab API

Share:

Description

Request Gitlab API

Usage

1
2
3
4
gitlab(req, api_root, verb = httr::GET, auto_format = TRUE, debug = FALSE,
  gitlab_con = "default", page = "all", enforce_api_root = TRUE,
  argname_verb = if (identical(verb, httr::GET) | identical(verb,
  httr::DELETE)) {     "query" } else {     "body" }, ...)

Arguments

req

vector of characters that represents the call (e.g. c("projects", project_id, "events"))

api_root

URL where the gitlab API to request resides (e.g. https://gitlab.myserver.com/api/v3/)

verb

http verb to use for request in form of one of the httr functions GET, PUT, POST, DELETE

auto_format

whether to format the returned object automatically to a flat data.frame

debug

if TRUE API URL and query will be printed, defaults to FALSE

gitlab_con

function to use for issuing API requests (e.g. as returned by gitlab_connection

page

number of page of API response to get; if "all" (default), all pages are queried successively and combined.

enforce_api_root

if multiple pages are requested, the API root URL is ensured to be the same as in the original call for all calls using the "next page" URL returned by gitlab. This makes sense for security and in cases where gitlab is behind a reverse proxy and ignorant about its URL from external.

argname_verb

name of the argument of the verb that fields and information are passed on to

...

named parameters to pass on to gitlab API (technically: modifies query parameters of request URL), may include private_token and all other parameters as documented for the Gitlab API