Integrasi API Eksternal dengan UrlFetchApp

UrlFetchApp#

Gunakan UrlFetchApp.fetch() untuk memanggil API eksternal (GET, POST, dll.).

GET Request#

Example:

function ambilData() {
  const url = 'https://api.contoh.com/v1/barang';
  const res = UrlFetchApp.fetch(url, {
    method: 'get',
    headers: { Authorization: 'Bearer TOKEN_KAMU' }
  });

  const json = JSON.parse(res.getContentText());
  Logger.log(json);
}

POST Request (kirim data)#

Example:

function kirimData() {
  const url = 'https://api.contoh.com/v1/pesan';
  const payload = { nama: 'Budi', jumlah: 3 };
  const res = UrlFetchApp.fetch(url, {
    method: 'post',
    contentType: 'application/json',
    payload: JSON.stringify(payload),
    headers: { Authorization: 'Bearer TOKEN_KAMU' }
  });
  Logger.log(res.getResponseCode());
}

Menangani Error HTTP#

Example:

function amanAmbil() {
  try {
    const res = UrlFetchApp.fetch('https://api.contoh.com/v1/x');
    if (res.getResponseCode() !== 200) {
      Logger.log('Gagal: ' + res.getResponseCode());
      return;
    }
    return JSON.parse(res.getContentText());
  } catch (err) {
    Logger.log('Error: ' + err.message);
  }
}

Opsi fetch	Deskripsi
`method`	`get`, `post`, `put`, `delete`
`headers`	Header, mis. token otorisasi
`payload`	Isi body (string/objek)
`contentType`	Tipe konten, mis. `application/json`
`muteHttpExceptions`	`true` agar gagal tidak melempar exception

Warning

Token API adalah rahasia. Jangan tulis di script yang dibagikan. Simpan di PropertiesService (lihat artikel Library & Modularisasi).

Next#

Pelajari Menyambung Beberapa Layanan (End-to-End).