(File Size: 1.37 MB)

BAGIAN I
ARSITEKTUR WEB SERVICE BIOS
Arsitektur web service BIOS :
JSON
BIOS
JSON
Aplikasi Satker
Database
Dashboard
Secara umum, cara kerja Webservice BIOS adalah sebagai berikut :
1.
2.
3.
4.
BIOS akan request token dengan username dan password yang telah diberikan.
Dengan token yang sudah ada, BIOS akan request data berikutnya sebagaimana terlampir.
Data yang di Request adalah Data Layanan dan Data Keuangan
Jika terjadi kegagalan, BIOS akan memberikan log.
Requirement
Penggunaan Arsitektur Teknologi
:
format data representation
Element Data (HTTP atau HTTPS)
:
:
Keamanan
•
Authentifikasi (Oauth):
•
Transport Security (TLS) :
:
Methods
:
Status Code & Response
Error Handling
REST Framework
:
:
:
RESTFul (Representational state transfer)
MVC (Client/Server)
Stateless
Array Steps JSON (JavaScript Object Notation)
Resources Oriented Services dengan URI (Uniform
Resource Identifier) atau URL
JWT (shortened from JSON Web Token) : RFC
JOSE (JSON Object Signatures & Encryption) : Web Key
atau Web Signature
GET data BLU
PUSH referensi kamus data dan trigger update data,
serta tanggal update
Trigger data dengan code response
Error code, contoh : 5xx Server Error
Bebas :
•
Rails Framework for Ruby (Ruby on Rails)
•
Django (Python)
•
Jersey /JAX-RS (Java)
•
Restlet (Java)
•
Sinatra (Ruby)
•
Express.js (JavaScript/Node.js), dll
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 :
No
1
2
Nama
username
password
Type
String
String
Jika sukses, format data sebagai berikut :
No
Nama
Type
1
access_token
String
2
refresh_token
String
Status
Wajib
Wajib
Deskripsi
Diisi dengan username
Diisi dengan password
Status
Wajib
Wajib
Deskripsi
Diisi dengan session ID
Diisi dengan session yang akan digunakan
untuk request access_token kembali
Contoh Response :
{"id":"https://xxx.com", "refresh_token":"5Aep8614iLM.Dq661ePDmPEgaAW9Oh_L3JKkDpB4xReb54_
pZebnUG0h6Sb4KUVDpNtWEofWM39yg==","access_token":"00Dx0000000BV7z!AR8AQP0jITN80ESEsj5EbaZTFG0R
NBaT1cyWk7TrqoDjoNIWQ2ME_sTZzBjfmOE6zMHq6y8PIW4eWze9JksNEkWUl.Cju7m4"}
Format access_token :
Header :
{
"typ": "JWT",
"alg": "HS256"
}
Payload Data :
{
"iat": 1440386575,
"iss": "xxxxxxxxx",
"data": “kode satker”
}
Keterangan :
iat : issued date, Menggunakan Unix epoch (00:00:00 UTC on 1 January 1970).
iss : issued.
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.
Parameter :
No Nama
1
tanggal_update
Type
Date
Status
Wajib
Deskripsi
Diisi tanggal update posisi data layanan kesehatan.
Menggunakan format tanggal (yyyy/mm/dd).
Request ini memiliki format sebagai berikut :
No Nama
Type
Status Deskripsi
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 :
http://bios.djpbn.kemenkeu.go.id/web_services/ref_kel
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”}]
}
2. Layanan Pendidikan
Digunakan untuk mengisi data layanan pendidikan. Metode yang digunakan adalah POST.
Parameter :
No Nama
1
tanggal_update
Type
Date
Status
Wajib
Request ini memiliki format sebagai berikut :
No Nama
Type
Status
1
kode_satker
string
Wajib
2
3
4
tahun
bulan
kode_fakultas
string
string
string
Wajib
Wajib
Wajib
5
kode_program_
studi
string
wajib
6
kode_akreditasi
string
Wajib
7
kode_jurusan
string
wajib
8
tgl_update
Datetime
Wajib
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”}]
}
Deskripsi
Diisi tanggal update posisi data layanan.
Menggunakan format tanggal (yyyy/mm/dd).
Deskripsi
Diisi oleh kode satker BLU (terdiri dari 6 digit). kode
satker dapat dilihat dari menu referensi->Satker BLU
pada aplikasi BIOS
Diisi oleh tahun layanan (terdiri dari 4 digit)
Diisi oleh bulan layanan (terdiri dari 2 digit)
Diisi oleh kode fakultas. Referensi dapat dilihat melalui
link :
http://bios.djpbn.kemenkeu.go.id/web_services/ref_f
akultas
Diisi oleh kode program studi. Referensi dapat dilihat
melalui link :
http://bios.djpbn.kemenkeu.go.id/web_services/ref_p
rgram_studi
Diisi oleh kode akreditasi. Referensi dapat dilihat
melalui link :
http://bios.djpbn.kemenkeu.go.id/web_services/ref_a
kreditasi
Diisi oleh kode jurusan. Referensi dapat dilihat melalui
link :
http://bios.djpbn.kemenkeu.go.id/web_services/ref_j
urusan
Diisi tanggal update data layanan menggunkan format
tanggal (yyyy/mm/dd hh:mi:ss)
3. Layanan Lainnya
Digunakan untuk mengisi data layanan pendidikan. Metode yang digunakan adalah POST.
Parameter :
No Nama
1
tanggal_update
Type
Date
Status
Wajib
Request ini memiliki format sebagai berikut :
No Nama
Type
Status
1
kode_satker
string
Wajib
2
3
4
tahun
bulan
indikator
string
string
string
Wajib
Wajib
Wajib
7
jumlah
string
Wajib
8
tgl_update
Datetime
Wajib
Contoh response :
{
"layanan_lainnya":[
{
"kode_satker":"539060",
"tahun":"2009",
“bulan” : “12”,
"indikator":"0062",
"jumlah":"30",
“tanggal_update”: “2014/31/12 00:00:00”
}
]
}
Deskripsi
Diisi tanggal update posisi data layanan.
Menggunakan format tanggal (yyyy/mm/dd).
Deskripsi
Diisi oleh kode satker BLU (terdiri dari 6 digit). kode
satker dapat dilihat dari menu referensi->Satker BLU
pada aplikasi BIOS
Diisi oleh tahun layanan (terdiri dari 4 digit)
Diisi oleh bulan layanan (terdiri dari 2 digit)
Diisi oleh indikator. Referensi dapat dilihat melalui link
:
http://bios.djpbn.kemenkeu.go.id/web_services/ref_i
ndikator
Diisi jumlah pengguna layanan pada bulan dan tahun
layanan
Diisi tanggal update data layanan menggunkan format
tanggal (yyyy/mm/dd hh:mi:ss)
BAGIAN IV
DATA KEUANGAN
1.
Request Data Penerimaan
Request ini digunakan untuk melakukan request data penerimaan. Methode yang digunakan adalah
POST.
Parameter :
No Nama
Type
Status Deskripsi
1
TanggalUpdate Datetime Wajib Diisi tanggal update posisi saldo data penerimaan.
Menggunakan Unix epoch (00:00:00 UTC on 1 January
1970).
Request ini memiliki format sebagai berikut :
No Nama
Type
Status Deskripsi
1
tanggal
string
Wajib Diisi tanggal posisi saldo data penerimaan.
Menggunakan Unix epoch (00:00:00 UTC on 1 January
1970).
2
kodeAkun
string
Wajib Diisi dengan kode akun.
Referensi kode akun penerimaan dapat dilihat di :
http://lk.bios.djpbn.kemenkeu.go.id/api/services/getReferensiAkunPe
nerimaan
3
Saldo
number
Wajib
4
TanggalUpdate
Datetime
Wajib
Diisi dengan jumlah akumulasi saldo penerimaan per
kode akun dari tanggal 1 januari sampai dengan tanggal
pada field tanggal
Diisi tanggal update posisi saldo data penerimaan.
Menggunakan Unix epoch (00:00:00 UTC on 1 January
1970).
Contoh Response:
[{
"Penerimaan": [],
"Tanggal": "2017-01-24T00:00:00",
"KodeAkun": "424919",
"Saldo": 987654321,
"TanggalUpdate": "2017-01-23T00:00:00"
}, {
"Penerimaan": [],
"Tanggal": "2017-01-24T00:00:00",
"KodeAkun": "424914",
"Saldo": 987654321,
"TanggalUpdate": "2017-01-23T00:00:00"
}, {
"Penerimaan": [],
"Tanggal": "2017-01-24T00:00:00",
"KodeAkun": "424913",
"Saldo": 987654321,
"TanggalUpdate": "2017-01-23T00:00:00"
}]
2.
Request Data Pengeluaran
Request ini digunakan untuk melakukan request data pengeluaran. Methode yang digunakan adalah
POST.
Parameter :
No Nama
1
TanggalUpdate
Type
Datetime
Status
Wajib
Deskripsi
Diisi tanggal update posisi saldo data pengeluaran.
Menggunakan Unix epoch (00:00:00 UTC on 1 January
1970).
Request ini memiliki format sebagai berikut :
No Nama
Type
Status Deskripsi
1
tanggal
string
Wajib Diisi tanggal posisi saldo data pengeluaran.
Menggunakan Unix epoch (00:00:00 UTC on 1 January
1970).
2
kodeAkun
string
Wajib Diisi dengan kode akun.
Referensi kode akun pengeluaran dapat dilihat di :
http://lk.bios.djpbn.kemenkeu.go.id/api/services/getReferensiAkunPe
ngeluaran
3
Saldo
number
Wajib
4
TanggalUpdate
Datetime
Wajib
Diisi dengan jumlah akumulasi saldo pengeluaran per
kode akun dari tanggal 1 januari sampai dengan tanggal
pada field tanggal
Diisi tanggal update posisi saldo data pengeluaran.
Menggunakan Unix epoch (00:00:00 UTC on 1 January
1970).
Contoh:
[{
"Pengeluaran": [],
"Tanggal": "2017-01-24T00:00:00",
"KodeAkun": "424919",
"Saldo": 987654321,
"TanggalUpdate": "2017-01-23T00:00:00"
}, {
"Pengeluaran": [],
"Tanggal": "2017-01-24T00:00:00",
"KodeAkun": "424914",
"Saldo": 987654321,
"TanggalUpdate": "2017-01-23T00:00:00"
}, {
"Pengeluaran": [],
"Tanggal": "2017-01-24T00:00:00",
"KodeAkun": "424913",
"Saldo": 987654321,
"TanggalUpdate": "2017-01-23T00:00:00"
}]
3.
Request Data Saldo
Request ini digunakan untuk melakukan request data saldo rekening per Bank per Jenis Rekening.
Methode yang digunakan adalah POST.
Parameter :
No Nama
1
TanggalUpdate
Type
Datetime
Status
Wajib
Deskripsi
Diisi tanggal update posisi saldo. Menggunakan Unix
epoch (00:00:00 UTC on 1 January 1970).
Request ini memiliki format sebagai berikut :
No Nama
Type
Status
1
tanggal
string
Wajib
2
kodeJenisRekening
string
Wajib
Deskripsi
Diisi tanggal posisi saldo. Menggunakan Unix epoch
(00:00:00 UTC on 1 January 1970).
Diisi dengan kode akun.
Referensi kode Jenis Rekening dapat dilihat di :
http://lk.bios.djpbn.kemenkeu.go.id/api/services/getReferensiJeni
sRekening
3
4
NamaBank
Saldo
String
number
Wajib
Wajib
5
TanggalUpdate
Datetime
Wajib
Contoh Response:
[{
"SaldoBLU": [],
"Tanggal": "2017-01-24T00:00:00",
"KodeJenisRekening": "1",
"NamaBank": "Bank ABC",
"Saldo": 987654321,
"TanggalUpdate": "2017-01-23T00:00:00"
}, {
"SaldoBLU": [],
"Tanggal": "2017-01-24T00:00:00",
"KodeJenisRekening": "1",
"NamaBank": "Bank DEF",
"Saldo": 987654321,
"TanggalUpdate": "2017-01-23T00:00:00"
},]
Diisi dengan nama Bank
Diisi dengan jumlah akumulasi saldo Jenis Rekening
per Bank, dari tanggal 1 januari sampai dengan
tanggal pada field tanggal
Diisi tanggal update posisi saldo. Menggunakan Unix
epoch (00:00:00 UTC on 1 January 1970).
BAGIAN V
LOG
Log merupakan summary hasil proses web service seperti pesan gagal saat proses. Log akan di sediakan oleh
BIOS melalui uri http://bios.djpbn.kemenkeu.go.id/web_services/log. Methode yang digunakan adalah POST.
Parameter :
No
1
2
3
Nama
Tanggal
Username
Password
Type
Datetime
String
String
Status
Wajib
Wajib
Wajib
Contoh response yang akan didapatkan :
[{
"log": [],
“Tanggal": "2017-01-24T00:00:00",
"summary": "authenticate failed",
"errordetail": server error 500
}, {
"log": [],
"Tanggal": "2017-01-24T00:00:00",
"summary": "authenticate failed",
"errordetail": server error 403
}, {
" log ": [],
"Tanggal": "2017-01-24T00:00:00",
"summary": "authenticate failed",
"errordetail": access denied
}]
Deskripsi
Diisi tanggal log.
Diisi username aplikasi bios.djpbn.kemenkeu.go.id
Diisi username aplikasi bios.djpbn.kemenkeu.go.id
LIST REFERENSI
No
1
Uraian
Kode Fakultas
Link
http://bios.djpbn.kemenkeu.go.id/web_services/ref_fakultas
2
Kode Akreditasi
http://bios.djpbn.kemenkeu.go.id/web_services/ref_akreditasi
3
Kode Jurusan
http://bios.djpbn.kemenkeu.go.id/web_services/ref_jurusan
4
Kode Kelas
http://bios.djpbn.kemenkeu.go.id/web_services/ref_kelas
5
Kode Indikator
http://bios.djpbn.kemenkeu.go.id/web_services/ref_indikator
6
Akun Penerimaan
http://lk.bios.djpbn.kemenkeu.go.id/api/services/getReferensiAkunPenerimaan
7
Akun Pengeluaran
http://lk.bios.djpbn.kemenkeu.go.id/api/services/getReferensiAkunPengeluaran
8
Jenis Rekening
http://lk.bios.djpbn.kemenkeu.go.id/api/services/getReferensiJenisRekening
Keterangan