Sinopsis API Graf

API Graf merupakan cara utama untuk mendapatkan data dari, dan memasukkan data ke, platform Facebook. API berbasis HTTP dengan level rendah yang dapat Anda gunakan untuk mengkueri data secara terprogram, mengirimkan cerita baru, mengelola iklan, mengunggah foto, dan melakukan berbagai jenis tugas lain yang mungkin diterapkan aplikasi.

Dasar-Dasar

API Graf diberi nama menurut gagasan tentang 'graf sosial' - sebuah representasi informasi di Facebook yang terdiri dari:

  • node - pada dasarnya adalah "sesuatu" seperti Pengguna, Foto, Halaman, Komentar
  • edge - hubungan antar "sesuatu" tersebut, seperti Foto Halaman, atau Komentar Foto
  • bidang - info tentang "sesuatu" tersebut, seperti hari ulang tahun seseorang, atau nama Halaman

API Graf berbasis HTTP, sehingga API Graf dapat digunakan dengan berbagai bahasa yang mempunyai perpustakaan HTTP, seperti cURL dan urllib. Kami akan menjelaskan sedikit lebih banyak tentang apa yang dapat Anda lakukan dengan API Graf di bagian berikut ini, tetapi ini berarti Anda juga dapat menggunakan API Graf langsung di browser Anda, misalnya permintaan API Graf setara dengan:

GET graph.facebook.com
  /facebook/picture?
    redirect=false

Kebanyakan permintaan API Graf mengharuskan penggunaan token akses yang dapat dibuat oleh aplikasi Anda dengan menerapkan Facebook Login.

Sinopsis ini akan menunjukkan kepada Anda bagaimana API Graf dapat membaca dan menerbitkan data untuk graf sosial.

Struktur API Graf

Kami membahas hal ini secara lengkap di panduan Menggunakan API graf kami, tetapi umumnya Anda dapat membaca API dengan membuat permintaan HTTP GET untuk node atau edge di node tersebut.

Hampir semua permintaan diteruskan ke API di graph.facebook.com - satu-satunya pengecualian adalah unggahan video yang menggunakan graph-video.facebook.com.

ID Objek

Setiap node mempunyai ID unik yang digunakan untuk mengaksesnya melalui API Graf. Kami tidak secara khusus mencatat semua struktur ID atau format node/objek karena kemungkinan besar akan berubah seiring berjalannya waktu dan aplikasi tidak boleh membuat asumsi berdasarkan struktur saat ini.

Berikut ini cara menggunakan ID untuk membuat permintaan untuk node:

GET graph.facebook.com
  /{node-id}

atau edge:

GET graph.facebook.com
  /{node-id}/{edge-name}

Biasanya Anda dapat menerbitkan ke API dengan membuat permintaan HTTP POST menggunakan parameter ke node:

POST graph.facebook.com
  /{node-id}

atau edge:

POST graph.facebook.com
  /{node-id}/{edge-name}

Penghapusan melalui API diselesaikan menggunakan permintaan HTTP DELETE (dan pembaruan melalui permintaan POST) untuk endpoint yang sama.

Versi API

API Graf mempunyai beberapa versi yang tersedia untuk diakses setiap saat. Setiap versi terdiri dari kumpulan kolom inti dan operasi edge. Kami menjamin semua API inti tersebut akan tersedia dan tidak dimodifikasi dalam versi tersebut selama minimal 2 tahun dari peluncuran. Catatan perubahan platform dapat memberi tahu Anda versi yang tersedia saat ini.

Operasi tertentu seperti penerbitan dalam edge atau bidang tertentu dalam node, dapat berupa inti tanpa keseluruhan edge atau node menjadi inti. Kami memberi keterangan API inti ini menggunakan simbol dalam dokumen referensi API Graf kami.

Semua hal di luar API inti ini disebut API perluasan. API ini tetap diakses melalui path berversi, tetapi API tersebut berpotensi dapat diubah atau dihapus kapan saja, sesuai dengan migrasi 90 hari yang akan diumumkan di roadmap platform kami. Atau API tersebut dapat disertakan di versi API berikutnya yang tersedia.

Anda dapat membaca selengkapnya tentang tujuan dari pembuatan versi di panduan kami, tetapi di sini kami akan menjelaskan cara membuat panggilan ke versi API Graf tertentu.

Sangat mudah - cukup tambahkan pengenal versi di awal path permintaan. Misalnya, ini adalah panggilan ke v2.2:

GET graph.facebook.com
  /v2.2/me

Ini berfungsi untuk semua versi, dalam bentuk umum ini:

GET graph.facebook.com
  /vX.Y/{request-path}

di mana X.Y merupakan versi yang dibutuhkan. Kami menerbitkan daftar lengkap versi yang tersedia di catatan perubahan kami. Semua dokumen Referensi API Graf memberikan informasi tentang per-versi, jadi periksa untuk memastikan bahwa Anda melihat versi yang benar - beberapa versi menghapus node dan edge, beberapa versi akan menambahkan node dan edge.

Sekarang, mari coba permintaan API, sehingga Anda dapat mengetahui betapa mudahnya permintaan API itu.

Muat Penjelajah API Graf

Cara termudah untuk memahami API Graf adalah menggunakannya dengan Penjelajah API Graf, alat level rendah yang dapat Anda gunakan untuk mencari, menambah, dan menghapus data. Ini merupakan sumber daya bermanfaat yang dapat digunakan dengan mudah saat Anda berintegrasi dengan Facebook. Langkah Anda berikutnya adalah membuka Penjelajah API Graf.

Penjelajah API Graf

Membuat Token Akses Pengguna Dasar

Ketika Anda mulai membuat aplikasi Anda sendiri, Anda harus mempelajari tentang token akses dan cara membuat token akses tersebut menggunakan Facebook Login, tetapi untuk saat ini, kita dapat memperoleh token dengan sangat cepat melalui Penjelajah API Graf:

  1. Klik tombol Get Token di sebelah kanan atas Penjelajah.
  2. Pilih opsi Get User Access Token.
  3. Di dialog berikutnya, jangan mencentang kotak apa pun, cukup klik tombol Get Access Token biru.
  4. Anda akan melihat Dialog Facebook Login, klik OK untuk melanjutkan.

Membuat Permintaan Pertama Anda

Sekarang Anda sudah siap untuk membuat permintaan API Graf pertama, kami akan mulai dengan permintaan 'baca'. Di kolom teks di samping tombol menu pilihan "DAPATKAN" (kami menamainya kolom path), hapus teks yang ada dan ketik 'me':

Sekarang tekan tombol "Ajukan". Dibutuhkan beberapa detik untuk memproses, tetapi sekarang Anda akan melihat sekumpulan informasi yang muncul di panel tanggapan. Apa yang muncul di sini ditentukan oleh pengaturan privasi profil Anda, tetapi setidaknya ada beberapa bidang dasar:

Apa yang baru saja Anda lakukan di Penjelajah API Graf sama dengan permintaan 'baca' API Graf berikut ini:

GET graph.facebook.com
  /me

/me merupakan endpoint khusus yang diterjemahkan menjadi ID pengguna seseorang yang token aksesnya digunakan untuk membuat permintaan.

Selamat, Anda baru saja membuat permintaan API Graf pertama Anda!

Mendapatkan Izin Penerbitan

Selanjutnya, kami akan mencoba menerbitkan sesuatu ke Facebook menggunakan API Graf. Anda akan melakukannya di aplikasi Anda hanya jika Anda membuat komposer khusus sendiri dan tidak menggunakan salah satu Dialog Bagikan di web, iOS, atau Android. Dialog Bagikan di Facebook tidak mewajibkan Anda untuk menerapkan Facebook login atau membuat antarmuka Anda sendiri untuk memungkinkan orang membagikan sesuatu.

Untuk menjelajahi penerbitan dengan API Graf, klik tombol "Dapatkan Token Akses" lagi, dan kali ini, pilih izin publish_actions:

Sekarang klik tombol "Dapatkan Token Akses" biru, dan Anda akan melihat Dialog Masuk lagi. Di sini Anda akan dimintai izin bagi Penjelajah API Graf untuk mengirim atas nama Anda. Jika Anda menginginkan, Anda dapat mengubah pemirsa di sini menjadi 'Hanya Saya' sehingga hanya Anda yang akan dapat melihat kiriman tersebut, tetapi Anda harus menerima dialog ini dan beralih ke langkah berikutnya.

Menerbitkan Kiriman

Jika Anda sudah meminta izin publish_actions, sekarang klik tombol yang bertuliskan "GET" dan pilih "POST" dari selektor menu pilihan yang muncul. Masukkan me/feed di kolom path, lalu klik "Tambahkan Kolom".

Di kolom baru yang muncul, letakkan message sebagai "nama", dan Hello, World sebagai "nilai. Ini akan terlihat seperti ini:

Sekarang, klik tombol "Ajukan" berwarna biru, dan setelah beberapa detik panel tanggapan akan menampilkan sesuatu seperti:

{
  "id": "{new-post-id}"
}

Ini berarti Anda baru saja menerbitkan kiriman melalui API Graf untuk pertama kali! Anda dapat membuka profil Anda, dan Anda akan dapat melihat kiriman di sana:

Apa yang baru saja Anda lakukan di Penjelajah API Graf sama dengan permintaan 'terbitkan' API Graf berikut ini:

POST graph.facebook.com
  /me/feed?
    message="Hello, World."&
    access_token={your-access-token}

Langkah Berikutnya

Setelah Anda memahami hal-hal dasar di sini, mari lanjutkan membahas tentang cara Menggunakan API Graf. Jika Anda belum memahaminya, kami sarankan Anda membaca tentang Facebook Login terlebih dahulu, terutama tentang cara membuat token akses yang akan Anda butuhkan untuk membuat permintaan API Graf yang lebih kompleks.