Penggunaan API Accurate Online

Penggunaan API Accurate Online2018-11-16T09:30:21+00:00

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 :

Penggunajohn@example.com
Akses Tokene8446369-bd56-4731-acea-c0a9e0cc46fa
scopeitem_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 :

URLhttps://accurate.id/api/db-list.do
MethodHTTP POST
Header
AuthorizationBearer e8446369-bd56-4731-
acea-c0a9e0cc46fa
Request Body
_ts2014-10-07T06:01:09Z
signeegk4oOp6TDjzYuW12sg8yN
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 :

URLhttps://accurate.id/api/open-db.do
MethodHTTP POST
Header
AuthorizationBearer e8446369-bd56-4731-
acea-c0a9e0cc46fa
Request Body
id1156
_ts2014-10-07T06:02:36Z
signqLPGsCuJxZR0OHWCkW771
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 :

URLhttps://public.accurate.id/accurate/api/item/save.do
MethodHTTP POST
Header
AuthorizationBearer e8446369-bd56-4731-
acea-c0a9e0cc46fa
Request Body
session7ff842b6-53e2-4d7b-
8038-09e3f8318f1b
nameTest Item
itemTypeINVENTORY
_ts2014-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 :

URLhttps://public.accurate.id/accurate/api/item/list.do
MethodHTTP POST
Header
AuthorizationBearer e8446369-bd56-4731-
acea-c0a9e0cc46fa
Request Body
session7ff842b6-53e2-4d7b-
8038-09e3f8318f1b
fieldsid,name,no
itemTypeINVENTORY
_ts2014-10-07T06:02:36Z
signvHSh4MTcY6OKCof5FEdycB
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 :

URLhttps://public.accurate.id/accurate/api/item/detail.do
MethodHTTP POST
Header
AuthorizationBearer e8446369-bd56-4731-
acea-c0a9e0cc46fa
Request Body
session7ff842b6-53e2-4d7b-
8038-09e3f8318f1b
id1250
_ts2014-10-07T06:02:36Z
signhfTBh1AmCFK9I5g8MCabNx
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.