API Reference

info

Dokumentasi ini ditujukan untuk developer yang mengintegrasikan aplikasi mobile atau sistem eksternal dengan SIMONA.

SIMONA menyediakan REST API yang dapat digunakan oleh aplikasi mobile (Flutter) maupun sistem lain. Autentikasi menggunakan Bearer Token (Laravel Sanctum).

Base URL

Environment	URL
Production	https://simona.ridone.co.id/api
Development	http://localhost:8000/api

Autentikasi

Login

POST /api/login
Content-Type: application/json

{
  "email": "user@example.com",
  "password": "password"
}

Response berhasil:

{
  "code": 200,
  "message": "Login berhasil.",
  "data": {
    "token": "1|abc123...",
    "user": {
      "id": 1,
      "name": "Nama User",
      "email": "user@example.com",
      "roles": ["admin-loading"]
    }
  }
}

Menggunakan Token

Sertakan token di header setiap request yang memerlukan autentikasi:

Authorization: Bearer {token}

Logout

POST /api/v1/logout
Authorization: Bearer {token}

---

Format Response

Semua endpoint menggunakan format response yang konsisten:

{
  "code": 200,
  "message": "Pesan sukses atau error",
  "data": { }
}

Field	Keterangan
code	HTTP status code (200, 201, 401, 422, dll.)
message	Pesan deskriptif
data	Payload response (object/array), atau null untuk error

---

Endpoint Utama

Autentikasi

Method	Endpoint	Keterangan
POST	/api/login	Login & dapatkan token
GET	/api/v1/me	Info user yang sedang login
POST	/api/v1/logout	Logout (hapus token)
POST	/api/v1/change-password	Ganti password
GET	/api/v1/sessions	Daftar sesi aktif
DELETE	/api/v1/sessions	Hapus semua sesi lain

Fuel Orders

Method	Endpoint	Keterangan
GET	/api/v1/fuel-orders	Daftar fuel order (filter + pagination)
GET	/api/v1/fuel-orders/{id}	Detail fuel order
POST	/api/v1/fuel-orders	Buat fuel order manual
POST	/api/v1/fuel-orders/scan	Buat dari data barcode
POST	/api/v1/fuel-orders/batch	Batch create (multiple orders)
GET	/api/v1/fuel-orders/stats/summary	Ringkasan dashboard

Master Data

Method	Endpoint	Keterangan
GET	/api/v1/destinations	Daftar destinasi aktif
GET	/api/v1/transporters	Daftar transportir aktif
GET	/api/v1/transporters/{no_polisi}	Cari transportir by no polisi

---

Dokumentasi Lengkap

Untuk dokumentasi lengkap dengan contoh request/response detail, lihat file:

📄 .docs/API_DOCUMENTATION.md di repository

---

Kontak Developer

Untuk pertanyaan teknis mengenai API, hubungi tim IT PLN Indonesia Power.