Instagram Basic API – Demo with Ruby on Rails

Trong bài trước mình có giới thiệu về Instagram Basic API trong việc lấy các thông tin của người dùng. Bài này sẽ là một bản demo nho nhỏ cho api này.

I. Authorize action

Đầu tiên, mình demo 1 route để redirect người dùng tới api xin cấp quyền của api.instagram.com

Thêm route

Rails.application.routes.draw do
  get 'authorize', to:"instagram#authorize"end

Thêm authorize action trong controller

classInstagramController<ApplicationControllerCLIENT_ID=ENV['INSTAGRAM_CLIENT_ID']CLIENT_SECRET=ENV['INSTAGRAM_CLIENT_SECRET']REDIRECT_URI=ENV['INSTAGRAM_REDIRECT_URI']defauthorize
    redirect_to "#{authorize_url}?client_id=#{CLIENT_ID}&redirect_uri=#{REDIRECT_URI}&scope=user_profile,user_media&response_type=code"endprivatedefauthorize_url"https://api.instagram.com/oauth/authorize"endend

Sau khi người dùng truy cập tới https://localhost:3000/authorize sẽ được điều hướng tới api cấp quyền của instagram

OK, vậy là api này đã xong.

II. Callback action

Sau khi người dùng cấp quyền, instagram sẽ điều hướng về redirect_uri kèm theo authorization code, do đó ta cần có 1 route xử lý code gửi về và lấy access_token.

Thêm route

get 'callback', to:"instagram#callback"

Đầu tiên, api này sẽ nhận 1 params là code

defcallback
    code = params[:code]returnunless code
end

Sử dụng code này, ta sẽ cần gửi 1 request post tới https://api.instagram.com/oauth/access_token để lấy access_token

response =Faraday.post(get_access_token_url)do|req|
  req.headers = headers,
  req.body = authorization_params(authorization_code)end

Trong đó, headers sẽ là

defheaders{Accept:"application/json"}end

Các params cần gửi lên

defauthorization_params{
      client_id:CLIENT_ID,
      client_secret:CLIENT_SECRET,
      code: authorization_code,
      grant_type:"authorization_code",
      redirect_uri:REDIRECT_URI}end

Response trả về sẽ chứa access token. Ta sẽ lưu lại giá trị này vào trong database. Trước tiên cần khởi tạo một model cho nó. Ở đây mình demo với 1 user nên sẽ không sử dụng user_id và chỉ tạo model đơn giản nhất.

classCreateInstagramAccessTokens<ActiveRecord::Migration[6.1]defchange
    create_table :instagram_access_tokensdo|t|
      t.string :access_token

      t.timestamps
    endendend

Lấy giá trị access_token

data =JSON.parse(response.body)

access_token = data["access_token"]

Ở đây, ta đã có 1 access_token có thể sử dụng được. Tuy nhiên, để có thể sử dụng lâu dài, ta cần chuyển đổi giá trị token sang một token dài hạn nữa.

# exchange access_token for a long-lived access_tokenif access_token
  res =Faraday.get(get_long_lived_access_token_url)do|req|
    req.headers = headers,
    req.params = long_lived_access_token_params(authorization_code)end

  long_lived_data =JSON.parse(response.body)

  long_lived_access_token = long_lived_data["access_token"]if long_lived_access_token
    InstagramAccessToken.create(
      access_token: long_lived_access_token
    )
    render json:{"message":"ok"}, status:200else
    render json:{"error":"#{res.body}"}, status: res.status
  endelse
  render json:{"error":"#{response.body}"}, status: response.status
end

Các hàm private

defget_long_lived_access_token_url"https://graph.instagram.com/access_token"enddeflong_lived_access_token_params access_token
    {
      grant_type:"ig_exchange_token",
      client_secret:CLIENT_SECRET,
      access_token: access_token
    }end

OK, vậy là ta đã có được access_token để có thể sử dụng cho việc lấy dữ liệu từ Basic Display API rồi.

III. Lấy dữ liệu

Ở đây mình sẽ chỉ demo nhỏ việc sử dụng access token trên để fetch data về.

1. Get user data

Add route

get 'me', to:"instagram#me"

Params

defuser_params{
      fields:"id,username,account_type,media_count",
      access_token: access_token
    }end

fetch data

defme
    response =Faraday.get("#{graph_base_url}/me")do|req|
      req.headers = headers,
      req.params = user_params
    end

    render json: response.body
end

Kết quả

2. Get user’s media

Add route

get 'me/media', to:"instagram#media"

Params

defmedia_params{
      fields:"id,caption,media_type,media_url,permalink,thumbnail_url,timestamp,username",
      access_token: access_token
    }end

Fetch data

defmedia
    response =Faraday.get("#{graph_base_url}/me/media")do|req|
      req.headers = headers,
      req.params = media_params
    end

    render json: response.body
end

3. Get album’s media

Add route

get 'album', to:"instagram#album_media"

Params

defalbum_media_params{
      fields:"id,media_type,media_url,thumbnail_url",
      access_token: access_token
    }end

Fetch data

defalbum_media
    album_id = params[:id]if album_id
      response =Faraday.get("#{graph_base_url}/#{album_id}/children")do|req|
        req.headers = headers,
        req.params = album_media_params
      end
  
      render json: response.body
    else
      render(json:"Missing parameter id")endend

Kết quả

IV. Kết luận

Ở bài này mình chỉ demo nho nhỏ về Instagram Basic Display API. API này còn có thể dùng với nhiều ứng dụng khác nữa và phần demo còn có thể phát triển rất nhiều.