Membangun ekspor
1
Pilih data yang Anda butuhkan
Mulailah dengan resource API yang telah dipublikasikan atau
resep laporan.
Pilih kolom dan filter yang dibutuhkan oleh tujuan Anda, lalu tentukan interval
penyegaran yang sesuai dengan kebutuhan pelaporan Anda.
2
Autentikasi integrasi Anda
Buat akun layanan untuk ekspor tersebut dan berikan hanya izin yang
dibutuhkan. Ikuti panduan memulai API untuk mengirim
permintaan pertama Anda dengan kunci API. Lihat
Autentikasi jika kebijakan keamanan Anda
mewajibkan token akses OAuth.
3
Baca semua halaman
Ikuti panduan paginasi untuk mengumpulkan
kumpulan hasil yang lengkap. Jaga agar filter tetap konsisten saat mengikuti kursor,
tangani kedaluwarsa kursor, dan perhitungkan adanya perubahan pada rekaman selama pembacaan.
4
Jadwalkan dan pantau penyegaran
Jadwalkan permintaan dalam integrasi Anda dan ikuti
panduan batas laju dan percobaan ulang.
Catat hasil penyegaran dan ID permintaan agar Anda dapat menyelidiki ekspor yang gagal atau
tidak lengkap. Jangan sertakan kredensial dan data pribadi hasil ekspor dalam log.
Melindungi data yang diekspor
Gunakan host API regional untuk organisasi Anda. Tinjau kontrol akses dan kebijakan retensi pada tujuan sebelum mengirimkan data pribadi ke sana. Simpan kredensial API dalam secret manager, dan rotasi atau cabut kredensial tersebut saat integrasi berubah. Saat meminta bantuan terkait ekspor, sertakan operasi, status HTTP, danRequest-Id. Jangan sertakan kunci API, token akses, atau data pribadi hasil ekspor.
