Graph API

Unggah file

API Unggahan yang Dapat Dilanjutkan memungkinkan Anda mengunggah file besar ke grafik sosial Meta dan melanjutkan sesi unggahan yang terputus tanpa harus memulai dari awal. Setelah Anda mengunggah file, Anda dapat mempublikasikannya.

Referensi untuk endpoint yang mendukung nama pengguna file yang diunggah akan menunjukkan apakah endpoint mendukung nama pengguna yang ditampilkan oleh API Unggahan yang Dapat Dilanjutkan.

Sebelum memulai

Panduan ini berasumsi bahwa Anda telah membaca Ringkasan Graph API dan panduan Pengembangan Meta dan melakukan tindakan yang diperlukan untuk mengembangkan dengan Meta.

Anda memerlukan:

  • ID aplikasi Meta
  • Satu file dalam salah satu format berikut:
    • pdf
    • jpeg
    • jpg
    • png
  • Token akses Pengguna

Langkah 1: Mulai sesi unggahan

Untuk memulai sesi unggahan, kirim permintaan POST ke endpoint /<APP_ID>/uploads, di mana <APP_ID> adalah ID Meta aplikasi Anda, dengan parameter yang diperlukan berikut:

  • file_name - nama file Anda
  • file_length - ukuran file dalam bita
  • file_type - Jenis MIME file. Nilai yang valid adalah: application/pdf, image/jpeg, image/jpg, image/png, dan video/mp4

Sintaksis Permintaan

Diformat agar mudah dibaca.

curl -i -X POST "https://graph.facebook.com/v21.0/<APP_ID>/uploads
  ?file_name=<FILE_NAME>
  &file_length=<FILE_LENGTH>
  &file_type=<FILE_TYPE>
  &access_token=<USER_ACCESS_TOKEN>"

Setelah berhasil, aplikasi Anda akan menerima tanggapan JSON dengan ID sesi unggahan.

{
  "id": "upload:<UPLOAD_SESSION_ID>"
}

Langkah 2: Mulai unggahan

Mulai unggah file dengan mengirimkan POST permintaan ke /upload:<UPLOAD_SESSION_ID> endpoint dengan file_offset berikut diatur ke 0.

Sintaksis Permintaan

curl -i -X POST "https://graph.facebook.com/v21.0/upload:<UPLOAD_SESSION_ID>"
  --header "Authorization: OAuth <USER_ACCESS_TOKEN>"
  --header "file_offset: 0"
  --data-binary @<FILE_NAME>

Anda harus menyertakan token akses di header atau panggilan Anda akan gagal.

Setelah berhasil, aplikasi Anda menerima nama pengguna file yang akan Anda gunakan dalam panggilan API Anda untuk mempublikasikan file tersebut ke endpoint Anda.

{
  "h": "<UPLOADED_FILE_HANDLE>"
}

Contoh Tanggapan

{
    "h": "2:c2FtcGxl..."
}

Lanjutkan unggahan yang terputus

Jika Anda telah memulai sesi unggahan tetapi membutuhkan waktu lebih lama dari yang diperkirakan atau terputus, kirim permintaan GET ke endpoint /upload:<UPLOAD_SESSION_ID> dari Langkah 1.

Sintaksis Permintaan

Diformat agar mudah dibaca.

curl -i -X GET "https://graph.facebook.com/v21.0/upload:<UPLOAD_SESSION_ID>"
  --header "Authorization: OAuth <USER_ACCESS_TOKEN>""

Jika berhasil, aplikasi Anda akan menerima tanggapan JSON dengan nilai file_offset yang dapat Anda gunakan untuk melanjutkan proses unggahan dari titik gangguan.

{
  "id": "upload:<UPLOAD_SESSION_ID>"
  "file_offset": <FILE_OFFSET>"
}

Gunakan nilai file_offset ini untuk mengirim permintaan POST lainnya seperti yang Anda lakukan pada Langkah 2. Ini akan melanjutkan proses unggahan dari titik gangguan.

Langkah Berikutnya