GET

/api/quotes/random

Mengambil satu quote secara random dari koleksi, dengan optional filter berdasarkan kategori.

URL

GET /api/quotes/random

Query Parameters

ParameterTypeRequiredDescription
categorystringNoFilter random quote berdasarkan kategori

Available Categories: motivasi, kesuksesan, kehidupan, cinta, pendidikan, kebahagiaan

Example Requests

Random Quote (Any Category)

GET /api/quotes/random

Mengambil 1 quote random dari semua kategori

Random Quote by Category

GET /api/quotes/random?category=motivasi

Mengambil 1 quote random dari kategori motivasi

Multiple Categories

GET /api/quotes/random?category=cinta

Mengambil 1 quote random dari kategori cinta

Success Response

200 OK
{
  "status": "SUCCESS",
  "message": "Random quote berhasil diambil",
  "data": {
    "id": 5,
    "text": "Impian tidak akan berubah menjadi kenyataan melalui keajaiban; itu butuh keringat, tekad, dan kerja keras.",
    "author": "Colin Powell",
    "category": "motivasi"
  },
  "metadata": {
    "totalAvailable": 4,
    "category": "motivasi"
  }
}

Note: Response akan berbeda setiap kali karena quote dipilih secara random.

Error Responses

404 Not Found
{
  "status": "ERROR",
  "message": "Tidak ada quote dengan kategori tersebut"
}

Terjadi ketika kategori yang diminta tidak memiliki quotes

429 Too Many Requests
{
  "status": "ERROR",
  "message": "Terlalu banyak permintaan. Coba lagi dalam beberapa saat."
}

Rate limit: 60 requests per minute (lebih tinggi untuk slideshow)

500 Internal Server Error
{
  "status": "ERROR",
  "message": "Gagal mengambil random quote"
}

Common Use Cases

🎯 Daily Inspiration App

Menampilkan quote inspirasi harian

GET /api/quotes/random

🎬 Slideshow Presentation

Auto-refresh quotes dalam slideshow

setInterval(() => fetch(‘/api/quotes/random’), 5000)

🎨 Themed Content

Quotes sesuai tema atau mood

GET /api/quotes/random?category=motivasi

Response Headers

HeaderDescription
X-RateLimit-RemainingSisa requests yang diperbolehkan (dari 60/minute)
X-RateLimit-ResetWaktu reset rate limit (ISO string)