BAGIAN I ARSITEKTUR WEB SERVICE BIOS. Aplikasi Satker Database. Dashboard

Ukuran: px

Mulai penontonan dengan halaman:

Download "BAGIAN I ARSITEKTUR WEB SERVICE BIOS. Aplikasi Satker Database. Dashboard"

Lanny Sugiarto
7 tahun lalu
Tontonan:

BAGIAN I ARSITEKTUR WEB SERVICE BIOS Arsitektur web service BIOS : JSON JSON BIOS Aplikasi Satker Database Dashboard Secara umum, cara kerja Webservice BIOS adalah sebagai berikut : 1.

2 BAGIAN I ARSITEKTUR WEB SERVICE BIOS Arsitektur web service BIOS : JSON JSON BIOS Aplikasi Satker Database Dashboard Secara umum, cara kerja Webservice BIOS adalah sebagai berikut : 1. BIOS akan request token dengan username dan password yang telah diberikan. 2. Dengan token yang sudah ada, BIOS akan request data berikutnya sebagaimana terlampir. 3. Data yang di Request adalah Data Layanan dan Data Keuangan 4. Jika terjadi kegagalan, BIOS akan memberikan log. Requirement Penggunaan Arsitektur Teknologi : RESTFul (Representational state transfer) MVC (Client/Server) Stateless format data representation : Array Steps JSON (JavaScript Object Notation) Element Data (HTTP atau HTTPS) : Resources Oriented Services dengan URI (Uniform Resource Identifier) atau URL Keamanan Authentifikasi (Oauth): : JWT (shortened from JSON Web Token) : RFC Transport Security (TLS): JOSE (JSON Object Signatures & Encryption) : Web Key atau Web Signature Methods : GET data BLU PUSH referensi kamus data dan trigger update data, serta tanggal update Status Code & Response : Trigger data dengan code response Error Handling : Error code, contoh : 5xx Server Error REST Framework : Bebas : Rails Framework for Ruby (Ruby on Rails) Django (Python) Jersey /JAX-RS(Java) Restlet (Java) Sinatra (Ruby) Express.js (JavaScript/Node.js), dll

3 BAGIAN II REQUEST TOKEN Request token bersifat optional (pilihan) bagi satuan kerja BLU yang mengembangkan web service dengan memerlukan autentifikasi saat melakukan requset dari BIOS (JWT). Request ini digunakan untuk mendapatkan token untuk autentikasi request-request selanjutnya. Methode yang digunakan adalah POST. Request ini memiliki format sebagai berikut : 1 username String Wajib Diisi dengan username 2 password String Wajib Diisi dengan password Jika sukses, format data sebagai berikut : 1 access_token String Wajib Diisi dengan session ID 2 refresh_token String Wajib Diisi dengan session yang akan digunakan untuk request access_token kembali Contoh Response : {"id":" "refresh_token":"5aep8614ilm.dq661epdmpegaaw9oh_l3jkkdpb4xreb54_ pzebnug0h6sb4kuvdpntweofwm39yg==","access_token":"00dx bv7z!ar8aqp0jitn80esesj5ebaztfg0r NBaT1cyWk7TrqoDjoNIWQ2ME_sTZzBjfmOE6zMHq6y8PIW4eWze9JksNEkWUl.Cju7m4" Format access_token : Header : { "typ": "JWT", "alg": "HS256" Payload Data : { "iat": , "iss": "xxxxxxxxx", "data": kode satker Keterangan : iat : issued date, iss : issued.

4 BAGIAN III DATA LAYANAN Data layanan pada BIOS dapat disi menggunakan metode web service. Dibagi menjadi tiga ketegori yaitu sebagai berikut : 1. Layanan Kesehatan diperuntukan bagi satuan kerja BLU rumpun kesehatan; 2. Layanan Pendidikan diperuntukan bagi satuan kerja BLU rumpun pendidikan; 3. Layanan Lainnya diperuntukan bagi seluruh satuan kerja BLU sesuai indikator. Format data untuk masing-masing rumpun dapat dijelaskan sebagai berikut 1. Layanan Kesehatan Digunakan untuk mengisi data layanan kesehatan. Metode yang digunakan adalah POST. 1 tanggal_update Date Wajib Diisi tanggal update posisi data layanan kesehatan. Menggunakan format tanggal (yyyy/mm/dd). 1 kode_satker string Wajib Diisi oleh kode satker BLU (terdiri dari 6 digit). kode satker dapat dilihat dari menu referensi->satker BLU pada aplikasi BIOS 2 tahun string Wajib Diisi oleh tahun layanan (terdiri dari 4 digit) 3 bulan string Wajib Diisi oleh bulan layanan (terdiri dari 2 digit) 4 kelas string Wajib Diisi oleh kode kelas layanan. Referensi kelas layanan dapat dilihat melalui link : as 5 jumlah_pasien string Wajib Diisi oleh jumlah pasien 6 Jumlah_hari string Wajib Diisi oleh jumlah hari layanan 7 tgl_update Datetime Wajib Diisi tanggal update data layanan menggunkan format tanggal (yyyy/mm/dd hh:mi:ss) Contoh response : {"layanan_kesehatan":[ { "kode_satker":"415423", "tahun":"2012", bulan : 12, "kelas":"01", "jumlah_pasien":"5", "jumlah_hari":"6", tgl_update : 2014/31/12 00:00:00 ]

5 2. Layanan Pendidikan Digunakan untuk mengisi data layanan pendidikan. Metode yang digunakan adalah POST. 1 tanggal_update Date Wajib Diisi tanggal update posisi data layanan. Menggunakan format tanggal (yyyy/mm/dd). 1 kode_satker string Wajib Diisi oleh kode satker BLU (terdiri dari 6 digit). kode satker dapat dilihat dari menu referensi->satker BLU pada aplikasi BIOS 2 tahun string Wajib Diisi oleh tahun layanan (terdiri dari 4 digit) 3 bulan string Wajib Diisi oleh bulan layanan (terdiri dari 2 digit) 4 kode_fakultas string Wajib Diisi oleh kode fakultas. Referensi dapat dilihat melalui link : akultas 5 kode_program_ studi string wajib Diisi oleh kode program studi. Referensi dapat dilihat melalui link : rgram_studi 6 kode_akreditasi string Wajib Diisi oleh kode akreditasi. Referensi dapat dilihat melalui link : kreditasi 7 kode_jurusan string wajib Diisi oleh kode jurusan. Referensi dapat dilihat melalui link : urusan 8 tgl_update Datetime Wajib Diisi tanggal update data layanan menggunkan format tanggal (yyyy/mm/dd hh:mi:ss) Contoh response : { "layanan_pendidikan":[{ "kode_satker":"189662", "tahun":"2016", bulan : 12, "kode_fakultas":"01", "kode_program_studi":"09", "kode_akreditasi":"b", "kode_jurusan":"188", tanggal_update : 2014/31/12 00:00:00 ]

6 3. Layanan Lainnya Digunakan untuk mengisi data layanan pendidikan. Metode yang digunakan adalah POST. 1 tanggal_update Date Wajib Diisi tanggal update posisi data layanan. Menggunakan format tanggal (yyyy/mm/dd). 1 kode_satker string Wajib Diisi oleh kode satker BLU (terdiri dari 6 digit). kode satker dapat dilihat dari menu referensi->satker BLU pada aplikasi BIOS 2 tahun string Wajib Diisi oleh tahun layanan (terdiri dari 4 digit) 3 bulan string Wajib Diisi oleh bulan layanan (terdiri dari 2 digit) 4 indikator string Wajib Diisi oleh indikator. Referensi dapat dilihat melalui link : ndikator 7 jumlah string Wajib Diisi jumlah pengguna layanan pada bulan dan tahun layanan 8 tgl_update Datetime Wajib Diisi tanggal update data layanan menggunkan format tanggal (yyyy/mm/dd hh:mi:ss) Contoh response : { "layanan_lainnya":[ { "kode_satker":"539060", "tahun":"2009", bulan : 12, "indikator":"0062", "jumlah":"30", ] tanggal_update : 2014/31/12 00:00:00

7 BAGIAN IV DATA KEUANGAN 1. Request Data Penerimaan Request ini digunakan untuk melakukan request data penerimaan. Methode yang digunakan adalah POST. 1 TanggalUpdate Datetime Wajib Diisi tanggal update posisi saldo data penerimaan. 1 tanggal string Wajib Diisi tanggal posisi saldo data penerimaan. 2 kodeakun string Wajib Diisi dengan kode akun. Referensi kode akun penerimaan dapat dilihat di : nerimaan 3 Saldo number Wajib Diisi dengan jumlah akumulasi saldo penerimaan per kode akun dari tanggal 1 januari sampai dengan tanggal pada field tanggal 4 TanggalUpdate Datetime Wajib Diisi tanggal update posisi saldo data penerimaan. Contoh Response: [{ "Penerimaan": [], "KodeAkun": "424919", "Penerimaan": [], "KodeAkun": "424914", "Penerimaan": [], "KodeAkun": "424913", ] 2. Request Data Pengeluaran Request ini digunakan untuk melakukan request data pengeluaran. Methode yang digunakan adalah POST.

8 1 TanggalUpdate Datetime Wajib Diisi tanggal update posisi saldo data pengeluaran. 1 tanggal string Wajib Diisi tanggal posisi saldo data pengeluaran. 2 kodeakun string Wajib Diisi dengan kode akun. Referensi kode akun pengeluaran dapat dilihat di : ngeluaran 3 Saldo number Wajib Diisi dengan jumlah akumulasi saldo pengeluaran per kode akun dari tanggal 1 januari sampai dengan tanggal pada field tanggal 4 TanggalUpdate Datetime Wajib Diisi tanggal update posisi saldo data pengeluaran. Contoh: [{ "Pengeluaran": [], "KodeAkun": "424919", "Pengeluaran": [], "KodeAkun": "424914", "Pengeluaran": [], "KodeAkun": "424913", ] 3. Request Data Saldo Request ini digunakan untuk melakukan request data saldo rekening per Bank per Jenis Rekening. Methode yang digunakan adalah POST. 1 TanggalUpdate Datetime Wajib Diisi tanggal update posisi saldo. Menggunakan Unix epoch (00:00:00 UTC on 1 January 1 tanggal string Wajib Diisi tanggal posisi saldo. Menggunakan Unix epoch (00:00:00 UTC on 1 January 2 kodejenisrekening string Wajib Diisi dengan kode akun.

9 Referensi kode Jenis Rekening dapat dilihat di : srekening 3 NamaBank String Wajib Diisi dengan nama Bank 4 Saldo number Wajib Diisi dengan jumlah akumulasi saldo Jenis Rekening per Bank, dari tanggal 1 januari sampai dengan tanggal pada field tanggal 5 TanggalUpdate Datetime Wajib Diisi tanggal update posisi saldo. Menggunakan Unix epoch (00:00:00 UTC on 1 January Contoh Response: [{ "SaldoBLU": [], "KodeJenisRekening": "1", "NamaBank": "Bank ABC", "SaldoBLU": [], "KodeJenisRekening": "1", "NamaBank": "Bank DEF",,]

10 BAGIAN V LOG Log merupakan summary hasil proses web service seperti pesan gagal saat proses. Log akan di sediakan oleh BIOS melalui uri Methode yang digunakan adalah POST. 1 Tanggal Datetime Wajib Diisi tanggal log. 2 Username String Wajib Diisi username aplikasi bios.djpbn.kemenkeu.go.id 3 Password String Wajib Diisi username aplikasi bios.djpbn.kemenkeu.go.id Contoh response yang akan didapatkan : [{ "log": [], Tanggal": " T00:00:00", "summary": "authenticate failed", "errordetail": server error 500 "log": [], "summary": "authenticate failed", "errordetail": server error 403 " log ": [], "summary": "authenticate failed", "errordetail": access denied ]

11 LIST REFERENSI No Uraian Link Keterangan 1 Kode Fakultas 2 Kode Akreditasi 3 Kode Jurusan 4 Kode Kelas 5 Kode Indikator 6 Akun Penerimaan 7 Akun Pengeluaran 8 Jenis Rekening

dokumen-dokumen yang mirip

REVISI BLU REST FORMAT WEBSERVICE

REVISI BLU REST FORMAT WEBSERVICE AKSES PORT Port yang digunakan dalam webservice hanya port 80 (http) atau 443 (secure http). PENGGUNAAN METHOD 1. Webservice Layanan BLU Menggunakan Metode Get tanpa JSON