来源：https://ruby-china.org/topics/25822

1、创建新项目

　　rails new api_demo

2、生成控制器:

　　# 我们不需要生成资源文件
　　$ bundle exe rails g controller api/v1/base --no-assets

　　app/controllers/api/v1/base_controller.rb,

　　class Api::V1::BaseController < ApplicationController
　　  # disable the CSRF token
 　　 protect_from_forgery with: :null_session

 　　 # disable cookies (no set-cookies header in response)
 　　 before_action :destroy_session

  　　# disable the CSRF token
 　　 skip_before_action :verify_authenticity_token
　　
　　  def destroy_session
  　　  request.session_options[:skip] = true
  　　end
　　end
3、配置路由

　　config/routes.rb,

　　namespace :api do
　　  namespace :v1 do
  　　  resources :users, only: [:index, :create, :show, :update, :destroy]
 　　   # 原文有 microposts, 我们现在把它注释掉
  　　  # resources :microposts, only: [:index, :create, :show, :update, :destroy]
　　  end
　　end
4、生成控制器:

　　# 我们不需要生成资源文件
　　$ bundle exe rails g controller api/v1/users --no-assets

　　app/controllers/api/v1/users_controller.rb,

　　class Api::V1::UsersController < Api::V1::BaseController
　　  def show
 　　   @user = User.find(params[:id])

 　　   # 原文使用 Api::V1::UserSerializer
  　　  # 我们现在使用 app/views/api/v1/users/show.json.jbuilder
  　　  # render(json: Api::V1::UserSerializer.new(user).to_json)
 　　 end
　　end

　　app/views/api/v1/users/show.json.jbuilder,

　　json.user do
　　  json.(@user, :id, :email, :name,  :activated, :admin, :created_at, :updated_at)
　　end
5、User 模型和 users 表

　　$ bundle exe rails g model User

　　app/models/user.rb,

　　class User < ActiveRecord::Base
　　end

　　db/migrate/20150502072954_create_users.rb,

　　class CreateUsers < ActiveRecord::Migration
　　  def change
  　　  create_table :users do |t|
    　　  t.string :email
    　　  t.string :name
    　　  t.datetime :activated
     　　 t.boolean :admin, default: false
    　　  t.timestamps null: false
   　　 end
  　　end
　　end

6、数据迁移:

　　$ bundle exe rake db:migrate

　　种子数据:

　　db/seeds.rb,

　　users = User.create([
                    　　 {
                     　　  email: 'test-user-00@mail.com',
                     　　  name: 'test-user-00',
                      　　 activated: DateTime.now,
                      　　 admin: false
                   　　  },
                    　　 {
                     　　  email: 'test-user-01@mail.com',
                     　　  name: 'test-user-01',
                     　　  activated: DateTime.now,
                     　　  admin: false
                    　　 }
                   　　 ])

　　创建种子数据:

　　$ bundle exe rake db:seed
7、现在我们可以测试一下 api 是否正常工作, 我们可以先查看下相关 api 的路由,

$ bundle exe rake routes

输出:

      Prefix Verb   URI Pattern                      Controller#Action
api_v1_users GET    /api/v1/users(.:format)          api/v1/users#index
             POST   /api/v1/users(.:format)          api/v1/users#create
 api_v1_user GET    /api/v1/users/:id(.:format)      api/v1/users#show
             PATCH  /api/v1/users/:id(.:format)      api/v1/users#update
             PUT    /api/v1/users/:id(.:format)      api/v1/users#update
             DELETE /api/v1/users/:id(.:format)      api/v1/users#destroy

启动 rails 服务,

$ bundle exe rails s

使用 curl 请求 api,

$ curl -i http://localhost:3000/api/v1/users/1.json

1、增加认证(Authentication)

　　认证的过程是这样的: 用户把她的用户名和密码通过 HTTP POST 请求发送到我们的 API (在这里我们使用 sessions 端点来处理这个请求), 如果用户名和密码匹配，我们 会把 token 发送给用户。 这个 token 就是用来证明用户身份的凭证。然后在以后的每个请求中，我们都通过这个 token 来查找用户，如果没有找到用户则返回 401 错误。

2、给 User 模型增加 authentication_token 属性

　　$ bundle exe rails g migration add_authentication_token_to_users

　　db/migrate/20150502123451_add_authentication_token_to_users.rb

　　class AddAuthenticationTokenToUsers < ActiveRecord::Migration
 　　 def change
   　　 add_column :users, :authentication_token, :string
 　　 end
　　end

　　$ bundle exe rake db:migrate

3、生成 authentication_token

　　app/models/user.rb,

　　class User < ActiveRecord::Base

 　　　before_create :generate_authentication_token

   　　def generate_authentication_token
      　　loop do
      　　　self.authentication_token = SecureRandom.base64(64)
     　　　 break if !User.find_by(authentication_token: authentication_token)
    　　　end
  　　end

  　　def reset_auth_token!
   　　 generate_authentication_token
   　　 save
 　　 end
　　end

最后注意的是：rails 5 中就可以弃用 gem 'jbuilder'，这样就可以不必创建views文件，直接在apicontroller中直接render json数据流；