库存查询API

MCP A Query API

Service API sederhana untuk mengecek stok barang dan melakukan update stok (inventaris). Service ini berjalan menggunakan Node.js dan Express.

Catatan: Data inventaris tersimpan di memori (in-memory), sehingga data akan kembali ke default setiap kali server di-restart.

Prasyarat

• Node.js (versi 14 atau lebih baru disarankan)

Instalasi

1. Clone repositori ini atau download source code.
2. Masuk ke direktori project:
   复制

   cd mcp-a-query
   

3. Install dependencies:
   复制

   npm install
   

Menjalankan Server

Untuk menjalankan server di mode production (atau default):

npm start

Server akan berjalan di port 3001.

API Endpoints

1. Cek Stok Barang

Mendapatkan informasi stok dan harga barang berdasarkan nama item.

• URL: /api/v1/stock
• Method: GET
• Query Params:
  • item (string): Nama barang (contoh: buku, pensil, laptop)

Contoh Request:

GET http://localhost:3001/api/v1/stock?item=buku

Contoh Response (Sukses):

{
  "status": "success",
  "item": "buku",
  "stock": 200,
  "price": 30000
}

Contoh Response (Tidak Ditemukan):

{
  "status": "error",
  "message": "Stok untuk meja tidak ditemukan."
}

2. Update Stok Barang

Mengurangi stok barang setelah terjadi pemesanan.

• URL: /api/v1/update-stock
• Method: POST
• Body: JSON
  复制

  {
    "item": "buku",
    "quantity": 5
  }
  

Contoh Response (Sukses):

{
  "status": "success",
  "item": "buku",
  "oldStock": 200,
  "newStock": 195,
  "message": "Stok buku berhasil dikurangi 5 unit"
}

Contoh Response (Gagal - Stok Tidak Cukup):

{
  "status": "error",
  "message": "Stok tidak cukup. Tersedia: 200, diminta: 250"
}