API Access

Admin and test console for quizzes and challenges.
Manage Quizzes Manage Challenges

API Access

Generate ready-to-use JSON API URLs so websites or plugins can fetch quiz questions and challenge stages.

Manage Quizzes Manage Challenges

How It Works

  • Parameter `limit` bisa berupa angka tetap seperti `20` atau range acak seperti `10-25`. Jika memakai range, setiap versi quiz akan mendapatkan angka acak sendiri-sendiri di dalam rentang itu.
  • Parameter `image_filter` mendukung `all`, `with_image`, dan `without_image` untuk memfilter item quiz, versi, atau pertanyaan berdasarkan ada atau tidaknya gambar.
  • Untuk quiz API: tanpa pilih quiz akan tampil daftar semua quiz beserta daftar versinya, pilih quiz akan tampil detail quiz dan daftar versinya, lalu pilih versi jika ingin mengambil daftar pertanyaan dan opsi.
  • Output quiz sekarang bertingkat: `quizzes` + `versions` untuk daftar semua quiz, `quiz` + `versions` untuk detail quiz, dan `quiz` + `version` + `questions` jika versi dipilih.
  • Jika `API Token` kosong pada quiz/challenge, endpoint bersifat publik dan bisa diakses siapa saja.
  • Jika `API Token` diisi, client wajib mengirim token lewat query `token`, header `X-QUIZZY-TOKEN`, atau `Authorization: Bearer ...`.

Quiz API

Endpoint JSON bertingkat untuk daftar quiz, detail quiz, versi, dan pertanyaan per versi.
`/api/quizzes` dan `/api/quizzes/{id}`
Bisa angka tetap seperti `20` atau range acak seperti `10-25`. Jika range dipakai, tiap versi mendapat angka acak yang berbeda.
Filter quiz, version, atau question berdasarkan ada atau tidaknya gambar.
Public API. Token tidak diperlukan.
Open JSON
Example `curl`
curl "https://qo1z.kiwipixel.com/api/quizzes/123?limit=200"

Challenge API

Endpoint JSON untuk stage challenge dan opsi per stage.
`/api/challenges/{id}`
Public API. Token tidak diperlukan.
Open JSON
Example `curl`
curl "https://qo1z.kiwipixel.com/api/challenges/123?limit=200"

JSON Notes

  • Quiz export tanpa pilihan quiz mengembalikan `quizzes`, dan setiap quiz berisi `versions`. Jika quiz dipilih mengembalikan `quiz` dan `versions`. Jika quiz + version dipilih mengembalikan `quiz`, `version`, dan `questions`.
  • Challenge export mengembalikan list stage dengan key seperti `category`, `stageKey`, `title`, `stageType`, `instructions`, dan `options`.
  • Pada quiz API, setiap object version menyertakan `questionLimit` agar frontend bisa langsung menampilkan badge jumlah soal hasil limit atau range acak per versi.
  • Pada quiz API, parameter `version_id` hanya dipakai saat ingin mengambil pertanyaan dari satu versi quiz tertentu.
  • Pada quiz API, parameter `image_filter` bisa dipakai untuk memfilter daftar quiz, daftar versi, atau daftar pertanyaan: `all`, `with_image`, atau `without_image`.
  • Parameter `limit` dibatasi maksimum `5000` item per request.