Contoh Langkah Penggunaan API Accurate Online

Berikut ini adalah contoh langkah penggunaan API Accurate Online (AOL).

Pastikan aplikasi telah terdaftar. Sebagai contoh, 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 Akses Token yang bisa didapatkan lewat proses OAuth. Sebagai contoh, berikut adalah Akses Token yang sudah didapatkan :

Pengguna john@example.com
Akses Token e8446369-bd56-4731-acea-c0a9e0cc46fa
scope item_view item_save sales_invoice_view

Mendapatkan daftar database Accurate Online

Untuk mendapatkan daftar database yang dapat dibuka oleh pengguna john@example.com, 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 eegk4oOp6TDjzYuW12sg8yN
qsws09cwDqsuCCihtCOQ=

Hasil dari request tersebut adalah daftar database seperti berikut :

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

Jika Anda tidak mendapatkan hasil seperti di atas, silakan melihat halaman Penjelasan Informasi Kesalahan pada API.

Mendapatkan session dan host dari Database

Untuk dapat membaca dan menulis ke database diperlukan session dan host untuk database tersebut. Misalkan Anda 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 qLPGsCuJxZR0OHWCkW771
RoXXReKoeVut2byyIPRG18=

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 dan host https://public.accurate.id yangdapat digunakan 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:02:36Z
sign +qxvNhmD59rn9c7kVUl7sI9
p7z2W/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
itemType INVENTORY
_ts 2014-10-07T06:02:36Z
sign vHSh4MTcY6OKCof5FEdycB
c9kvhjd8yJxi+z7k6B/oU=

Hasil dari request tersebut adalah sebagai 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:02:36Z
sign hfTBh1AmCFK9I5g8MCabNx
AvsVICuKykYQ+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 API yang dapat digunakan dapat dilhat pada halaman developer https://accurate.id/developer pada bagian Daftar API.

Jika Anda mengalami kendala dalam penggunaan silakan lihat halaman Penjelasan Informasi Kesalahan pada API.