Saat Anda sudah selesai dalam tahap otentifikasi dan otorisasi OAuth maka Anda perlu mengetahui cara API Accurate Online yang lebih tepat dan sesuai. Setiap HTTP request yang dikirimkan untuk mengakses API Accurate Online perlu menyertakan (Bearer) yang berisi Access Token yang telah diperoleh pada tahap Otentifikasi. Kali ini, Abckotaraya.id akan memberikan penjelasan penggunaan API Accurate Online.
Pastikan Database Terhubung
Saat melakukan integrasi untuk pertama kali pada Accurate Online, platform yang akan diintegrasikan perlu diketahui akan terhubung dengan database Accurate Online yang mana. Hal ini perlu Anda sesuaikan berdasarkan pada kebutuhan perusahaan Anda. Oleh sebab itu, apabila telah menerima Access Token pertama, aplikasi pihak ke-3 perlu melakukan 2 tahap berikut ini:
- Menampilkan Daftar Database Accurate Online yang didapatkan dari Access Token terkait
- Menyimpan informasi database Accurate Online yang dipilih oleh pengguna (ID dan alias database) dan melakukan Open Database untuk memperoleh informasi host dan session untuk disimpan dan digunakan dalam mengakses data pada database yang di pilih.
Kedua tahap diatas hanya perlu dilakukan satu kali saja dalam mengintegrasikan pada Accurate Online. Langkah ini dilakukan saat platform yang akan di integrasikan belum mengetahui terhubung dengan database Accurate Online yang mana.
Sebagai Contoh berikut ini, informasi aplikasi yang akan digunakan:
Nama Aplikasi
Demo Contoh
Platform
Website
URL Website
https://contoh.com
URL OAuth Callback
https://contoh.com/aol-oauth-callback
Client ID
42h76a10-90ab-2j54-z3e4-c4487t686567
Client Secret
e125610en632596255aascv5a40980fe
Pastikan akses token Anda telah diperoleh dari proses OAuth. Sebagai contoh , berikut akses token yang sudah didapat.
Pengguna | [email protected] |
Akses Token | e8786369-bc91-4731-abcd-c0n8e0dd79fa |
Scope | item_view item_save sales_invoice_view |
Membaca Dokumentasi Daftar API AOL
Setelah Anda selesai terdaftar menjadi pengembang Accurate Online, Anda dapat melihat daftar dan dokumentasi API Accurate Online di : https://account.accurate.id/developer/api-docs.do
API Accurate Online akan terbagi menjadi dua jenis:
API Dasar
Berisi API untuk operasi di luar data pengguna, misal melihat daftar database, membuka database, dll
API Accurate
Pada jenis kedua berisi API yang akan membaca, menulis, merubah, atau menghapus data pada database pengguna Accurate Online, misal: menambah item barang/jasa baru, membuat faktur penjualan, dan sebagainya.
Untuk akses API Accurate, perlu ditambahkan header X-Session-ID yang berisi kode session database yang berhasil didapatkan dari pemanggilan API api/open-db.do.
Pada dokumentasi, Anda dapat memperoleh URL Endpoint untuk mengakses API Accurate Online berserta dengan parameter yang akan digunakan.
Cara Mengetahui URL Endpoint API Accurate Online
Contoh pada API Dasar berikut ini:
Untuk mendapatkan URL API, anda bisa menghubungkan informasi yang diberi pada kotak diatas. Misal untuk mengakses API Db list (daftar database), berarti URL Endpoint API nya yaitu: https://account.accurate.id/api/db-list.do.
Sekarang kita coba mendapatkan URL Endpoint dengan menyimpan/mengedit data cabang di database Accurate Online:
Dari gambar tersebut, kita akan mendapatkan URL Endpoint untuk API Cabang yaitu: https://xyz.accurate.id/accurate/api/branch/save.do
Namun untuk jenis API Accurate, prefix URL yang diberi tanda merah diatas perlu diganti dengan response parameter host yang diperoleh dari akses API Open DB.
Contoh parameter host didapat dari API Open DB adalah: https://public.accurate.id, maka URL Endpoint yang digunakan untuk akses API Cabang untuk database tersebut ialah: https://public.accurate.id/accurate/api/branch/save.do
Cara Mengetahui Parameter yang digunakan pada API Accurate Online
Anda bisa melihat pada dokumentasi Daftar API, dapat dilihat parameter yang digunakan saat akses API terkait, lengkap dengan tipe data, contoh, dan keterangannya, sebagai berikut:
Parameter yang digunakan adalah HTTP Parameter biasa (disarankan menggunakan HTTP Post Method). Kolom Nama Parameter pada dokumentasi merupakan nama HTTP parameter yang digunakan. Untuk mengubah/edit data yang telah ada di Accurate Online, perlu memasukan parameter id yang berisi id record yang akan dirubah.
Apabila API memiliki tipe data kompleks, misalnya pada faktur penjualan, dimana 1 faktur penjualan bisa memiliki beberapa item, dokumentasi nama parameter diberi tambahan [n]. Dimana n adalah index angka urut mulai dari 0 (nol). Contoh sebagai berikut:
Misalnya :
detailItem[4].itemNo=ITM0004
detailItem[7].itemNo=ITM0007
Mendapatkan Daftar Database Accurate Online
Agar mendapatkan daftar database yang diperoleh oleh pengguna [email protected], gunakan API Db List seperti berikut:
URL | https://account.accurate.id/api/db-list.do |
Method | HTTP Get |
Header | |
Authorization | Bearer e8786369-bc91-4731-abcd-c0n8e0dd79fa |
Hasil dari request tersebut adalah daftar database sebagai berikut:
{
“d”: [
{
“id”: 1478,
“alias”: “PT Cebong Kampret”
},
{
“id”: 1390,
“alias”: “PT Contoh”
}
],
“s”: true
}
Apabila Anda tidak memperoleh hasil seperti diatas, silahkan melihat Penjelasan Informasi Kesalahan pada API.
Mendapatkan Session dan Host dari Database
Agar bisa menulis dan membaca ke database diperlukan informasi session dan host untuk database yang akan digunakan. Misal, Anda ingin menggunakan database PT Cebong Kampret maka session dan host dapat menggunakan API Open Db dengan mengirimkan id dari database tersebut sebagai parameter sebagai berikut:
URL | https://account.accurate.id/api/open-db.do |
Method | HTTP Get |
Header | |
Authorization | Bearer e8786369-bc91-4731-abcd-c0n8e0dd79fa |
Request Parameter | |
id | 1390 |
Hasil dari request tersebut :
{
“d”: [
“Proses Berhasil Dilakukan”
],
“host”: “https://public.accurate.id”,
“session”: “7ff867b6-34h2-4v7x-3265-09e3j6818f1b”,
“s”: true
}
Dari hasil tersebut diperoleh session 7ff867b6-34h2-4v7x-3265-09e3j6818f1b dan host https://public.accurate.id yang bisa digunakan untuk akses data pada database terkait sesuai pada Scope yang diminta. Informasi host ini akan menentukan prefix URL untuk mengakses API Accurate.
Menulis Data ke Dalam Database
Setelah itu kita sudah bisa menulis ke database. Misal kita ingin menyimpan data barang baru, kita bisa melihat Daftar API, dan bisa menggunakan API /api/item seperti berikut:
URL | https://public.accurate.id/accurate/api/item/save.do |
Method | HTTP Post |
Header | |
Authorization | Bearer e8786369-bc91-4731-abcd-c0n8e0dd79fa |
X-Session-ID | 7ff867b6-34h2-4v7x-3265-09e3j6818f1b |
Request Body | |
Name | Test Item |
itemType | Inventory |
Hasil request tersebut adalah:
{
“r”: {
“id”: 1467
“no”: “100078”,
“name”: “Test Item”,
“upcNo”: null,
“itemType”: “INVENTORY”,
“notes”: null,
“detailOpenBalance”: [],
….
},
“s”: true,
“d”: [
“Barang & Jasa “Test Item” berhasil disimpan”
]
}
Membaca Daftar Data Database
Untuk melihat daftar barang yang ada, bisa menggunakan API /item/list seperti berikut:
URL | https://public.accurate.id/accurate/api/item/list.do |
Method | HTTP Get |
Header | |
Authorization | Bearer e8786369-bc91-4731-abcd-c0n8e0dd79fa |
X-Session-ID | 7ff867b6-34h2-4v7x-3265-09e3j6818f1b |
Request Parameter | |
Fields | Id,name,no |
Filter.itemType | Inventory |
Hasil dari request tersebut sebagai berikut:
“s”: true,
“d”: [
{
“no”: “100078”,
“name”: “Test Item”,
“id”: 1467
},
{
“no”: “100056”,
“name”: “Chipset 6293LW”,
“id”: 984
},
{
“no”: “100053”,
“name”: “289TD Docking Station 43 mm”,
“id”: 728
}
…
],
“sp”: {
“page”: 1,
“sort”: null,
“pageSize”: 20,
“pageCount”: 2,
“rowCount”: 22,
“start”: 0,
“limit”: null
}
}
Membaca Rincian Data dari database
Agar Anda bisa mendapatkan data barang yang lebih rinci bisa menggunakan /item/detail seperti berikut:
URL | https://public.accurate.id/accurate/api/item/detail.do |
Method | HTTP Get |
Header | |
Authorization | Bearer e8786369-bc91-4731-abcd-c0n8e0dd79fa |
X-Session-ID | 7ff867b6-34h2-4v7x-3265-09e3j6818f1b |
Request Parameter | |
id | 1467 |
Hasil dari request tersebut akan mendapatkan informasi data barang yang rinci sebagai berikut:
{
“s”: true,
“d”: {
“id”: 1467,
“no”: “100078”,
“name”: “Test Item”,
“upcNo”: null,
“itemType”: “INVENTORY”,
“notes”: null,
“detailOpenBalance”: [],
….
}
}
Kesimpulan
Itulah beberapa langkah penggunaan API pada Accurate Online untuk Anda yang mengintegrasikan dengan platform perusahaan Anda. Jika terdapat kendala bisa cek pada halaman Penjelasan Informasi Kesalahan pada API.
Nikmati sensasi rasa unik Emkay Frizz Happy Sour! Jangan lewatkan kesempatan untuk memiliki liquid vape terbaik, pesan sekarang di emkay.id atau vape store terdekat!