JSON, XML, dan HTTP/HTTPS: Membaca Isi "Paket Data" yang Dikirim Antar-Sistem
Buka "paket" yang dikirim antar-sistem kesehatan, lalu pahami isinya, jalurnya, dan gemboknya.
Pernah bertanya-tanya, apa yang sebenarnya terbang di antara aplikasi rumah sakit dan SATUSEHAT saat data pasien dikirim? Bukan sihir, melainkan "paket data" yang punya format, jalur, dan gembok. Memahami JSON XML HTTP HTTPS berarti kamu bisa membuka paket itu sendiri: tahu isinya, tahu jalannya, tahu apakah aman.
Kalau kamu mahasiswa D4 MIK yang kelak membangun, menguji, atau mengaudit integrasi sistem informasi kesehatan, ini artikel untukmu. Tulisan ini adalah bagian dari seri Pertukaran Informasi Kesehatan, melanjutkan pembahasan API dan REST API. Siapkan kopi, kita bedah paketnya.
JSON XML HTTP HTTPS: Siapa Mengerjakan Apa?
Bayangkan kamu mengirim paket lewat kurir. Ada tiga hal yang perlu jelas: bagaimana isi ditulis di surat, aturan pengiriman kurirnya, dan apakah paketnya digembok. Dalam pertukaran data kesehatan, pembagian tugasnya persis begitu.
HTTP = aturan kurir (siapa minta apa, siapa menjawab apa)
HTTPS = HTTP + gembok enkripsi TLS (paket tidak bisa dibaca di jalan)
Secara teknis, JSON didefinisikan dalam RFC 8259 sebagai format pertukaran data berbasis teks (Bray, 2017). XML adalah rekomendasi W3C berupa bahasa markup dengan tag pembuka dan penutup (Bray et al., 2008). Lalu HTTP adalah protokol permintaan-jawaban yang semantiknya dirinci dalam RFC 9110 (Fielding et al., 2022), sedangkan HTTPS adalah HTTP yang berjalan di atas TLS (Rescorla, 2000).
JSON vs XML: Dua Cara Menulis Data Pasien yang Sama
Kita pakai satu contoh data fiktif: pasien bernama Siti, lahir 1990, perempuan. Perhatikan bahwa isinya identik, hanya cara penulisannya yang beda. Pertama, versi JSON (disederhanakan dari resource Patient FHIR):
Kedua, versi XML dengan data yang sama:
Tabel Perbandingan JSON dan XML
| Aspek | JSON | XML |
|---|---|---|
| Penulisan | Pasangan kunci-nilai, kurung kurawal | Tag pembuka dan penutup |
| Ukuran | Cenderung lebih ringkas | Cenderung lebih panjang karena tag |
| Keterbacaan manusia | Mudah untuk data sederhana | Eksplisit, cocok untuk dokumen terstruktur |
| Media type | application/json | application/xml |
| Contoh di kesehatan | API FHIR modern, aplikasi mobile | Dokumen HL7 CDA, sistem lama |
HTTP dan HTTPS: Amplop Terbuka vs Amplop Bergembok
Kalau JSON atau XML adalah isi surat, maka HTTP adalah tata cara kurir bekerja: klien mengirim request, server membalas dengan response. Setiap request membawa method (misalnya GET untuk membaca, POST untuk membuat) dan setiap response membawa status code. Itu kode singkat yang memberi tahu hasil pengiriman (Fielding et al., 2022).
Dalam API FHIR, method HTTP punya padanan operasi yang mudah diingat: GET untuk membaca data pasien, POST untuk membuat data baru, PUT untuk memperbarui, dan DELETE untuk menghapus (HL7 International, 2019). Jadi ketika kamu melihat log integrasi bertuliskan POST /Patient, kamu langsung tahu ada sistem yang sedang mencoba mendaftarkan pasien baru. Bayangkan seperti slip pengiriman: kata kerjanya sudah menjelaskan niat si pengirim sebelum kamu membuka isi paketnya.
Dua header berperan sebagai "label di luar paket". Header Accept menyatakan format apa yang diminta klien, sedangkan Content-Type menyatakan format apa yang sebenarnya dikirim. Kalau kedua label ini tidak cocok, server bisa menolak permintaan dengan kode 4xx, atau parser di sisi penerima gagal membaca isi. Banyak kasus "datanya sudah dikirim tapi tidak masuk" ternyata hanya bersumber dari label yang keliru, bukan dari datanya.
| Kode | Arti | Analogi kurir |
|---|---|---|
| 200 OK | Permintaan berhasil | Paket diterima baik |
| 201 Created | Data baru berhasil dibuat | Paket tercatat sebagai dokumen baru |
| 400 Bad Request | Format permintaan salah | Alamat di surat tidak terbaca |
| 401 Unauthorized | Identitas belum terverifikasi | Kamu belum menunjukkan KTP |
| 403 Forbidden | Terdaftar, tapi tidak berhak | Ada KTP, tapi bukan areamu |
| 404 Not Found | Data tidak ditemukan | Alamat tujuan tidak ada |
| 500 Server Error | Masalah di sisi server | Gudang kurir sedang kacau |
Lalu bagaimana dengan HTTPS? Pada HTTP biasa, isi paket berjalan sebagai teks terbuka sehingga bisa dibaca pihak yang menyadap jalur jaringan. HTTPS membungkusnya dengan enkripsi TLS (Rescorla, 2000; Rescorla, 2018). Itu sebabnya data pasien, yang termasuk kategori sensitif, tidak patut dikirim lewat HTTP polos. Kamu bisa mengenalinya dari awalan https:// dan ikon gembok di peramban.
Cara kerjanya kira-kira begini. Sebelum paket dikirim, klien dan server melakukan "jabat tangan" TLS: server menunjukkan sertifikat sebagai bukti identitas, lalu keduanya menyepakati kunci rahasia untuk mengenkripsi percakapan (Rescorla, 2018). Sertifikat itu seperti kartu identitas kurir resmi. Tanpa sertifikat yang valid, peramban akan memperingatkanmu, dan peringatan itu jangan pernah kamu abaikan begitu saja saat menguji sistem kesehatan.
Sebagai mahasiswa D4 MIK, ada tiga kebiasaan yang bisa kamu terapkan mulai hari ini. Pertama, selalu cek awalan alamat endpoint sebelum mengirim data. Kedua, jangan pernah menaruh token atau kata sandi di alamat URL, karena alamat sering tercatat di log server. Ketiga, minta dokumentasi API dari vendor dan baca bagian format data serta kebijakan keamanannya sebelum integrasi dimulai.
Praktik Membaca "Paket Data" JSON XML HTTP HTTPS Langkah demi Langkah
Sekarang kita praktik. Kamu akan meminta data dari server uji FHIR publik, lalu membaca respons-nya seperti seorang analis integrasi. Server uji HAPI FHIR menyediakan data simulasi, jadi aman untuk latihan.
curl --version untuk memastikan curl tersedia.-i menampilkan header respons, bukan hanya isinya.HTTP/2 200. Angka 200 berarti sukses; kalau muncul 4xx, masalahnya ada di permintaanmu, dan kalau 5xx, masalahnya ada di server.Content-Type. Header ini menyebut format isi paket, misalnya application/fhir+json. Dari sini kamu tahu apakah server benar-benar mengirim JSON seperti yang kamu minta.Accept menjadi XML. Ganti application/fhir+json dengan application/fhir+xml, jalankan ulang, lalu bandingkan. Data sama, bungkus berbeda. Kamu baru saja membuktikan tabel perbandingan tadi.https:// menjadi http://. Amati apakah server memaksa pengalihan ke HTTPS atau menolak. Catat hasilnya sebagai bahan diskusi kelas.Content-Type, (3) validitas sintaks JSON/XML, (4) isi data. Urutan ini menghemat banyak waktu dibanding langsung menyalahkan kodenya.Kesimpulan: Kamu Kini Bisa Membuka Paketnya
Memahami JSON XML HTTP HTTPS memberimu peta lengkap tentang bagaimana data kesehatan berpindah antar-sistem:
- JSON dan XML adalah format isi: JSON lebih ringkas, XML lebih eksplisit.
- HTTP mengatur dialog permintaan-jawaban lewat method dan status code.
- HTTPS menambah enkripsi TLS agar data pasien tidak terbaca di jalan.
- Membaca respons secara urut (status, header, sintaks, isi) membuat debugging jauh lebih cepat.
Menurutmu, format mana yang lebih nyaman kamu pakai, JSON atau XML? Tulis alasanmu di kolom komentar, dan bagikan artikel ini ke teman satu angkatan yang masih bingung membedakan keduanya.
💬 Tulis Komentar 📤 Bagikan Artikel- Bray, T. (Ed.). (2017). The JavaScript Object Notation (JSON) Data Interchange Format (RFC 8259). Internet Engineering Task Force.
- Bray, T., Paoli, J., Sperberg-McQueen, C. M., Maler, E., & Yergeau, F. (2008). Extensible Markup Language (XML) 1.0 (Fifth Edition). W3C Recommendation.
- Fielding, R., Nottingham, M., & Reschke, J. (Eds.). (2022). HTTP Semantics (RFC 9110). Internet Engineering Task Force.
- HL7 International. (2019). FHIR Release 4: RESTful API. https://hl7.org/fhir/R4/http.html
- Rescorla, E. (2000). HTTP Over TLS (RFC 2818). Internet Engineering Task Force.
- Rescorla, E. (2018). The Transport Layer Security (TLS) Protocol Version 1.3 (RFC 8446). Internet Engineering Task Force.
- Peraturan Menteri Kesehatan Republik Indonesia Nomor 24 Tahun 2022 tentang Rekam Medis.
- Undang-Undang Republik Indonesia Nomor 27 Tahun 2022 tentang Pelindungan Data Pribadi.
Pertukaran Informasi Kesehatan
Artikel ini adalah bagian dari seri kuliah D4 MIK. Lihat daftar isi lengkap seluruh 16 artikel di bawah.
📚 Buka Daftar Isi Kuliah
No comments:
Post a Comment