Informasi dasar API
API v2 berjalan sebagai REST API PHP standalone dan dapat diakses langsung oleh aplikasi client melalui endpoint di folder /api.
https://arpa.twelvepplg.my.id/apiGET /api/index.php mengembalikan nama API, versi, fitur, daftar endpoint, klasifikasi auth, dan aturan upload cover.curl https://arpa.twelvepplg.my.id/api/index.php
{
"success": true,
"message": "API aktif.",
"data": {
"name": "LibrarySMKTI REST API",
"version": "2.0.0",
"features": [
"katalog buku + pencarian + filter kategori",
"detail buku",
"register + login + token bearer + data akun",
"dashboard admin + statistik",
"tambah/edit/hapus buku khusus admin",
"upload dan penggantian cover JPG/JPEG/PNG maksimal 2 MB",
"sinopsis buku"
],
"endpoints": [
"POST /register.php",
"POST /login.php",
"GET /me.php",
"GET /categories.php",
"GET /books.php",
"GET /books.php?id={id}",
"GET /stats.php",
"POST /add.php",
"PUT /edit.php?id={id}",
"PATCH /edit.php?id={id}",
"POST /edit.php?id={id} (multipart + cover)",
"DELETE /delete.php?id={id}"
],
"auth": {
"public": ["register.php", "login.php", "books.php", "categories.php"],
"bearer_required": ["me.php"],
"admin_required": ["stats.php", "add.php", "edit.php", "delete.php"]
},
"cover": {
"upload_field": "cover",
"formats": ["jpg", "jpeg", "png"],
"max_size_mb": 2,
"public_base_path": "/perpussmkti/"
}
}
}
Alur penggunaan paling umum
Gunakan /register.php bila perlu membuat akun baru, lalu /login.php untuk memperoleh Bearer Token. Katalog dan kategori dapat dibaca tanpa token; data akun membutuhkan token; statistik dan CRUD buku membutuhkan token admin.
Register / Login
Buat akun lewat /register.php atau login lewat /login.php.
Gunakan token
Ambil data.token dan kirim sebagai Authorization: Bearer TOKEN untuk endpoint akun dan admin.
Akses fitur
Katalog/kategori bersifat publik; statistik dan CRUD buku memerlukan akun admin.
Format response konsisten
Response sukses memakai success: true dan biasanya berisi message serta data. Response error memakai success: false.
Success
{
"success": true,
"message": "...",
"data": { }
}
Error
{
"success": false,
"message": "..."
}
cover_image dan cover_url. Jika cover tidak ada, cover_url diarahkan ke /perpussmkti/default-cover.svg.Bearer Token
Endpoint akun /me.php memerlukan Bearer Token, sedangkan /stats.php, ADD, EDIT, dan DELETE memerlukan token dari user admin. Masa berlaku token saat ini adalah 24 jam.
Kirim JSON berisi username dan password.
curl -X POST "https://arpa.twelvepplg.my.id/api/login.php" \\
-H "Content-Type: application/json" \\
-d '{
"username": "YOUR_USERNAME",
"password": "YOUR_PASSWORD"
}'
{
"success": true,
"message": "Login berhasil.",
"data": {
"token": "TOKEN_DARI_SERVER",
"token_type": "Bearer",
"expires_in": 86400,
"user": {
"id": 1,
"username": "YOUR_USERNAME",
"is_admin": 1
}
}
}
data.token secara langsung pada header Authorization. Token diverifikasi menggunakan tanda tangan server dan waktu kedaluwarsa.Authorization: Bearer TOKEN_DARI_SERVER
Reference endpoint
Berikut seluruh endpoint yang tersedia berdasarkan implementasi API saat ini.
Mengambil daftar buku dengan optional search, category, pagination, atau mengambil satu buku memakai parameter id.
| Parameter | Type | Default | Keterangan |
|---|---|---|---|
id | integer | — | Jika diisi, API mengembalikan satu buku berdasarkan ID. |
search | string | "" | Pencarian pada title, author, publisher, atau category. |
category | string | "" | Filter kategori yang harus cocok dengan nilai category. |
page | integer | 1 | Nomor halaman, minimum 1. |
limit | integer | 20 | Jumlah item per halaman, 1–100. |
GET /api/books.php
GET /api/books.php?page=1&limit=20
GET /api/books.php?search=java&category=Pemrograman&page=1&limit=20
GET /api/books.php?id=1
{
"success": true,
"message": "Daftar buku berhasil diambil.",
"data": {
"items": [
{
"id": 1,
"title": "Belajar PHP",
"author": "Gede Aditya Arpa",
"publisher": "SMK TI",
"year": 2026,
"category": "Pemrograman",
"synopsis": "Buku pembelajaran PHP.",
"cover_image": "abc123.jpg",
"cover_url": "https://arpa.twelvepplg.my.id/perpussmkti/uploads/abc123.jpg",
"created_at": "2026-09-30 12:00:00"
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 1,
"total_pages": 1
}
}
}
Membuat akun user biasa. Akun yang dibuat endpoint ini selalu memiliki is_admin = 0.
{
"username": "user_baru",
"password": "1234",
"password_confirm": "1234"
}
| Field | Aturan |
|---|---|
username | 3–30 karakter, hanya huruf, angka, underscore. Username arpa dicadangkan untuk admin. |
password | Minimal 4 karakter. |
password_confirm | Harus sama dengan password. |
{
"success": true,
"message": "Akun berhasil dibuat. Silakan login.",
"data": {
"id": 2,
"username": "user_baru",
"is_admin": 0
}
}
Validasi akun dan membuat Bearer Token.
{
"username": "YOUR_USERNAME",
"password": "YOUR_PASSWORD"
}
Response sukses berisi token, token_type, expires_in, dan informasi user.
Mengambil identitas user yang terkait dengan token aktif.
GET /api/me.php
Authorization: Bearer TOKEN_DARI_SERVER
{
"success": true,
"message": "Data akun ditemukan.",
"data": {
"id": 1,
"username": "arpa",
"is_admin": 1,
"created_at": "2026-09-30 12:00:00"
}
}
Mengambil semua kategori yang sedang dipakai buku beserta jumlah bukunya. Endpoint ini public dan tidak membutuhkan Bearer Token.
GET /api/categories.php
{
"success": true,
"message": "Daftar kategori berhasil diambil.",
"data": {
"items": [
{ "name": "Pemrograman", "book_count": 12 },
{ "name": "Novel", "book_count": 7 }
],
"total": 2
}
}
Mengambil statistik dashboard admin: total buku, total kategori, dan 10 buku terbaru.
GET /api/stats.php
Authorization: Bearer ADMIN_TOKEN
{
"success": true,
"message": "Statistik dashboard berhasil diambil.",
"data": {
"total_books": 25,
"total_categories": 4,
"latest_books": [
{
"id": 25,
"title": "Buku Terbaru",
"author": "Author",
"year": 2026,
"category": "Pemrograman",
"cover_image": "abc.jpg",
"cover_url": "https://arpa.twelvepplg.my.id/perpussmkti/uploads/abc.jpg",
"created_at": "2026-09-30 12:00:00"
}
]
}
}
Menambahkan buku baru. Endpoint menerima JSON atau multipart/form-data. Multipart dipakai bila mengunggah cover.
JSON tanpa cover
POST /api/add.php
Content-Type: application/json
Authorization: Bearer TOKEN
{
"title": "Belajar PHP",
"author": "Gede Aditya Arpa",
"publisher": "SMK TI",
"year": 2026,
"category": "Pemrograman",
"synopsis": "Buku pembelajaran PHP."
}Multipart + cover
POST /api/add.php
Content-Type: multipart/form-data
Authorization: Bearer TOKEN
Form fields:
title
author
publisher
year
category
synopsis
cover = JPG/JPEG/PNG, max 2 MBcurl -X POST "https://arpa.twelvepplg.my.id/api/add.php" \\
-H "Authorization: Bearer TOKEN_DARI_SERVER" \\
-H "Content-Type: application/json" \\
-d '{
"title": "Belajar PHP",
"author": "Gede Aditya Arpa",
"publisher": "SMK TI",
"year": 2026,
"category": "Pemrograman",
"synopsis": "Buku pembelajaran PHP."
}'
curl -X POST "https://arpa.twelvepplg.my.id/api/add.php" \\
-H "Authorization: Bearer TOKEN_DARI_SERVER" \\
-F "title=Belajar PHP" \\
-F "author=Gede Aditya Arpa" \\
-F "publisher=SMK TI" \\
-F "year=2026" \\
-F "category=Pemrograman" \\
-F "synopsis=Buku pembelajaran PHP." \\
-F "cover=@C:/gambar/cover.jpg"
Mengubah sebagian atau beberapa field buku. Untuk PUT/PATCH, body JSON hanya berisi field yang ingin diubah.
PUT /api/edit.php?id=1
Authorization: Bearer TOKEN
Content-Type: application/json
{
"title": "Belajar PHP Lanjutan",
"category": "Backend"
}
POST /edit.php?id={id}, implementasi API mengharuskan upload cover sekaligus.POST /api/edit.php?id=1
Authorization: Bearer TOKEN
Content-Type: multipart/form-data
Form fields yang boleh dikirim:
title
author
publisher
year
category
synopsis
cover = JPG/JPEG/PNG, max 2 MB
Saat cover baru berhasil tersimpan, cover lama akan dihapus.
Menghapus buku berdasarkan ID. Jika buku memiliki cover, file cover tersebut juga dihapus.
curl -X DELETE "https://arpa.twelvepplg.my.id/api/delete.php?id=1" \\
-H "Authorization: Bearer TOKEN_DARI_SERVER"
{
"success": true,
"message": "Buku berhasil dihapus.",
"data": { "id": 1 }
}
Field buku & validasi
Validasi berikut berasal dari fungsi validasi pada API. Pada mode edit, semua field bersifat opsional karena update bersifat partial.
| Field | Type | Wajib saat create | Batas / aturan |
|---|---|---|---|
title | string | Ya | Maks. 255 karakter. |
author | string | Ya | Maks. 150 karakter. |
publisher | string / null | Tidak | Maks. 150 karakter jika diisi. |
year | integer / null | Tidak | Harus angka; rentang dimulai 1000 hingga tahun berjalan + 1. |
category | string / null | Tidak | Maks. 100 karakter. |
synopsis | string / null | Tidak | Maks. 5000 karakter. |
cover | file | Tidak | JPG/JPEG/PNG, maksimum 2 MB, harus merupakan gambar valid. |
title, author, publisher, year, category, dan synopsis ditolak dengan HTTP 422./perpussmkti/uploads/. Jika cover_image kosong, API mengembalikan https://arpa.twelvepplg.my.id/perpussmkti/default-cover.svg sebagai cover_url.HTTP status & penanganan error
API mengembalikan JSON error dengan pola success: false dan pesan yang menjelaskan masalah.
{
"success": false,
"message": "Authorization Bearer token diperlukan."
}
Akses lintas origin
API saat ini mengizinkan CORS dari semua origin dan mendeklarasikan header serta method yang digunakan.
Allowed origin
Access-Control-Allow-Origin: *
Allowed headers
Content-Type, Authorization, X-API-Key
Allowed methods
GET, POST, PUT, PATCH, DELETE, OPTIONS
OPTIONS dijawab dengan HTTP 204. Ini mendukung preflight request browser sebelum request API tertentu.Contoh pemakaian Visual Studio C#
Paket API v2 menyertakan LibraryApiClient.cs untuk .NET. Client mencakup register, login, identitas akun, kategori, statistik admin, katalog/detail buku, tambah, edit, dan hapus. Base URL client adalah https://arpa.twelvepplg.my.id/api.
using LibrarySMKTI;
using var api = new LibraryApiClient(
"https://arpa.twelvepplg.my.id/api");
var login = await api.LoginAsync(
"YOUR_USERNAME",
"YOUR_PASSWORD");
Console.WriteLine(login.Message);
var books = await api.GetBooksAsync(
search: "php",
category: "Pemrograman",
page: 1,
limit: 20);
foreach (var book in books.Data?.Items ?? [])
{
Console.WriteLine(
$"{book.Id} - {book.Title} - {book.Author}");
}
var registered = await api.RegisterAsync(
"user_baru",
"1234",
"1234");
var loginAfterRegister = await api.LoginAsync(
"user_baru",
"1234");
var me = await api.GetCurrentUserAsync();
var categories = await api.GetCategoriesAsync();
if (me.Data?.IsAdmin == 1)
{
var stats = await api.GetDashboardStatsAsync();
Console.WriteLine($"Total buku: {stats.Data?.TotalBooks}");
}
var created = await api.CreateBookAsync(new BookCreate
{
Title = "Buku Baru dari C#",
Author = "Admin C#",
Publisher = "SMKTI",
Year = 2026,
Category = "Pemrograman",
Synopsis = "Data dibuat dari aplikasi Visual Studio C#."
});
if (created.Data is not null)
{
var updated = await api.UpdateBookAsync(
created.Data.Id,
new BookUpdate
{
Title = "Buku Baru dari C# - Updated"
});
var deleted = await api.DeleteBookAsync(
created.Data.Id);
}
Token, lalu menambahkan header Bearer untuk request yang membutuhkan autentikasi.Catatan untuk deployment
Halaman ini mendokumentasikan kontrak API, bukan tempat menyimpan secret server.
Token
- Berlaku 24 jam pada konfigurasi API saat ini.
- Gunakan header
Authorization: Bearer .... - Jangan commit token aktif ke repository atau frontend publik.
Account
- Operasi tulis memerlukan user dengan flag admin.
- Login gagal menghasilkan HTTP 401.
- Token valid non-admin menghasilkan HTTP 403.
login.php dan register.php pada paket saat ini membandingkan/menyimpan password secara langsung. Untuk deployment production, pertimbangkan migrasi ke hashing password seperti password_hash() dan password_verify().