Dokumentasi API Stock ATK

Autentikasi

Endpoint private memakai Bearer Token dari API login. Akun hasil register API berstatus inactive dan harus diaktifkan admin lewat menu Pengguna di web panel.

POST /api/register
{
  "name": "Demo User",
  "email": "demo@example.com",
  "password": "password",
  "password_confirmation": "password"
}

POST /api/login
{
  "email": "admin@example.com",
  "password": "password",
  "device_name": "postman"
}

Authorization: Bearer {access_token}

Data Barang

User aktif bisa melihat data barang. Tambah, edit, hapus mengikuti permission role seperti di web panel.

• GET /api/barang?search=pulpen&per_page=10
• GET /api/barang/{id}
• POST /api/barang body: {"kode":"ATK-009","nama":"Penghapus","stok":20}
• PUT /api/barang/{id} body: {"kode":"ATK-009","nama":"Penghapus Putih","stok":25}
• DELETE /api/barang/{id} hanya bisa jika belum punya transaksi.

Barang Masuk

Sesuai alur web, barang masuk untuk role yang punya permission. Saat dibuat, stok barang otomatis bertambah.

• GET /api/barang-masuk?per_page=10
• POST /api/barang-masuk body: {"barang_id":1,"jumlah":10,"tanggal":"2026-07-27"}

Barang Keluar

User membuat permintaan barang keluar dengan status pending. Admin memproses approve/reject. Stok dipotong hanya saat approve.

• GET /api/barang-keluar?per_page=10
• POST /api/barang-keluar body: {"barang_id":1,"jumlah":2,"tanggal":"2026-07-27"}
• POST /api/barang-keluar/{id}/approve
• POST /api/barang-keluar/{id}/reject