Koleksi Postman
Setiap kontrak dilengkapi dengan koleksi Postman yang telah dikonfigurasi dengan URL sandbox dan contoh request body. Impor koleksi, isi kredensial Anda, dan Anda dapat memanggil setiap endpoint tanpa menulis kode.
Koleksi berdasarkan kontrak
| Kontrak | Koleksi | Catatan |
|---|---|---|
| Authentication | Unduh | Unduh file di bawah ini, impor ke Postman, dan ganti nilai parameter "service_account," "tenant_id," dan "secret_key" untuk menguji permintaan. |
| Web & SDK | Unduh | Termasuk pembuatan proses, GET process, GET evidences, dan GET PDF. |
| API | Unduh | Termasuk pembuatan proses (POST) dan GET process. |
Pengaturan
- Unduh koleksi untuk kontrak yang Anda integrasikan.
- Impor di Postman:
File > Import > Upload Files. - Konfigurasikan kredensial tergantung pada koleksi:
Authentication — buka koleksi, buka tab Variables, dan isi:
| Variabel | Nilai |
|---|---|
service_account | Nama service account Anda. |
tenant_id | Tenant ID Anda. |
secret_key | Private key Anda (format PEM). |
base_path | Host token endpoint. Default ke UAT (https://identityhomolog.acesso.io); ubah ke https://identity.acesso.io untuk production. |
Web & SDK — buka setiap request dan ganti nilai Authorization: Bearer dengan access token milik Anda sendiri.
API — buka setiap request dan ganti nilai header Authorization: Bearer dan APIKEY dengan kredensial Anda sendiri.
- Jalankan request Authentication — pre-request script secara otomatis membangun JWT assertion dan menyimpannya di
{{jwt_token}}.
Pre-request script
Hanya koleksi Authentication yang menyertakan pre-request script. Script ini:
- Membaca
service_account,tenant_id,secret_key, danbase_pathdari variabel koleksi. - Membangun dan menandatangani JWT assertion (RS256) menggunakan library KJUR yang tertanam.
- Menyimpan token yang ditandatangani di
{{jwt_token}}, yang secara otomatis diinjeksikan ke dalam request body.
Koleksi Web & SDK dan API tidak memiliki pre-request script — kredensial diset langsung di header request.
Langkah berikutnya
- Authentication — buat kredensial yang dibutuhkan koleksi.
- Web & SDK Overview — konteks untuk koleksi Web & SDK.
- API Overview — konteks untuk koleksi API.