如何在R Plumber中设置id为数值类型且非必填？

我懂你的需求——想用Plumber搭建API，让id参数是整数类型，但又不想把它设为必填项。确实，当你在路径里用<id:int>时，Plumber会默认把这个参数标记为必填，毕竟路径参数是URL的一部分，必须存在才能匹配到对应的路由。

这里有两种实用的解决方案，你可以根据自己的API设计偏好来选：

方案1：使用查询参数（推荐） #

查询参数本身就是可选的，我们可以在这里指定类型，并通过代码验证传入值是否为有效整数：

#* 获取数据，支持可选的整数ID筛选
#* @param id Unique ID（可选，需为整数类型，默认值为NULL）
#* @get /data
function(id = NULL) {
  # 如果用户传入了id，先验证它是否为有效整数
  if (!is.null(id)) {
    id <- as.integer(id)
    if (is.na(id)) {
      stop("参数id必须是有效的整数")
    }
  }
  
  # 业务逻辑示例：根据是否传入id返回对应数据
  if (is.null(id)) {
    list(status = "success", data = "返回所有数据")
  } else {
    list(status = "success", data = paste("返回ID为", id, "的数据"))
  }
}

用户可以通过两种方式调用这个API：

• 不带id：GET /data
• 带整数id：GET /data?id=5

方案2：设置双路由（保留路径参数形式） #

如果你坚持要用路径参数的形式，可以创建两个路由：一个带必填的整数id，一个不带id（返回全部数据）：

#* 返回所有数据
#* @get /data
function() {
  list(status = "success", data = "返回所有数据")
}

#* 根据整数ID返回对应数据
#* @param id Unique ID
#* @get /data/<id:int>
function(id) {
  list(status = "success", data = paste("返回ID为", id, "的数据"))
}

这样用户可以选择调用GET /data（无id）或者GET /data/5（带整数id），两种请求都会被正确处理。

补充说明 #

Plumber的路径参数（比如<id:int>）之所以会被设为必填，是因为URL路径的结构要求这部分必须存在才能匹配对应的路由。所以如果要实现「可选的整数参数」，查询参数是更符合RESTful设计的方式；而双路由方案则能满足你保留路径参数形式的需求。

内容的提问来源于stack exchange，提问作者thmschk