"I love An API Generator for R • plumber"

2022-05-07 12:11:15

Skip to content plumber 1.1.0.9000 Reference Articles Introduction Quickstart Routing & Input Rendering Output Runtime Security Hosting Programmatic Usage Annotations reference Tips & Tricks Migration Guide News Releases Version 1.1.0 Changelog plumber Plumber allows you to create a web API by merely decorating your existing R source code with roxygen2-like comments. Take a look at an example.# plumber.R#* Echo back the input#* @param msg The message to echo#* @get /echofunction(msg="") { list(msg = paste0("The message is: '", msg, "'"))}#* Plot a histogram#* @serializer png#* @get /plotfunction() { rand % pr_run(port=8000)You can visit this URL using a browser or a terminal to run your R function and get the results. For instance http://localhost:8000/plot will show you a histogram, and http://localhost:8000/echo?msg=hello will echo back the ‘hello’ message you provided.Here we’re using curl via a Mac/Linux terminal.$ curl "http://localhost:8000/echo" {"msg":["The message is: ''"]}$ curl "http://localhost:8000/echo?msg=hello" {"msg":["The message is: 'hello'"]}As you might have guessed, the request’s query string parameters are forwarded to the R function as arguments (as character strings).$ curl --data "a=4&b=3" "http://localhost:8000/sum" [7]You can also send your data as JSON:$ curl -H "Content-Type: application/json" --data '{"a":4, "b":5}' http://localhost:8000/sum [9]InstallationYou can install the latest stable version from CRAN using the following command:install.packages("plumber")If you want to try out the latest development version, you can install it from GitHub.remotes::install_github("rstudio/plumber")library(plumber)Cheat SheetHostingIf you’re just getting started with hosting cloud servers, the DigitalOcean integration included in plumber will be the best way to get started. You’ll be able to get a server hosting your custom API in just two R commands. To deploy to DigitalOcean, check out the plumber companion package plumberDeploy.RStudio Connect is a commercial publishing platform that enables R developers to easily publish a variety of R content types, including Plumber APIs. Additional documentation is available at https://www.rplumber.io/articles/hosting.html#rstudio-connect-1.A couple of other approaches to hosting plumber are also made available:PM2 - https://www.rplumber.io/articles/hosting.html#pm2-1Docker - https://www.rplumber.io/articles/hosting.html#docker-basic- ## Related ProjectsOpenCPU - A server designed for hosting R APIs with an eye towards scientific research.jug - (development discontinued) an R package similar to Plumber but uses a more programmatic approach to constructing the API. LinksView on CRANBrowse source codeReport a bugLicenseMIT + file LICENSECommunityContributing guideCitationCiting plumberDevelopersBarret Schloerke Maintainer, author Jeff Allen Author, conceptor RStudio Copyright holder, funder More about authors...Dev status Developed by Barret Schloerke, Jeff Allen, RStudio. Site built with pkgdown 2.0.2.