当你点击一个按钮/链接时，它通常会发送一个html请求，由Accept头定义：

def show
  puts request.headers["Accept"]
  # => "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7"
  #     ^^^^^^^^^
  #     it's an html request. it's up to you (and rails) to respond with html
  #     or ignore it and render something else.
end

默认情况下，Rails 将呈现show.html.erb模板，并将Content-Type标头设置为text/html。
然后添加show.json.jbuilder，现在可以请求 json 响应而不是 html：

// with javascript
fetch("/models/1" , { headers: { Accept: "application/json" } })
  .then(response => response.json())
  .then(json => console.log(json)) // do something with the response

// and in controller you can see
// request.headers["Accept"] # => "application/json"

这是一个 json 请求，因此rails将呈现一个 json 模板。

• Rails* 还提供了一种不使用头来呈现特定响应的方法，只需在url中添加.json即可，本例中Accept: text/html被Rails忽略，它将呈现一个json模板。

我不记得rails中有任何内部/外部API的概念，只有请求和响应。
如果需要在控制器中添加更多逻辑来处理不同类型的请求，请使用respond_to方法：

def show
  respond_to do |format|
    format.html { render :different_template }
    format.json { render json: {error: "i'm not an api."} }
  end
end