Uji, Evaluasi, dan Cari Biang Keroknya: Pengujian API serta Identifikasi Kesalahan Integrasi
Cara memastikan dua sistem kesehatan benar-benar "nyambung", dan melacak sumber masalahnya saat tidak.
Bayangkan ini: aplikasi rekam medis rumah sakit kamu sudah dinyatakan "terhubung" dengan platform nasional. Seminggu kemudian, ratusan data pasien ternyata tidak pernah sampai, dan tidak ada satu pun pesan error yang muncul. Siapa yang salah? Servernya, datanya, atau kamu?
Jawabannya hanya bisa kamu temukan lewat pengujian API interoperabilitas: proses sistematis untuk memastikan dua sistem kesehatan bertukar data dengan benar, bukan sekadar "tidak error". Ini artikel penutup seri Pertukaran Informasi Kesehatan, dan kamu akan belajar menguji endpoint FHIR, membaca sinyal kegagalan, lalu mencari biang keroknya seperti detektif.
Mengapa Pengujian API Interoperabilitas Tidak Boleh Dilewatkan
Analogi sederhananya begini: dua orang bisa sama-sama berbicara, tetapi belum tentu saling mengerti. Telepon tersambung (itu urusan jaringan), bahasanya sama-sama Indonesia (itu urusan format), tetapi saat satu pihak bilang "tensi 120" dan pihak lain mengira itu nomor kamar, komunikasi tetap gagal (itu urusan makna). API kesehatan punya tiga lapis masalah yang sama.
Di Indonesia, urgensinya nyata. Permenkes Nomor 24 Tahun 2022 tentang Rekam Medis mewajibkan fasilitas pelayanan kesehatan menyelenggarakan rekam medis elektronik yang mampu bertukar data lewat platform yang ditetapkan Kementerian Kesehatan (Kemenkes RI, 2022). Artinya, "asal jalan" tidak cukup. Integrasi kamu harus terbukti benar.
POST pertama kamu langsung ke server produksi berisi data pasien asli.Empat Lapis Pengujian API Interoperabilitas yang Perlu Kamu Kuasai
Seperti memeriksa pasien, kamu tidak langsung ke pemeriksaan penunjang. Mulai dari tanda vital, baru turun ke detail. Pengujian API juga berlapis:
Tim sering berhenti di status 200 OK dan merayakannya. Padahal server bisa menerima JSON yang bentuknya valid, tetapi isinya salah makna, misalnya kode diagnosis yang tidak ada di terminologi rujukan. Sistem tidak menolak, tetapi data hilang manfaatnya.
Kesimpulan analisis: status HTTP hanya membuktikan lapis 1 dan 2. Lapis 3 dan 4 butuh pengecekan isi secara eksplisit. Konsep ini sejalan dengan prinsip piramida pengujian: perbanyak tes cepat di dasar, tambahkan tes alur di puncak (Cohn, 2009).
OperationOutcome khusus untuk melaporkan masalah, lengkap dengan tingkat keparahan, kode, dan lokasi elemen yang bermasalah (HL7, 2019). Jangan abaikan isinya, karena di sanalah petunjuk pertamamu.Langkah Praktis Pengujian API Interoperabilitas pada Endpoint FHIR
Sekarang kita praktik. Skenarionya: kamu mengirim data pasien dari SIMRS ke server FHIR. Ikuti lima langkah berikut.
Buat 3 pasien dummy: satu normal, satu dengan data minimal, satu sengaja salah. Simpan token dan base URL sebagai variabel environment, jangan ditulis langsung di request.
Pakai
curl -i supaya header ikut tampil. Perhatikan kode status, header Location, dan Content-Type.Mengetik ulang pengecekan secara manual itu melelahkan dan rawan lupa. Tulis asersi di Postman supaya setiap request menguji dirinya sendiri (Postman, 2024).
Kirim pasien tanpa
identifier, tanggal lahir berformat 12-04-1995, dan token kedaluwarsa. Sistem yang baik menolak dengan jelas, bukan diam-diam menerima.Validasi resource terhadap profil FHIR memakai validator resmi HL7, lalu jalankan seluruh koleksi tes setiap kali ada perubahan versi API atau pemetaan data.
Cari Biang Keroknya: Identifikasi Kesalahan dalam Pengujian API Interoperabilitas
Saat tes merah, jangan panik dan jangan langsung mengubah kode. Dokter tidak memberi obat sebelum anamnesis, begitu juga kamu. Mulai dari gejala, kerucutkan penyebab. Berikut peta cepatnya, berdasarkan kode status HTTP standar (Fielding et al., 2022) dan perilaku FHIR (HL7, 2019):
422 saat resource valid secara sintaksis tetapi melanggar aturan profil atau aturan bisnis (HL7, 2019). Jadi bedakan: 400 berarti "bentuknya rusak", 422 berarti "bentuknya benar, isinya tidak sah".Contoh respons error yang berguna. Perhatikan field expression yang menunjuk lokasi masalah:
Saat sumber error tidak jelas, persempit dengan membagi alur menjadi dua bagian, lalu uji titik tengahnya. Alur kamu: Tabel SIMRS → Pemetaan → JSON FHIR → Request → Server.
Cek dulu JSON hasil pemetaan sebelum dikirim. Jika JSON sudah valid, masalah ada di request atau server. Jika JSON sudah salah, masalah ada di pemetaan atau tabel sumber. Dua atau tiga kali pembagian biasanya cukup untuk menemukan titik bermasalah, tanpa menebak-nebak.
Evaluasi Hasil Uji: Jangan Berhenti di "Hijau Semua"
Menjalankan tes itu baru setengah pekerjaan. Setengah lainnya adalah evaluasi: kamu menilai apakah hasil uji benar-benar menjawab kebutuhan layanan. Bayangkan petugas laboratorium yang sudah mengukur kadar gula darah tetapi tidak pernah membandingkannya dengan nilai rujukan. Angkanya ada, tetapi belum ada keputusan klinis. Pengujian integrasi bekerja sama persis.
Gunakan tiga ukuran sederhana untuk mengevaluasi hasil pengujian API interoperabilitas kamu:
- Tingkat keberhasilan transaksi: berapa persen request uji yang berakhir sesuai harapan, termasuk request yang memang seharusnya ditolak. Hitung dari seluruh skenario, bukan hanya skenario yang sukses.
- Cakupan resource: berapa jenis resource FHIR yang sudah kamu uji, dibandingkan dengan yang dipakai dalam alur layanan (misalnya
Patient,Encounter,Observation). - Waktu penyelesaian masalah: berapa lama tim menemukan penyebab sebuah kegagalan. Angka ini turun drastis kalau log dan skrip tes rapi.
Catat ketiganya setiap putaran uji, lalu bandingkan dari waktu ke waktu. Tren yang membaik membuktikan integrasi kamu makin matang. Tren yang stagnan menandakan ada pola kesalahan yang berulang dan perlu dibenahi di akar masalahnya, misalnya di tabel pemetaan yang kamu rancang pada artikel sebelumnya.
Ingat juga: tes yang gagal di lingkungan uji adalah kabar baik, karena masalah tertangkap sebelum menyentuh pasien. Tambahkan setiap kegagalan sebagai skenario baru ke koleksi tes supaya kesalahan yang sama tidak lolos dua kali. Terakhir, dokumentasikan temuanmu dalam laporan singkat: skenario yang diuji, hasilnya, akar masalah, dan tindakan perbaikan. Laporan inilah yang membuat pengujian kamu bisa diaudit dan dipelajari tim lain.
๐ Kesimpulan: Dari "Asal Jalan" ke "Terbukti Benar"
Pengujian API interoperabilitas bukan formalitas di ujung proyek. Ini cara kamu membuktikan bahwa data kesehatan benar-benar sampai dan bermakna sama di dua sistem. Poin yang perlu kamu bawa pulang:
- Uji empat lapis: konektivitas, sintaksis, semantik, dan alur proses.
- Status
200 OKbelum cukup. Periksa isi respons. - Sengaja uji jalur gagal untuk melihat sistem menolak dengan benar.
- Baca
OperationOutcomedan lacak dengan metode bagi dua.
Dengan kebiasaan ini, kamu menutup seri Pertukaran Informasi Kesehatan bukan hanya paham teori, tetapi juga siap bertugas sebagai profesional MIK yang menjaga integrasi tetap sehat.
- Cohn, M. (2009). Succeeding with Agile: Software Development Using Scrum. Addison-Wesley.
- Fielding, R., Nottingham, M., & Reschke, J. (2022). RFC 9110: HTTP Semantics. IETF. rfc-editor.org/rfc/rfc9110
- HL7 International. (2019). FHIR Release 4: HTTP dan OperationOutcome. hl7.org/fhir/R4/http.html
- Kementerian Kesehatan RI. (2022). Peraturan Menteri Kesehatan Nomor 24 Tahun 2022 tentang Rekam Medis.
- Postman. (2024). Writing tests and scripts, Postman Learning Center. learning.postman.com
No comments:
Post a Comment