request response resource bundle fhir | java php laravel linux mysql sql bootstrap html css query java php laravel linux mysql sql bootstrap html css query: request response resource bundle fhir

Tuesday, November 17, 2026

request response resource bundle fhir

📦🏥
Artikel 12 dari 16 · Pertukaran Informasi Kesehatan

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.

FHIR Resource Bundle REST API Interoperabilitas
⏱️
9 menit
Estimasi baca
🎯
Menengah
Level
📅
2026
Tahun

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.

📐 RUMUS KONSEP
Transaksi FHIR = Request (verba + alamat) → Server → Response (status + Resource atau Bundle)
Resource = satuan data tunggal. Bundle = Resource khusus yang berisi kumpulan Resource lain.

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 HTTPOperasiContoh alamatStatus sukses
GETBaca / cari/Patient/123200 OK
POSTBuat baru/Patient201 Created
PUTGanti / perbarui/Patient/123200 OK
DELETEHapus/Patient/123204 No Content
💡 Tips
Selalu tambahkan header 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:

📄 Request + Response (JSON)
GET https://contoh.id/fhir/Patient/123
Accept: application/fhir+json
Authorization: Bearer <token_akses>

HTTP/1.1 200 OK
Content-Type: application/fhir+json

{
  "resourceType": "Patient",
  "id": "123",
  "identifier": [{
    "system": "https://fhir.kemkes.go.id/id/nik",
    "value": "3171000000000001"
  }],
  "name": [{ "text": "Siti Aminah" }],
  "gender": "female",
  "birthDate": "1995-04-12"
}
⚡ Insight Penting
Perhatikan kata 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 BundleFungsiKapan dipakai
searchsetHasil pencarian dari serverCari pasien berdasarkan NIK
transactionSemua operasi berhasil atau semuanya batalSimpan kunjungan + diagnosis sekaligus
batchKumpulan operasi independenUnggah banyak data tak saling terkait
documentDokumen klinis utuh dan statisResume medis
collectionKumpulan resource tanpa aturan khususMengelompokkan data untuk dibagikan
🔥 Fakta Menarik
Hasil pencarian FHIR ternyata juga berbentuk Bundle. Jadi saat kamu mengetik GET /Patient?name=siti, server membalas dengan Bundle bertipe searchset, bukan daftar polos.
🔍 ANALYSIS BOX · Transaction vs Batch
Transaction
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.
Batch
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:

1
Dapatkan token akses. Autentikasi dulu lewat OAuth 2.0 (artikel 11). Tanpa token, server membalas 401.
2
Cek apakah pasien sudah ada. Kirim GET /Patient?identifier=...|NIK. Jika Bundle searchset berisi entri, pakai ID yang ada. Jika kosong, lanjut langkah 3.
3
Susun resource. Buat Patient dan Encounter. Beri keduanya fullUrl sementara.
4
Bungkus dalam Bundle transaction dan kirim dengan POST ke alamat dasar server, seperti kode di bawah.
5
Baca response. Server membalas Bundle transaction-response. Cek status tiap entri (misalnya 201 Created) dan simpan ID baru dari location.
📦 POST https://contoh.id/fhir (Bundle transaction)
{
  "resourceType": "Bundle",
  "type": "transaction",
  "entry": [
    {
      "fullUrl": "urn:uuid:11111111-1111-4111-8111-111111111111",
      "resource": {
        "resourceType": "Patient",
        "name": [{ "text": "Siti Aminah" }],
        "gender": "female",
        "birthDate": "1995-04-12"
      },
      "request": { "method": "POST", "url": "Patient" }
    },
    {
      "fullUrl": "urn:uuid:22222222-2222-4222-8222-222222222222",
      "resource": {
        "resourceType": "Encounter",
        "status": "finished",
        "class": {
          "system": "http://terminology.hl7.org/CodeSystem/v3-ActCode",
          "code": "AMB"
        },
        "subject": { "reference": "urn:uuid:11111111-1111-4111-8111-111111111111" }
      },
      "request": { "method": "POST", "url": "Encounter" }
    }
  ]
}
⚠️ Perhatian
Jangan menaruh data pasien asli di contoh latihan atau repositori publik. Pakai data fiktif dan server uji. Pembahasan hukumnya ada di artikel 13 seri ini.

🎯 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.

💬 Menurutmu, kasus apa di fasilitas kesehatan yang paling butuh Bundle transaction? Tulis di kolom komentar, lalu bagikan artikel ini ke teman satu angkatanmu.
💬 Tulis Komentar 🔗 Bagikan Artikel
🏷️ Tag:
#PertukaranData #PertukaranInformasi #Kesehatan #FHIRResourcedanBundle
📂 Label:
Pertukaran Informasi Kesehatan FHIR Resource dan Bundle Request dan Response
📚 Referensi
  1. 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.
  2. HL7 International. (2019). HL7 FHIR Release 4 (v4.0.1): RESTful API, Resource, dan Bundle. https://hl7.org/fhir/R4/
  3. Kementerian Kesehatan Republik Indonesia. (2022). Peraturan Menteri Kesehatan Nomor 24 Tahun 2022 tentang Rekam Medis.
📖 Artikel Utama Seri

Daftar Isi Kuliah Pertukaran Informasi Kesehatan

Lihat seluruh 16 artikel seri ini dalam satu peta belajar.

Buka Daftar Isi →

No comments:

Post a Comment

saifiahmada.com adalah blog belajar programming Indonesia, membahas lengkap materi bahasa pemrograman: code HTML, CSS, Bootstrap, Desain, PHP, MySQL, coding Java, Query, SQL, dan dunia linux