Authorization & Headers
API BI SNAP menggunakan OAuth2 sebagai standar otorisasi framework. Untuk memberikan akses ke semua layanan yang disediakan oleh Finnet, Anda harus memiliki token akses dengan grantType=client_credetials. Anda akan diminta untuk memiliki client_id yang valid dan ter-otorisasi untuk memiliki token. Untuk mendapatkan informasi lebih lanjut tentang implementasi kerangka otorisasi oAuth 2 Anda dapat merujuk ke dokumentasi RFC6749 yang dapat ditemukan di https://www.rfc-editor.org/rfc/rfc6749
Content-Type and Accept Header
API BI SNAP menggunakan format JSON untuk input dan output, oleh karena itu diperlukan untuk menentukan JSON sebagai content-type & menerima JSON sebagai respons. Spesifikasi header adalah seperti yang ditunjukkan di bawah ini.
- Content-Type: application/json
- Accept: application/json
Authorization Header
Header ini adalah persyaratan wajib yang harus disediakan pada setiap permintaan API yang dikirim ke layanan Finnet agar permintaan berhasil. Berikut ini adalah kolom header yang perlu disediakan:
| Name | Type | Length | Mandatory | Description |
|---|---|---|---|---|
| Authorization | AN | N/A | M | Represents access_token of arequest, String starts with keyword “Bearer” followedby accessToken |
| Content-Type | AN | 16 | M | Content of you request body e.g. application/json |
| X-TIMESTAMP | yyyy-MM-ddThh:mi:ssTZD (ISO 8601) | 25 | M | Client’s current local time in yyyy-MM-ddTHH:mm:ssTZD format |
| X-SIGNATURE | AN | N/A | M | Please refer to Signature section |
| ORIGIN | String | N/A | M | Origin Domain www.yourdomain.com |
| X-EXTERNAL-ID | String | 32 | M | Numeric String Reference number that should be unique in the same day |
| X-PARTNER-ID | String | 36 | M | Unique ID for a partner |
| CHANNEL-ID | String | 5 | M | PJP’s channel id Device identification on which the API services is currently being accessed by the end user (customer). Finnet will provide this value |