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

class InstagramController < ApplicationController CLIENT_ID = ENV['INSTAGRAM_CLIENT_ID'] CLIENT_SECRET = ENV['INSTAGRAM_CLIENT_SECRET'] REDIRECT_URI = ENV['INSTAGRAM_REDIRECT_URI'] def authorize redirect_to "#{authorize_url}?client_id=#{CLIENT_ID}&redirect_uri=#{REDIRECT_URI}&scope=user_profile,user_media&response_type=code" end private def authorize_url "https://api.instagram.com/oauth/authorize" end
end

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

def callback code = params[:code] return unless 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à

def headers { Accept: "application/json" }
end

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

def authorization_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.

class CreateInstagramAccessTokens < ActiveRecord::Migration[6.1] def change create_table :instagram_access_tokens do |t| t.string :access_token t.timestamps end end
end

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_token
if 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: 200 else render json: {"error": "#{res.body}"}, status: res.status end
else render json: {"error": "#{response.body}"}, status: response.status
end

Các hàm private

def get_long_lived_access_token_url
"https://graph.instagram.com/access_token"
end def long_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

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

fetch data

def me 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

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

Fetch data

def media 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

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

Fetch data

 def album_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") end end

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.