Pencarian

Bagaimana Cara Menggunakan API dengan Aplikasi Postman

Article author
Learning Center Mekari
  • Diperbarui

Apabila Anda menggunakan Talenta, Anda dapat mengintegrasikannya dengan aplikasi lainnya. Untuk dapat melakukannya, Anda memerlukan API yang berfungsi untuk mengintegrasikan layanan backend pihak ketiga dengan sistem pusat HRIS Talenta. Untuk melakukan pengecekan hasil data API tersebut, Anda dapat menggunakan aplikasi seperti Postman dan Insomnia. Anda juga dapat klik di sini untuk mempelajari cara mengintegrasikan Talenta dengan HMAC.

Penting
Panduan berikut adalah untuk menguji menggunakan Postman, implementasi dalam bahasa pemrograman lain menjadi tanggung jawab dari sisi pengguna. Sebagai contoh dan pengenalan umum otentikasi HMAC Anda dapat melihatnya di sini. 

Berikut ini langkah-langkah mengecek API via Postman.

  1. Download dan install aplikasi Postman di sini.
  2. Generate API Token pada https://developers.mekari.com
  3. Lalu masukkan Application Name.
    Untitled__6_.png
  4. Dan pilih perusahaan pada bagian Company.
    Untitled__7_.png
  5. Pilih scope yang Anda inginkan. Berikut ini adalah contoh apabila scope yang dipilih untuk employee list untuk mendapatkan data semua karyawan.
    Untitled__8_.png
  6. Jika sudah klik “Submit”.
  7. Selanjutnya, akan muncul API Token sebagai berikut. Klik ikon “copy” untuk menyalin Client ID dan Client Secret.
    Untitled__9_.png
  8. Kemudian, buka Aplikasi Postman dan paste Client ID dan Client Secret seperti contoh berikut.
    Untitled__10_.png
    No Penjelasan
    1 Pada nomor 1 pastikan method yang dimasukkan sesuai dokumentasi. Dalam kasus ini method yang digunakan adalah GET.
    2 Pada nomor 2 pastikan url yang dimasukkan merupakan URL link yang ingin dituju. Dalam kasus ini https://api.mekari.com/v2/talenta/v2/employee?limit=20
    3

    Pada nomor 3 masukkan code berikut

    const Header = require('postman-collection').Header;
    const url = require('url');
    const hmac_username = "HMAC_USERNAME";
    const hmac_secret = "HMAC_SECRET";
    const requestUrl = url.parse(request['url']);
    const requestLine = pm.request.method + ' ' + requestUrl.path + ' HTTP/1.1';
    const dateString = new Date().toUTCString();
    const digest = CryptoJS.HmacSHA256(['date: ' + dateString, requestLine].join('\n'), hmac_secret);
    const signature = CryptoJS.enc.Base64.stringify(digest);
    const hmac_header = 'hmac username="' + hmac_username + '", algorithm="hmac-sha256", headers="date request-line", signature="' + signature + '"'
    pm.request.headers.add(new Header("Authorization: " + hmac_header));
    pm.request.headers.add(new Header("Date: " + dateString));
    4 Masukkan token sesuai dengan token yang di generate pada pada point 7.
  9. Apabila berhasil maka akan muncul sebagai berikut dibagian response.

Demikian penjelasan bagaimana cara menggunakan API dengan aplikasi Postman. Selanjutnya, Anda dapat mempelajari bagaimana cara masking data pada API Talenta di sini.