Penggunaan API Accurate Online

Berikut adalah contoh langkah penggunaan API Accurate Online (AOL):

Pastikan Aplikasi telah terdaftar . Sebagai contoh, misalkan berikut adalah informasi aplikasi yang telah terdaftar :

Nama Aplikasi
Demo Example
Platform
Website
URL Website
https://example.com
URL OAuth Callback
https://example.com/aol-oauth-callback
API Key
42f12a10-08df-4b91-b1e4-c4465d686072
OAuth Secret
e133410eb632596255adfbe5a49990fe
Signature Secret
268a1a7fbd0002ccf353d336982a11fe

Pastikan Anda telah memiliki Access Token yang bisa didapatkan lewat proses OAuth. Sebagai contoh, misalkan berikut adalah Akses Token yang sudah didapatkan :

Pengguna This email address is being protected from spambots. You need JavaScript enabled to view it.
Akses Token e8446369-bd56-4731-acea-c0a9e0cc46fa
Scope item_view item_save sales_invoice_view

Mendapatkan daftar Database Accurate Online

Pertama untuk mendapatkan daftar Database yang dapat dibuka oleh pengguna This email address is being protected from spambots. You need JavaScript enabled to view it. , gunakan API Db List seperti berikut:

URL https://accurate.id/api/db-list.do
Method HTTP POST
Header

Authorization

Bearer e8446369-bd56-4731-acea-c0a9e0cc46fa

Request Body
_ts 2014-10-07T06:01:09Z
sign

eegk4oOp6TDjzYuW12sg8yNqsws09cwDqsuCCihtCOQ=

hasil dari request tersebut adalah daftar database seperti berikut :


{
  "d": [
    {
      "id": 1156,
      "alias": "PT Demo Example"
    },
    {
      "id": 1253,
      "alias": "PT Contoh"
    }
  ],
  "s": true
}

Mendapatkan session dan host dari Database

Untuk dapat membaca dan menulis ke database diperlukan session dan host untuk database tersebut. Misalkan Kita ingin menggunakan database PT Demo Example maka session dan host dapat didapatkan menggunakan API Open Db dengan mengirimkan id dari database tersebut sebagai parameter :

URL https://accurate.id/api/open-db.do
Method HTTP POST
Header

Authorization

Bearer e8446369-bd56-4731-acea-c0a9e0cc46fa

Request Body
id 1156
_ts 2014-10-07T06:02:36Z
sign

qLPGsCuJxZR0OHWCkW771RoXXReKoeVut2byyIPRG18=

hasil dari request tersebut adalah sebagai berikut :


{
  "d": [
    "Proses Berhasil Dilakukan"
  ],
  "host": "https://public.accurate.id",
  "session": "7ff842b6-53e2-4d7b-8038-09e3f8318f1b",
  "s": true
}

dari hasil berikut didapatkan session 7ff842b6-53e2-4d7b-8038-09e3f8318f1b dah host https://public.accurate.id, Kita dapat menggunakan ini untuk membaca dan menuliskan data.

Menulis ke database

Berikutnya Kita sudah dapat menulis ke database. Misalkan Kita ingin menuliskan data barang maka bisa menggunakan API /item/save seperti berikut :

URL https://public.accurate.id/accurate/api/item/save.do
Method HTTP POST
Header

Authorization

Bearer e8446369-bd56-4731-acea-c0a9e0cc46fa

Request Body
session 7ff842b6-53e2-4d7b-8038-09e3f8318f1b
name Test Item
itemType INVENTORY
_ts 2014-10-07T06:05:45Z
sign

+qxvNhmD59rn9c7kVUl7sI9p7z2W/dSGjdBZEyEDT70=

hasil dari request tersebut adalah sebagai berikut :


{
  "r": {
    "id": 1250,
    "no": "100027",
    "name": "Test Item",
    "upcNo": null,
    "itemType": "INVENTORY",
    "notes": null,
    "detailOpenBalance": [],
     ....
  },
  "s": true,
  "d": [
    "Barang & Jasa \"Test Item\" berhasil disimpan"
  ]
}


Membaca daftar data dari 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 POST
Header

Authorization

Bearer e8446369-bd56-4731-acea-c0a9e0cc46fa

Request Body
session 7ff842b6-53e2-4d7b-8038-09e3f8318f1b
fields id,name,no
_ts 2014-10-07T06:06:35Z
sign

vHSh4MTcY6OKCof5FEdycBc9kvhjd8yJxi+z7k6B/oU=

hasil dari request tersebut adalah daftar barang seperti berikut :


{
  "s": true,
  "d": [
    {
      "no": "100027",
      "name": "Test Item",
      "id": 1250
    },
    {
      "no": "100016",
      "name": "Chipset 6293LW",
      "id": 984
    },
    {
      "no": "100012",
      "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

Untuk mendapatkan data barang yang lebih rinci bisa menggunakan API /item/detail seperti berikut :

URL https://public.accurate.id/accurate/api/item/detail.do
Method HTTP POST
Header

Authorization

Bearer e8446369-bd56-4731-acea-c0a9e0cc46fa

Request Body
session 7ff842b6-53e2-4d7b-8038-09e3f8318f1b
id 1250
_ts 2014-10-07T06:06:58Z
sign

hfTBh1AmCFK9I5g8MCabNxAvsVICuKykYQ+nlP79DFA=

hasil dari request tersebut adalah informasi data barang yang rinci seperti berikut :


{
  "s": true,
  "d": {
    "id": 1250,
    "no": "100027",
    "name": "Test Item",
    "upcNo": null,
    "itemType": "INVENTORY",
    "notes": null,
    "detailOpenBalance": [],
     ....
  }
}

 

Daftar lengkap API yang dapat digunakan dapat dilihat pada halaman developer https://accurate.id/developer/api-docs.do