Tổng quan

API Instagram Basic Display là một API dựa trên HTTP mà ứng dụng có thể dùng để lấy trang cá nhân, hình ảnh, video và album của người dùng Instagram.

Thành phần

URL cơ sở

• api.instagram.com - để lấy Mã truy cập dành cho người dùng Instagram
• graph.instagram.com - để lấy trang cá nhân và file phương tiện của người dùng Instagram

Phiên bản

API này hỗ trợ giao thức lập phiên bản và chu kỳ phát hành giống với API Đồ thị của Facebook. Các phiên bản mới được phát hành khoảng 3 tháng một lần và mỗi phiên bản sẽ hoạt động trong khoảng 2 năm trước khi ngừng hoạt động.

Để truy vấn một phiên bản API cụ thể, hãy thêm số phiên bản vào đường dẫn truy vấn sau URL cơ sở. Ví dụ:

https://graph.instagram.com/v11.0/10218560180051171/media

Nếu bạn không thêm số phiên bản trong yêu cầu của mình, yêu cầu đó sẽ sử dụng phiên bản được chỉ định trong phần Bảng điều khiển ứng dụng > Cài đặt > Nâng cao > Nâng cấp phiên bản API.

Cửa sổ ủy quyền

Với Cửa sổ ủy quyền, ứng dụng của bạn có thể lấy Mã ủy quyền và quyền từ người dùng ứng dụng. Bạn có thể đổi Mã ủy quyền lấy Mã truy cập dành cho Người dùng Instagram (cần dùng khi truy vấn trang cá nhân của người dùng ứng dụng hoặc file phương tiện của họ).

Để triển khai Cửa sổ ủy quyền, hãy tham khảo hướng dẫn Lấy mã truy cập của chúng tôi.

Mã ủy quyền

Bạn có thể đổi Mã ủy quyền lấy Mã truy cập dành cho Người dùng Instagram có thời hạn ngắn. Để lấy Mã ủy quyền, hãy triển khai Cửa sổ ủy quyền trong ứng dụng của bạn. Sau khi người dùng ứng dụng xác thực danh tính của mình thông qua cửa sổ đó và cấp mọi quyền cần thiết cho ứng dụng của bạn, chúng tôi sẽ chuyển hướng người dùng này đến ứng dụng của bạn kèm theo Mã ủy quyền. Sau đó, bạn có thể sử dụng API để đổi mã này lấy Mã truy cập dành cho Người dùng Instagram có thời hạn ngắn từ người dùng ứng dụng.

Mã ủy quyền là mã ngắn hạn và chỉ có hiệu lực trong 1 giờ.

Mã truy cập dành cho Người dùng Instagram

Quy trình xác thực API được xử lý bằng Mã truy cập dành cho Người dùng Instagram tuân thủ giao thức OAuth 2.0. Mã truy cập là mã trong ứng dụng (duy nhất cho cặp ứng dụng và người dùng) và có thể ngắn hạn hoặc dài hạn. Các yêu cầu API truy vấn người dùng Instagram hoặc file phương tiện của họ phải bao gồm Mã truy cập dành cho Người dùng Instagram.

Mã truy cập ngắn hạn

Mã truy cập ngắn hạn có hiệu lực trong 1 giờ nhưng bạn có thể đổi lấy mã dài hạn. Để lấy mã truy cập ngắn hạn, hãy triển khai Cửa sổ ủy quyền trong ứng dụng của bạn. Sau khi người dùng ứng dụng xác thực danh tính thông qua cửa sổ đó, chúng tôi sẽ chuyển hướng người dùng này trở lại ứng dụng của bạn kèm theo Mã ủy quyền. Bạn có thể dùng mã này để đổi lấy mã truy cập ngắn hạn.

Mã truy cập dài hạn

Bạn có thể đổi mã truy cập ngắn hạn chưa hết hạn lấy mã truy cập dài hạn (có hiệu lực trong 60 ngày). Bạn có thể làm mới mã truy cập dài hạn trước khi mã này hết hạn bằng cách truy vấn điểm cuối GET /refresh_access_token.

Quyền

Việc ủy quyền truy cập dữ liệu được người dùng ứng dụng của bạn kiểm soát thông qua quá trình sử dụng các quyền liệt kê bên dưới. Người dùng phải cấp cho ứng dụng của bạn các quyền này thông qua Cửa sổ ủy quyền thì ứng dụng mới có thể truy cập vào dữ liệu của họ.

• instagram_graph_user_profile - cho phép ứng dụng đọc nút Người dùng (biểu thị người dùng Instagram) và các cạnh của nút đó.
• instagram_graph_user_media - cho phép ứng dụng đọc nút File phương tiện (biểu thị hình ảnh, video hoặc album) và các cạnh của nút đó.

Người dùng thử Instagram có thể cấp cho ứng dụng các quyền này bất cứ lúc nào. Để người dùng không có vai trò trên ứng dụng có thể cấp cho ứng dụng các quyền này, trước tiên, mỗi quyền phải được phê duyệt Quyền truy cập nâng cao thông qua quy trình Xét duyệt ứng dụng và ứng dụng của bạn phải ở chế độ Chính thức.

Các quyền do người dùng ứng dụng cấp bằng tài khoản công khai sẽ có hiệu lực trong 90 ngày. Việc làm mớimã truy cập dài hạn của người dùng ứng dụng sẽ kéo dài thời gian cấp quyền thêm 90 ngày nếu người dùng ứng dụng đã cấp mã có tài khoản công khai. Tuy nhiên, nếu tài khoản của người dùng ứng dụng là riêng tư, bạn không thể kéo dài thời gian cấp quyền và người dùng ứng dụng phải cấp lại quyền đã hết hạn cho ứng dụng của bạn.

Người dùng thử Instagram

Để thử nghiệm ứng dụng với Người dùng Instagram, trước tiên, bạn phải gửi lời mời đến tài khoản của Người dùng Instagram và đợi họ chấp nhận lời mời đó. Bạn có thể gửi lời mời từ phần Người dùng thử Instagram trong tab Bảng điều khiển ứng dụng > Vai trò > Vai trò.

Sau khi đăng nhập tài khoản, Người dùng Instagram có thể chấp nhận lời mời bằng cách chuyển đến phần (Biểu tượng trang cá nhân) > Chỉnh sửa trang cá nhân > Ứng dụng và trang web > Lời mời người dùng thử trên ứng dụng di động hoặc trang web Instagram.

Tài nguyên

Dữ liệu trong API bao gồm người dùng Instagram và file phương tiện (hình ảnh, video và album) của họ. Mọi dữ liệu đều được bảo vệ bằng quyền; để ứng dụng của bạn truy cập được dữ liệu của người dùng, người dùng phải cấp cho ứng dụng đó quyền truy cập thông qua Cửa sổ ủy quyền.

Người dùng

Nút Người dùng biểu thị người dùng Instagram và trang cá nhân của họ. Lưu ý rằng ID người dùng API cũ trên Instagram không tương thích với API Instagram Basic Display.

File phương tiện

Ảnh, video và album được biểu thị bằng nút File phương tiện và được tạo trên cơ sở từng Người dùng.

Giới hạn tốc độ

Mọi yêu cầu điểm cuối đều phải tuân thủ Giới hạn tốc độ trên nền tảng của API Đồ thị.

Sau khi thêm sản phẩm Instagram vào ứng dụng, bạn có thể xem mức sử dụng số lệnh gọi hiện tại của ứng dụng trong tab Bảng điều khiển ứng dụng > Instagram > Giới hạn tốc độ hiển thị cơ bản.

Loại ứng dụng

Không hỗ trợ các ứng dụng được chỉ định là Ứng dụng dành cho doanh nghiệp. Nếu ứng dụng của bạn là Ứng dụng dành cho doanh nghiệp, hãy sử dụng API Đồ thị trên Instagram hoặc tạo một ứng dụng mới, không phải là Ứng dụng dành cho doanh nghiệp.

Xét duyệt ứng dụng

Người dùng thử Instagram có thể cấp cho ứng dụng của bạn quyền liên quan đến Instagram bất cứ lúc nào. Để người dùng không có vai trò trên ứng dụng có thể cấp cho ứng dụng các quyền liên quan đến Instagram, trước tiên, mỗi quyền phải được phê duyệt Quyền truy cập nâng cao thông qua quy trình Xét duyệt ứng dụng và ứng dụng của bạn phải ở chế độ Chính thức.

Khi bạn đã hoàn thành quá trình phát triển ứng dụng và sẵn sàng chuyển ứng dụng sang Chế độ chính thức, hãy xem lại các tài liệu về Xét duyệt ứng dụng, Nội dung gửi mẫu và Lý do từ chối thường gặp của chúng tôi để tìm hiểu về quy trình Xét duyệt ứng dụng. Sau khi làm quen với quy trình này, bạn có thể yêu cầu phê duyệt các quyền đối với API Instagram Basic Display thông qua tab Bảng điều khiển ứng dụng > Sản phẩm > Instagram > Basic Display.

Nếu tạo ứng dụng chỉ nhằm mục đích tạo mã truy cập bằng Trình tạo mã người dùng, bạn không cần phải gửi ứng dụng đi Xét duyệt ứng dụng. Trình tạo mã người dùng không yêu cầu quyền nào và có thể sử dụng khi ứng dụng ở Chế độ phát triển.

Xác minh doanh nghiệp

Khi ở Chế độ phát triển, ứng dụng của bạn chỉ có thể truy cập vào dữ liệu trong tài khoản Người dùng thử Instagram. Để có thể chuyển ứng dụng sang Chế độ chính thức và truy cập vào dữ liệu trong tài khoản không phải của người thử nghiệm, trước tiên, bạn phải hoàn tất quy trình Xác minh doanh nghiệp.

Cách hoạt động

Để sử dụng API, trước tiên, hãy triển khai Cửa sổ ủy quyền và hiển thị với người dùng ứng dụng. Người dùng ứng dụng xác thực danh tính của họ thông qua cửa sổ đó và ủy quyền cho ứng dụng truy cập vào dữ liệu của mình bằng cách cấp cho ứng dụng của bạn các quyền cụ thể. Sau khi xác thực, cửa sổ chuyển hướng trở lại ứng dụng của bạn kèm theo Mã ủy quyền. Ghi lại mã và đổi lấy Mã truy cập dành cho Người dùng Instagram có thời hạn ngắn. Sau khi có mã truy cập ngắn hạn, bạn có thể sử dụng mã này để truy vấn bất kỳ dữ liệu nào mà người dùng cho phép ứng dụng của bạn truy cập hoặc đổi mã này lấy mã dài hạn thông qua các điểm cuối Người dùng và File phương tiện.

Công cụ

Trình tạo mã người dùng

Trình tạo mã người dùng Instagram là công cụ bạn có thể sử dụng để tạo nhanh Mã truy cập dài hạn dành cho Người dùng Instagram cho mọi tài khoản Instagram công khai. Điều này hữu ích nếu bạn đang thử nghiệm ứng dụng và không muốn bận tâm đến việc triển khai Cửa sổ ủy quyền hoặc nếu bạn đang dùng mã sao chép và có thể dán do dịch vụ bên thứ ba cung cấp (chẳng hạn như để hiển thị dữ liệu Instagram của chính bạn trên trang web riêng).

Công cụ này hoạt động bằng cách kích hoạt Cửa sổ ủy quyền. Bạn có thể đăng nhập vào cửa sổ này bằng tài khoản Instagram công khai mà bạn đã chỉ định làm tài khoản người dùng thử. Sau khi bạn đăng nhập, công cụ sẽ tạo một mã truy cập dài hạn mà bạn có thể sao chép và dán. Lưu ý rằng bạn chỉ có thể tạo mã cho tài khoản Instagram công khai.

Bạn có thể truy cập vào trình tạo mã trong tab Bảng điều khiển ứng dụng > Sản phẩm > Instagram > Basic Display.

Nếu tạo ứng dụng chỉ nhằm mục đích tạo mã truy cập bằng Trình tạo mã người dùng, bạn không cần phải gửi ứng dụng đi Xét duyệt ứng dụng. Trình tạo mã người dùng không yêu cầu quyền nào và có thể sử dụng khi ứng dụng ở Chế độ phát triển.

Bước tiếp theo

Làm theo hướng dẫn Bắt đầu của chúng tôi để tìm hiểu cách thiết lập ứng dụng và thực hiện yêu cầu API cơ bản.