Request, Response, Resource, dan Bundle: Membedah Satu Transaksi FHIR dari Awal sampai Akhir
Ikuti perjalanan satu permintaan data pasien, dari ketukan tombol sampai paket JSON tiba di layar.
Pernah bertanya-tanya, apa yang terjadi di balik layar saat aplikasi RME di puskesmas menarik data pasien dari server pusat hanya dalam hitungan detik? Jawabannya ada pada FHIR Resource dan Bundle. Resource adalah "kartu data" kecil yang berisi satu potong informasi klinis. Bundle adalah "amplop" yang membungkus banyak kartu itu supaya terkirim sekaligus.
Kalau kamu mahasiswa D4 MIK yang kelak mengelola data rekam medis, artikel ini memang untukmu. Kita akan membedah satu transaksi FHIR dari awal sampai akhir. Artikel ini bagian dari seri Pertukaran Informasi Kesehatan, dan kita pakai contoh kode yang bisa kamu coba sendiri.
Mengapa FHIR Resource dan Bundle Perlu Kamu Kuasai Lebih Dulu?
FHIR (Fast Healthcare Interoperability Resources) adalah standar pertukaran data kesehatan buatan HL7 International. Bender dan Sartipi (2013) memperkenalkannya sebagai pendekatan yang gesit dan berbasis REST, sehingga pengembang web biasa pun bisa memakainya tanpa belajar format pesan yang rumit. Di Indonesia, Permenkes Nomor 24 Tahun 2022 tentang Rekam Medis mewajibkan fasilitas pelayanan kesehatan menyelenggarakan RME yang terhubung ke platform SATUSEHAT milik Kemenkes, dan platform itu memakai FHIR.
Bayangkan restoran. Kamu (klien) memesan lewat pelayan (API). Dapur (server) menyiapkan hidangan, lalu pelayan mengantarkannya. Di FHIR, pesananmu disebut request, hidangannya disebut response, bahan-bahannya adalah resource, dan nampan yang memuat banyak piring sekaligus adalah bundle.
Request dan Response: Anatomi Transaksi Sebelum FHIR Resource dan Bundle Tiba
FHIR memakai HTTP, protokol yang sama dengan peramban webmu. Setiap request memuat tiga hal: verba (apa yang ingin dilakukan), alamat (resource mana yang dituju), dan header (format data serta token akses). Aturan lengkapnya ada di spesifikasi FHIR bagian RESTful API (HL7 International, 2019). Berikut padanan verba HTTP dan operasi data:
| Verba HTTP | Operasi | Contoh alamat | Status sukses |
|---|---|---|---|
GET | Baca / cari | /Patient/123 | 200 OK |
POST | Buat baru | /Patient | 201 Created |
PUT | Ganti / perbarui | /Patient/123 | 200 OK |
DELETE | Hapus | /Patient/123 | 204 No Content |
Accept: application/fhir+json. Dengan begitu kamu minta JSON secara eksplisit, dan tidak bergantung pada format bawaan server.Setelah server memproses request, ia mengirim response berisi kode status dan, biasanya, badan pesan. Kode 2xx berarti berhasil, 4xx berarti kesalahan di sisi kamu (misalnya 404 data tidak ditemukan atau 401 belum terautentikasi, topik artikel 11), dan 5xx berarti server bermasalah. Kalau gagal, server mengembalikan resource OperationOutcome yang menjelaskan penyebabnya.
FHIR Resource: Satuan Data Terkecil yang Bermakna
Resource adalah blok pembangun FHIR. Setiap resource mewakili satu konsep klinis atau administratif, misalnya Patient, Encounter, Observation, atau Condition. Analogi mudahnya: resource itu satu halaman formulir terpisah di map rekam medis, dan setiap halaman punya judul (resourceType) dan nomor identitas (id). Resource saling menunjuk lewat reference, seperti nomor RM yang tertulis di setiap halaman.
Coba kirim request ini untuk membaca satu pasien:
resourceType di baris pertama. Parser FHIR memakainya untuk mengenali jenis data. Kalau kamu lupa mengisinya, resource dianggap tidak valid. NIK di contoh ini fiktif.Bundle: Cara FHIR Resource Dibungkus dan Dikirim Bersama
Mengirim satu resource per request itu boros, seperti membeli sepuluh barang dengan sepuluh kali antre di kasir. Bundle menyelesaikannya. Bundle sendiri adalah sebuah resource, dan isinya adalah daftar entry yang masing-masing membawa resource lain. Atribut type menentukan fungsi bundle tersebut (HL7 International, 2019):
| Tipe Bundle | Fungsi | Kapan dipakai |
|---|---|---|
searchset | Hasil pencarian dari server | Cari pasien berdasarkan NIK |
transaction | Semua operasi berhasil atau semuanya batal | Simpan kunjungan + diagnosis sekaligus |
batch | Kumpulan operasi independen | Unggah banyak data tak saling terkait |
document | Dokumen klinis utuh dan statis | Resume medis |
collection | Kumpulan resource tanpa aturan khusus | Mengelompokkan data untuk dibagikan |
GET /Patient?name=siti, server membalas dengan Bundle bertipe searchset, bukan daftar polos.Bersifat atomik. Jika satu entri gagal, seluruh bundle ditolak dan tidak ada data setengah tersimpan. Cocok untuk data yang saling bergantung, seperti kunjungan dan diagnosisnya.
Setiap entri diproses sendiri-sendiri. Satu gagal tidak membatalkan yang lain, dan server mengembalikan status per entri. Cocok untuk pekerjaan massal yang tidak saling bergantung.
Dalam transaction, entri-entri bisa saling merujuk memakai fullUrl sementara berformat urn:uuid. Server lalu mengganti rujukan itu dengan ID asli setelah resource tersimpan.
Praktik: Membedah Satu Transaksi FHIR Resource dan Bundle Langkah demi Langkah
Skenario: pasien baru datang ke poli rawat jalan. Aplikasimu harus menyimpan data pasien dan data kunjungannya dalam satu kiriman. Ikuti urutan ini:
GET /Patient?identifier=...|NIK. Jika Bundle searchset berisi entri, pakai ID yang ada. Jika kosong, lanjut langkah 3.Patient dan Encounter. Beri keduanya fullUrl sementara.POST ke alamat dasar server, seperti kode di bawah.transaction-response. Cek status tiap entri (misalnya 201 Created) dan simpan ID baru dari location.🎯 Kesimpulan
Satu transaksi FHIR selalu berjalan dalam pola yang sama: request membawa verba dan alamat, server menjawab dengan response berisi kode status, dan isi pesannya berupa resource tunggal atau bundle yang memuat banyak resource.
Kalau kamu menguasai FHIR Resource dan Bundle, kamu sudah memegang kunci membaca hampir semua dokumentasi API kesehatan modern, termasuk SATUSEHAT. Pilih transaction untuk data yang saling bergantung dan batch untuk pekerjaan massal.
#PertukaranData #PertukaranInformasi #Kesehatan #FHIRResourcedanBundle
Pertukaran Informasi Kesehatan FHIR Resource dan Bundle Request dan Response
- Bender, D., & Sartipi, K. (2013). HL7 FHIR: An agile and RESTful approach to healthcare information exchange. Proceedings of the 26th IEEE International Symposium on Computer-Based Medical Systems (CBMS), 326–331.
- HL7 International. (2019). HL7 FHIR Release 4 (v4.0.1): RESTful API, Resource, dan Bundle. https://hl7.org/fhir/R4/
- Kementerian Kesehatan Republik Indonesia. (2022). Peraturan Menteri Kesehatan Nomor 24 Tahun 2022 tentang Rekam Medis.
Daftar Isi Kuliah Pertukaran Informasi Kesehatan
Lihat seluruh 16 artikel seri ini dalam satu peta belajar.
Buka Daftar Isi →
No comments:
Post a Comment