API Documentation - Pangantara

Base URL: https://be-internship.bccdev.id/hanif/api/v1 Content-Type: application/json

---

📌 Definisi

Term	Definisi
access_token	JWT token yang digunakan untuk autentikasi, berlaku 15 menit
refresh_token	JWT token untuk memperbarui access token, berlaku 7 hari
UUID	Unique identifier berbentuk string, contoh: f00a42ce-60e7-4170-8eaa-13c4776603b6
Bearer Token	Format token di header: Authorization: Bearer <access_token>
Role	Hak akses pengguna: admin, supplier, sppg
Verification Status	Status verifikasi supplier: pending, approved, rejected
Order Status	Status pesanan: pending, processing, shipped, completed, cancelled
Payment Status	Status pembayaran: unpaid, waiting_confirmation, paid, failed
Draft Status	Status draft pendaftaran supplier: draft, submitted

---

📌 Format Response Standar

Success Response

{
    "success": true,
    "message": "Success",
    "data": {}
}

Paginated Response

{
    "success": true,
    "message": "Success",
    "data": [],
    "total": 100,
    "page": 1,
    "limit": 10
}

Error Response

{
    "success": false,
    "message": "Error message"
}

---

📌 HTTP Status Code

Status Code	Keterangan
200	OK - Request berhasil
201	Created - Data berhasil dibuat
400	Bad Request - Request tidak valid
401	Unauthorized - Token tidak ada atau tidak valid
403	Forbidden - Tidak punya izin akses
404	Not Found - Data tidak ditemukan
429	Too Many Requests - Rate limit tercapai
500	Internal Server Error - Kesalahan server

---

📌 Rate Limiting

Endpoint	Limit
Global (semua endpoint)	100 request/menit
Auth (login, register, forgot password)	10 request/menit
Upload (dokumen & foto)	20 request/menit

---

🔓 Public Routes

Auth

• Register
• Login
• Forgot Password
• Reset Password
• Refresh Token

Webhook

• Midtrans Webhook

---

🔐 Protected Routes

Dashboard

• Get Dashboard Summary

Users

• Get All Users
• Get User By ID
• Create User
• Update User
• Delete User

Suppliers

• Get All Suppliers
• Get Supplier By ID
• Get Supplier By User ID
• Create Supplier
• Update Supplier
• Delete Supplier
• Verify Supplier (Admin Only)

Supplier Drafts

• Get Draft
• Save Draft
• Submit Draft
• Delete Draft
• Upload Draft Document

SPPG

• Get All SPPG
• Get SPPG By ID
• Get SPPG By User ID
• Create SPPG
• Update SPPG
• Delete SPPG

Products

• Get All Products
• Get Product By ID
• Get Product By Supplier
• Create Product
• Update Product
• Delete Product

Stock

• Get All Stocks
• Get Stock By ID
• Get Stock By Product ID
• Get Stock By Supplier ID
• Create Stock
• Update Stock
• Delete Stock

Orders

• Get All Orders
• Get Order By ID
• Get Order By SPPG ID
• Create Order
• Update Order Status
• Delete Order

Transactions

• Get All Transactions
• Get Transaction By ID
• Get Transaction By Order ID
• Create Transaction
• Update Payment Status
• Delete Transaction

Payments

• Create Payment

Uploads

• Upload Product Image
• Upload Supplier Document