Instagram, với nền tảng định hướng hình ảnh của nó, đã trở thành một công cụ mạnh mẽ cho các doanh nghiệp, nhà phát triển và người sáng tạo. Để nâng cao trải nghiệm người dùng và tạo điều kiện cho việc tích hợp liền mạch, Instagram cung cấp hai công cụ thiết yếu: Instagram Graph API và Instagram Basic Display API. Trong bài viết này, chúng tôi sẽ tập trung vào khả năng của Instagram Basic Display API và cách nó có thể được khai thác để tối ưu hóa sự hiện diện của bạn trên Instagram.
Instagram Basic Display API
Instagram Basic Display API là một công cụ được cung cấp bởi Instagram (một công ty con của Facebook) cho phép các nhà phát triển truy cập thông tin cơ bản của người dùng, nội dung phương tiện và các dữ liệu khác từ các tài khoản Instagram. API này được thiết kế đặc biệt cho các tình huống nơi cần truy cập chỉ đọc vào dữ liệu người dùng, phù hợp với các ứng dụng tập trung vào việc hiển thị nội dung Instagram hoặc cung cấp trải nghiệm cá nhân hóa.
Cài đặt trước khi truy cập vào API
Các yêu cầu:
1. Một tài khoản nhà phát triển Facebook.
2. Một tài khoản Instagram thử nghiệm.
3. Một trang web (URL) để chuyển hướng, để cấp quyền cho ứng dụng truy cập Instagram.
Các bước cài đặt:
- Trên trang nhà phát triển, nhấp vào Tạo ứng dụng. Chọn Khác để tiếp tục.
2. chọn khách hàng làm loại ứng dụng cho Instagram basic display API
Tiếp theo, điền thông tin của bạn (Tên ứng dụng, email liên lạc) và tiếp tục
3. Đặt URL nền tảng. Đi đến cài đặt > cơ bản, nhấp vào thêm nền tảng ở phía dưới và nhập URL của bạn (Trang web đã đề cập trong yêu cầu).
4. Thiết lập Instagram Basic API trên bảng điều khiển
Sau khi ứng dụng được tạo, một mẫu sẽ xuất hiện với một số thứ cần được lưu và điền vào.
ID ứng dụng và bí mật sẽ cần sau này.
5. Nhập cùng một URL như trước vào Valid OAuth redirect URI, Deauthorization callback URL và data deletion request vì ứng dụng này dành cho mục đích thử nghiệm.
Thêm người thử nghiệm vào mẫu, ví dụ, nếu Alice muốn lấy thông tin của Bob, thì nhập tên người dùng tài khoản của Bob.
Sau khi thêm một người dùng, trạng thái của người dùng sẽ chờ xử lý vì cần có sự ủy quyền từ người dùng. Khuyến nghị sử dụng tài khoản thử nghiệm.
6. Đăng nhập vào tài khoản Instagram thử nghiệm của bạn, đi đến cài đặt> quyền trang web> Ứng dụng và Trang web> Lời mời thử nghiệm. Chấp nhận lời mời thử nghiệm.
Việc cài đặt cơ bản đã hoàn tất!
Cách yêu cầu ủy quyền?
Mã ủy quyền là cần thiết trước khi sử dụng API, thời gian tồn tại của mã ủy quyền này là 1 giờ. Để lấy mã, nhập URL trong mẫu này:
https://api.instagram.com/oauth/authorize?client_id={app-id}&redirect_uri={redirect-uri}
&scope=user_profile,user_media
&response_type=codeGiải thích cho các thuộc tính:
App-id: ID ứng dụng là app-id, cái này có thể tìm thấy trong chế độ hiển thị cơ bản dưới ứng dụng hiển thị cơ bản của Instagram.
redirect_uri: là cùng một URL như URI chuyển tiếp OAuth hợp lệ.
Nhớ không để khoảng trống cho toàn bộ URL.
Sau khi nhấp vào enter, nó sẽ chuyển đến trang cho phép ủy quyền.
Sau khi cho phép tất cả quyền truy cập, nó sẽ chuyển hướng đến URL của bạn, với tham số mã đính kèm vào URL, trông như
https://www.example.com/?code=ABCD......#_
Mã ủy quyền là cái ở phía sau code=, hãy nhớ xóa #_ vì đây không phải là phần của mã ủy quyền.
Cách sử dụng Apidog để trao đổi mã lấy token truy cập?
Apidog là nền tảng phát triển API tất cả trong một cho phép bạn dễ dàng thiết kế, kiểm tra và tài liệu hóa API của mình. Đối với những ai muốn kiểm tra Instagram API, sử dụng Apidog luôn là giải pháp dễ nhất.
Chuyển đổi mã ủy quyền thành token truy cập
Đổi phương thức thành POST, nhập URL:
https://api.instagram.com/oauth/access_token
Thêm các tham số cần thiết:
- client_id = ID ứng dụng Instagram
- client_secret = bí mật ứng dụng Instagram
- code = Mã ủy quyền đã nhận được
- grant_type = authorization_code (Giá trị này đã được thiết lập)
- redirect_uri = URI của bạn
Nhấp vào gửi, token truy cập sẽ được trả về dưới dạng tệp JSON, trông như:
{
"access_token": "IGQWR9......",
"user_id": 7666070400110123
}Ghi chú: token cũng có giá trị trong 1 giờ
Cách sử dụng token truy cập và ID người dùng để truy vấn thông tin tài khoản?
Có rất nhiều tính năng có thể lấy bằng Instagram Display Basic API, dưới đây là hai ví dụ về việc lấy thông tin.
- truy cập thông tin cơ bản của một tài khoản
Mẫu yêu cầu sử dụng curl:
curl -X GET \ 'https://graph.instagram.com/{user-id}?fields=id,username&access_token={access-token}'Giải thích tham số:
- User_id: lấy từ bước trước
- Access_token: từ bước trước
- Fields: có thể tùy chọn. Có 4 loại thuộc tính có sẵn:
1. Account_type: loại tài khoản
2. Id: user_id
3. Media_count: số lượng bài đăng
4. Username: tên tài khoảnNếu bạn muốn lấy cả bốn cái này, hãy nhập tất cả chúng tách biệt bằng dấu phẩy (,)
Kết quả trả về:
2. Lấy thông tin bài đăng của người dùng
Mẫu yêu cầu:
curl -X GET \
'https://graph.instagram.com/me/media?fields=id,caption&access_token=IGQVJ...'Thiết lập trong Apidog:
Để biết thêm tính năng với Instagram display API, tham khảo:
Kết luận
Tóm lại, Instagram API mở ra một thế giới khả năng cho các nhà phát triển tương tác với nền tảng Instagram và tạo ra các ứng dụng sáng tạo. Từ việc truy cập thông tin người dùng và nội dung phương tiện đến việc đăng tải những bức ảnh và video mới, danh sách các điểm cuối đa dạng cho phép các nhà phát triển điều chỉnh ứng dụng của họ theo nhu cầu cụ thể.