Katalog Webservice JKN - RSQIM Versi 1.0

Secara umum, hampir setiap pemanggilan web-service, harus dicantumkan beberapa variabel yang dibutuhkan untuk menambahkan informasi ataupun untuk proses validasi yang dikirim pada HTTP Header, antara lain:

1. username & password, merupakan kode consumer (pengakses web-service). Kode ini akan diberikan oleh Rumah Sakit QIM kepada BPJS.

2. timestamp, merupakan waktu yang akan di-generate oleh client saat ingin memanggil setiap service. Format waktu ini ditulis dengan format unix-based-time (berisi angka, tidak dalam format tanggal sebagaimana mestinya). Format waktu menggunakan Coordinated Universal Time ( UTC), dalam penggunaannya untuk mendapatkan timestamp, rumus yang digunakan adalah (local time in UTC timezone in seconds) - (1970-01-01 in seconds).

3. x-token, merupakan hasil dari pembuatan signature yang dibuat oleh client. Signature yang digunakan menggunakan pola HMAC-SHA256.

Untuk dapat mengakses web-service dari Rumah Sakit QIM (service provider), pemanggil web service (service consumer) akan mendapatkan:
• Username
• Password

Informasi Consumer Secret, hanya disimpan oleh service consumer. Tidak dikirim ke server web-service, hal ini untuk menjaga pengamanan yang lebih baik. Sedangkan kebutuhan Consumer Secret ini adalah untuk men-generate Signature (token).

Contoh:
username : user
password : 12345
timestamp : 433223232
x-token : username&password&timestamp
x-token : user&12345&433223232

                    
        PHP

   $username = "testtesttest";
   $password = "testest"
   $timestamp = "157887268";
         // Computes the timestamp
          date_default_timezone_set('UTC');
          $tStamp = strval(time()-strtotime('1970-01-01 00:00:00'));
           // Computes the signature by hashing the salt with the secret key as the key
   $signature = hash_hmac('sha256', $username."&".$password."&".$timestamp);

   // base64 encode…
   $encodedSignature = base64_encode($signature);

   // urlencode…
   // $encodedSignature = urlencode($encodedSignature);

   echo "username: " .$username ." ";
   echo "password: " .$password ." ";
   echo "timestamp:" .$tStamp ." ";
   echo "x-token: " .$encodedSignature;