R/mlb_jobs_datacasters.R

In baseballr: Acquiring and Analyzing Baseball Data

#' @title **MLB Jobs Datacasters** 
#' @param sport_id Return information for a given sport_id. 
#' @param date Return information for a given date. 
#' @return Returns a tibble with the following columns
#'  |col_name         |types     |
#'  |:----------------|:---------|
#'  |jersey_number    |character |
#'  |job              |character |
#'  |job_code         |character |
#'  |title            |character |
#'  |person_id        |integer   |
#'  |person_full_name |character |
#'  |person_link      |character |
#' @export
#' @examples \donttest{
#'   try(mlb_jobs_datacasters(sport_id=1))
#' }
mlb_jobs_datacasters <- function(
  sport_id = NULL,
  date = NULL){
  
  tryCatch(
    expr = {
      mlb_endpoint <- mlb_stats_endpoint("v1/jobs/datacasters")
      query_params <- list(
        sportId = sport_id,
        date = date
      )
      
      mlb_endpoint <- httr::modify_url(mlb_endpoint, query = query_params)
      
      resp <- mlb_endpoint %>% 
        mlb_api_call()
      jobs <- jsonlite::fromJSON(jsonlite::toJSON(resp$roster), flatten = TRUE)  %>% 
        janitor::clean_names() %>% 
        as.data.frame() %>% 
        dplyr::rename(
          "job_code" = "job_id") %>%
        make_baseballr_data("MLB Jobs Datacasters data from MLB.com",Sys.time())
    },
    error = function(e) {
      message(glue::glue("{Sys.time()}: Invalid arguments provided"))
    },
    finally = {
    }
  )
  
  return(jobs)
}