ภาพรวม

Instagram Basic Display API เป็น API แบบใช้ HTTP ซึ่งแอพสามารถใช้เพื่อเรียกดูโปรไฟล์ รูปภาพ วิดีโอ และอัลบั้มของผู้ใช้ Instagram ได้

องค์ประกอบ

URL ฐาน

• api.instagram.com — สำหรับเรียกดูโทเค็นการเข้าถึงผู้ใช้ Instagram
• graph.instagram.com — สำหรับเรียกดูโปรไฟล์และสื่อของผู้ใช้ Instagram

เวอร์ชั่น

API รองรับโปรโตคอลการกำหนดเวอร์ชั่นและรอบการเผยแพร่แบบเดียวกันกับ API กราฟของ Facebook เวอร์ชั่นใหม่จะออกทุกๆ 3 เดือนโดยประมาณ และแต่ละเวอร์ชั่นจะสามารถใช้งานได้ประมาณ 2 ปีก่อนจะเลิกใช้

หากต้องการสืบค้นเวอร์ชั่น API ที่เฉพาะเจาะจง ให้ใส่หมายเลขเวอร์ชั่นในพาธการสืบค้นหลัง URL ฐาน ตัวอย่างเช่น

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

หากคุณไม่ใส่หมายเลขเวอร์ชั่นไว้ในคำขอของคุณ คำขอดังกล่าวจะปรับเป็นเวอร์ชั่นที่ระบุอยู่ในส่วนแดชบอร์ดของแอพ > การตั้งค่า > ขั้นสูง > อัพเกรดเวอร์ชั่น API

หน้าต่างการอนุญาต

หน้าต่างการอนุญาตจะช่วยให้แอพของคุณสามารถรับรหัสการให้อนุญาตและสิทธิ์การอนุญาตจากผู้ใช้แอพได้ รหัสการให้อนุญาตสามารถแลกเปลี่ยนเป็นโทเค็นการเข้าถึงผู้ใช้ Instagram ได้ ซึ่งจะต้องระบุไว้เมื่อสืบค้นโปรไฟล์หรือสื่อของผู้ใช้แอพ

หากต้องการใช้หน้าต่างการอนุญาต โปรดอ่านคู่มือการรับโทเค็นการเข้าถึงของเรา

รหัสการให้อนุญาต

รหัสการให้อนุญาตสามารถแลกเปลี่ยนเป็นโทเค็นการเข้าถึงผู้ใช้ Instagram ระยะสั้นได้ หากต้องการรับรหัสการให้อนุญาต ให้นำ "หน้าต่างการอนุญาต" มาใช้ในแอพของคุณ หลังจากที่ผู้ใช้แอพยืนยันตัวตนผ่านหน้าต่างดังกล่าวและให้สิทธิ์การอนุญาตที่จำเป็นแก่แอพของคุณแล้ว เราจะเปลี่ยนเส้นทางผู้ใช้ไปยังแอพของคุณและระบุรหัสการให้อนุญาต จากนั้นคุณสามารถใช้ API ดังกล่าวเพื่อแลกเปลี่ยนรหัสดังกล่าวเป็นโทเค็นการเข้าถึงผู้ใช้ Instagram ระยะสั้นของผู้ใช้แอพได้

รหัสการให้อนุญาตเป็นแบบระยะสั้นและใช้ได้เพียง 1 ชั่วโมงเท่านั้น

โทเค็นการเข้าถึงผู้ใช้ Instagram

การยืนยันตัวตน API จะจัดการด้วยโทเค็นการเข้าถึงผู้ใช้ Instagram ซึ่งสอดคล้องกับโปรโตคอล OAuth 2.0 โทเค็นการเข้าถึงจะเป็นแบบในแอพ (มีไว้สำหรับผู้ใช้กับแอพคู่นั้นๆ โดยเฉพาะ) และอาจเป็นแบบระยะสั้นหรือระยะยาวก็ได้ คำขอ API ที่สืบค้นผู้ใช้ Instagram หรือสื่อของผู้ใช้จะต้องมีโทเค็นการเข้าถึงผู้ใช้ Instagram

โทเค็นการเข้าถึงระยะสั้น

โทเค็นการเข้าถึงระยะสั้นใช้ได้ 1 ชั่วโมง แต่สามารถแลกเปลี่ยนเป็นโทเค็นระยะยาวได้ หากต้องการรับโทเค็นการเข้าถึงระยะสั้น ให้นำหน้าต่างการอนุญาตมาใช้ในแอพของคุณ หลังจากที่ผู้ใช้แอพยืนยันตัวตนผ่านหน้าต่างดังกล่าวแล้ว เราจะเปลี่ยนเส้นทางผู้ใช้กลับไปที่แอพของคุณพร้อมระบุรหัสการให้อนุญาต ซึ่งคุณสามารถนำไปแลกเปลี่ยนเป็นโทเค็นการเข้าถึงระยะสั้นได้

โทเค็นการเข้าถึงระยะยาว

คุณสามารถนำโทเค็นระยะสั้นที่ยังไม่หมดอายุมาแลกเปลี่ยนเป็นโทเค็นการเข้าถึงระยะยาวได้ ซึ่งจะสามารถใช้งานได้ 60 วัน คุณสามารถรีเฟรชโทเค็นระยะยาวได้ก่อนที่จะหมดอายุโดยการสืบค้นตำแหน่งข้อมูล GET /refresh_access_token

สิทธิ์การอนุญาต

การอนุญาตการเข้าถึงข้อมูลจะถูกควบคุมโดยผู้ใช้แอพของคุณผ่านการใช้สิทธิ์การอนุญาตในรายการด้านล่าง ผู้ใช้ต้องให้สิทธิ์การอนุญาตเหล่านี้แก่แอพของคุณผ่านทางหน้าต่างการอนุญาตก่อน แอพของคุณจึงจะสามารถเข้าถึงข้อมูลของผู้ใช้ดังกล่าวได้

• instagram_graph_user_profile — ช่วยให้แอพของคุณสามารถอ่านโหนดผู้ใช้ซึ่งแสดงถึงผู้ใช้ Instagram รวมถึงจุดเชื่อมโยงของโหนดดังกล่าวได้
• instagram_graph_user_media — ช่วยให้แอพของคุณสามารถอ่านโหนดสื่อซึ่งแสดงถึงรูปภาพ วิดีโอ หรืออัลบั้ม รวมถึงจุดเชื่อมโยงของโหนดดังกล่าวได้

ผู้ทดสอบ Instagram สามารถให้สิทธิ์การอนุญาตเหล่านี้แก่แอพของคุณได้ทุกเมื่อ หากต้องการให้ผู้ใช้แอพที่ไม่มีบทบาทในแอพของคุณสามารถให้สิทธิ์การอนุญาตเหล่านี้แก่แอพได้ สิทธิ์การอนุญาตแต่ละรายการจะต้องได้รับอนุมัติสำหรับสิทธิ์การเข้าถึงระดับสูงผ่านกระบวนการตรวจสอบแอพก่อน และแอพต้องอยู่ในโหมดเผยแพร่

สิทธิ์การอนุญาตที่ได้รับจากผู้ใช้แอพที่มีบัญชีสาธารณะจะใช้งานได้เป็นเวลา 90 วัน การรีเฟรชโทเค็นการเข้าถึงระยะยาวของผู้ใช้แอพจะเป็นการขยายการให้สิทธิ์การอนุญาตไปอีก 90 วันหากผู้ใช้แอพที่มอบโทเค็นให้มีบัญชีสาธารณะ แต่ถ้าหากบัญชีของผู้ใช้แอพเป็นแบบส่วนตัว การให้สิทธิ์การอนุญาตจะไม่สามารถขยายเวลาออกไปได้ และผู้ใช้แอพจะต้องให้สิทธิ์การอนุญาตที่หมดอายุไปแก่แอพของคุณอีกครั้ง

ผู้ทดสอบ Instagram

ในการทดสอบแอพของคุณด้วยผู้ใช้ Instagram ก่อนอื่น คุณต้องส่งคำเชิญถึงบัญชีของผู้ใช้ Instagram และตอบรับคำเชิญนั้น คุณสามารถส่งคำเชิญได้จากส่วนผู้ทดสอบ Instagram ในแดชบอร์ดของแอพ > บทบาท > แท็บบทบาท

ผู้ใช้ Instagram สามารถตอบรับคำเชิญได้ในส่วน (ไอคอนโปรไฟล์) > แก้ไขโปรไฟล์ > แอพและเว็บไซต์ > คำเชิญของผู้ทดสอบของเว็บไซต์ Instagram หรือแอพมือถือหลังจากลงชื่อเข้าใช้บัญชีของตน

แหล่งข้อมูล

ข้อมูลใน API จะประกอบด้วยผู้ใช้ Instagram และสื่อของผู้ใช้เหล่านั้น (รูปภาพ วิดีโอ และอัลบั้ม) ข้อมูลทั้งหมดได้รับการคุ้มครองด้วยสิทธิ์การอนุญาต ด้วยเหตุนี้ ผู้ใช้จะต้องให้สิทธิ์การอนุญาตแก่แอพของคุณผ่านหน้าต่างการอนุญาต แอพของคุณจึงจะเข้าถึงข้อมูลของผู้ใช้ได้

ผู้ใช้

ผู้ใช้ Instagram และโปรไฟล์ของผู้ใช้ดังกล่าวจะแสดงโดยโหนดผู้ใช้ โปรดทราบว่าคุณจะใช้ ID ผู้ใช้ API แบบเดิมบน Instagram ร่วมกับ Instagram Basic Display API ไม่ได้

สื่อ

รูปภาพ วิดีโอ และอัลบั้มจะแสดงโดยโหนดสื่อและสร้างขึ้นสำหรับผู้ใช้แต่ละราย

ขีดจำกัดอัตรา

คำขอตำแหน่งข้อมูลทั้งหมดจะอยู่ภายใต้การจำกัดอัตราของแพลตฟอร์มของ API กราฟ

คุณสามารถดูจำนวนการเรียกใช้ในปัจจุบันของแอพได้ในแดชบอร์ดของแอพ > Instagram > แท็บการจำกัดอัตราของ Basic Display หลังจากเพิ่มผลิตภัณฑ์ Instagram ลงในแอพของคุณแล้ว

ประเภทแอพ

ระบบไม่รองรับแอพที่กำหนดเป็นแอพทางธุรกิจ หากแอพของคุณเป็นแอพทางธุรกิจ ให้ใช้ API กราฟของ Instagram แทน หรือสร้างแอพใหม่ที่ไม่ใช่แอพทางธุรกิจ

การตรวจสอบแอพ

ผู้ทดสอบ Instagram สามารถให้สิทธิ์การอนุญาตของ Instagram แก่แอพของคุณได้ทุกเมื่อ หากต้องการให้ผู้ใช้แอพที่ไม่มีบทบาทในแอพของคุณสามารถให้สิทธิ์การอนุญาตของ Instagram แก่แอพได้ สิทธิ์การอนุญาตแต่ละรายการจะต้องได้รับอนุมัติสำหรับสิทธิ์การเข้าถึงระดับสูงผ่านกระบวนการตรวจสอบแอพก่อน และแอพต้องอยู่ในโหมดเผยแพร่

เมื่อคุณพัฒนาแอพเสร็จแล้วและพร้อมที่จะสลับแอพของคุณให้เป็นโหมดเผยแพร่ ให้อ่านเอกสารเรื่องการตรวจสอบแอพ ตัวอย่างข้อมูลที่ส่ง และเหตุผลในการปฏิเสธโดยทั่วไปเพื่อเรียนรู้เกี่ยวกับกระบวนการตรวจสอบแอพ เมื่อคุณคุ้นเคยกับกระบวนการนี้แล้ว คุณจะสามารถขออนุมัติสิทธิ์การอนุญาต Instagram Basic Display API ได้ผ่านแดชบอร์ดของแอพ > ผลิตภัณฑ์ > Instagram > แท็บ Basic Display

หากคุณกำลังสร้างแอพโดยมีจุดประสงค์เพียงอย่างเดียวคือการสร้างโทเค็นการเข้าถึงด้วยตัวสร้างโทเค็นผู้ใช้ คุณจะไม่จำเป็นต้องส่งแอพของคุณเข้ารับการตรวจสอบแอพ ตัวสร้างโทเค็นผู้ใช้ไม่จำเป็นต้องใช้สิทธิ์การอนุญาตใดๆ และสามารถใช้ได้ในขณะที่แอพของคุณอยู่ในโหมดการพัฒนา

การตรวจสอบยืนยันธุรกิจ

ในขณะที่แอพของคุณอยู่ในโหมดการพัฒนา แอพของคุณจะสามารถเข้าถึงได้เฉพาะข้อมูลในบัญชีผู้ทดสอบ Instagram เท่านั้น ทั้งนี้ คุณจะต้องดำเนินการตรวจสอบยืนยันธุรกิจให้เสร็จสิ้นเสียก่อนจึงจะสามารถสลับแอพเป็นโหมดเผยแพร่และเข้าถึงข้อมูลในบัญชีที่ไม่ใช่ผู้ทดสอบได้

วิธีการทำงาน

หากต้องการใช้ API ดังกล่าว ขั้นแรกให้นำหน้าต่างการอนุญาตเข้ามาใช้และแสดงหน้าต่างนี้ต่อผู้ใช้แอพ ผู้ใช้แอพจะยืนยันตัวตนของตนเองผ่านหน้าต่างดังกล่าวและอนุญาตให้แอพของคุณเข้าถึงข้อมูลของตนได้โดยให้สิทธิ์การอนุญาตที่เฉพาะเจาะจงแก่แอพของคุณ เมื่อยืนยันตัวตนแล้ว หน้าต่างจะเปลี่ยนเส้นทางกลับไปที่แอพของคุณพร้อมระบุรหัสการให้อนุญาต ให้เก็บรหัสการให้อนุญาตดังกล่าวไว้และแลกเปลี่ยนเป็นโทเค็นการเข้าถึงผู้ใช้ Instagram ระยะสั้น เมื่อคุณมีโทเค็นระยะสั้นแล้ว คุณจะสามารถใช้โทเค็นดังกล่าวเพื่อสืบค้นตำแหน่งข้อมูลผู้ใช้และสื่อเพื่อรับข้อมูลต่างๆ ที่ผู้ใช้ได้อนุญาตให้แอพของคุณเข้าถึง หรือแลกเปลี่ยนเป็นโทเค็นระยะยาวก็ได้

เครื่องมือ

ตัวสร้างโทเค็นผู้ใช้

ตัวสร้างโทเค็นผู้ใช้ Instagram เป็นเครื่องมือที่คุณสามารถใช้เพื่อสร้างโทเค็นการเข้าถึงผู้ใช้ Instagram ระยะยาวได้อย่างรวดเร็วสำหรับบัญชี Instagram สาธารณะของคุณ เครื่องมือนี้จะเป็นประโยชน์หากคุณกำลังทดสอบแอพของคุณและไม่ต้องการใช้งานหน้าต่างการอนุญาต หรือหากคุณกำลังใช้โค้ดที่คัดลอกและวางได้ซึ่งบริการจากภายนอกได้ให้ไว้ (เช่น เพื่อแสดงข้อมูล Instagram ของคุณบนเว็บไซต์ของคุณเอง)

เครื่องมือนี้จะทำงานด้วยการแสดงหน้าต่างการอนุญาต ซึ่งคุณสามารถลงชื่อเข้าใช้ด้วยบัญชี Instagram สาธารณะที่คุณกำหนดให้เป็นบัญชีผู้ทดสอบได้ หลังจากการลงชื่อเข้าใช้แล้ว เครื่องมือจะสร้างโทเค็นการเข้าถึงระยะยาวซึ่งคุณสามารถคัดลอกและวางได้ โปรดทราบว่าคุณสามารถสร้างโทเค็นได้สำหรับบัญชี Instagram สาธารณะเท่านั้น

คุณสามารถเข้าถึงตัวสร้างโทเค็นได้ในแดชบอร์ดของแอพ > ผลิตภัณฑ์ > Instagram > แท็บ Basic Display

หากคุณกำลังสร้างแอพโดยมีจุดประสงค์เพียงอย่างเดียวคือการสร้างโทเค็นการเข้าถึงด้วยตัวสร้างโทเค็นผู้ใช้ คุณจะไม่จำเป็นต้องส่งแอพของคุณเข้ารับการตรวจสอบแอพ ตัวสร้างโทเค็นผู้ใช้ไม่จำเป็นต้องใช้สิทธิ์การอนุญาตใดๆ และสามารถใช้ได้ในขณะที่แอพของคุณอยู่ในโหมดการพัฒนา

ขั้นตอนถัดไป

ปฏิบัติตามคู่มือเริ่มต้นใช้งานของเราเพื่อเรียนรู้วิธีตั้งค่าแอพและดำเนินการตามคำขอ API พื้นฐาน