API Ujian - CBT Indolat

Seluruh request pada halaman ini membutuhkan Bearer API Key.

Endpoint ujian

Halaman ini berisi endpoint untuk membaca ujian. Membuat dan mengubah ujian, tes, dan sesi lewat API dijelaskan di Pengaturan Ujian, sedangkan soal dikirim lewat API Import Soal.

Field penting pada ujian

Field	Keterangan
`is_active`	Pendaftaran ujian dibuka.
`is_locked`	Ujian dikunci (misalnya karena diarsipkan). Ujian yang dikunci menolak pendaftaran peserta melalui API.
`is_hidden`	Ujian diarsipkan dan tidak tampil bagi peserta.
`is_tiered`	Ujian berjenjang: tes pada jenjang berikutnya terbuka setelah jenjang sebelumnya selesai.
`is_auto_assign_session`	Peserta yang didaftarkan otomatis ditempatkan pada sesi yang paling awal dibuat untuk setiap tes. Jika `false`, sesi ditentukan admin melalui panel.
`is_must_be_in_order`	Tes harus dikerjakan berurutan sesuai `level`.
`is_force_complete`	Tes harus diselesaikan tanpa jeda sebelum lanjut ke tes berikutnya.
`is_show_score`	Nilai akhir ditampilkan kepada peserta di CBT. Tidak membatasi nilai yang tersedia melalui API.
`edition`	`standard` (Ujian Standard) atau `professional` (Ujian Professional). Menentukan kredit yang dipakai saat peserta mulai, batas jumlah tes, serta ketersediaan CAT dan proctoring kamera, layar, dan dual monitor.
`final_score_type`	Cara menghitung nilai akhir ujian dari nilai tes: `1` akumulasi, `2` rata-rata.
`paid_type`	`1` gratis, `2` sekali bayar, `3` berbayar per tes, `4` berbayar per jenjang.

Pada tes (exam_quizzes), exam_type bernilai cbt, cat, atau manual, duration_minutes adalah durasi pengerjaan tes, score_type adalah metode penilaian, dan field is_* adalah pengaturan tes (lihat Pengaturan Ujian). Pada sesi, question_bank_id adalah ID paket soal yang dikerjakan pada sesi tersebut.

GET /exams — Daftar ujian

Parameter

Nama	Lokasi	Wajib	Tipe	Keterangan
`search`	Query	Tidak	string	Mencari nama atau nama singkat ujian.
`is_active`	Query	Tidak	boolean	Filter status aktif.
`is_tiered`	Query	Tidak	boolean	Filter ujian berjenjang.
`start_from`	Query	Tidak	datetime	Waktu mulai minimum dalam format ISO 8601 dan harus di-URL-encode.
`start_until`	Query	Tidak	datetime	Waktu mulai maksimum dalam format ISO 8601 dan harus di-URL-encode.
`page`	Query	Tidak	integer	Nomor halaman. Default `1`.
`per_page`	Query	Tidak	integer	Data per halaman, `1–100`. Default `25`.

Contoh request

curl -X GET "https://app.indolat.com/api/v1/exams?search=Tes%20Masuk&is_active=true&page=1&per_page=25" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Accept: application/json"

Contoh response

{
  "success": true,
  "message": null,
  "data": [
    {
      "id": 12,
      "name": "Tes Masuk 2026",
      "name_short": "TPA",
      "slug": "tes-masuk-2026",
      "description": "Seleksi penerimaan peserta didik baru.",
      "price": 0,
      "start_at": "2026-08-10T08:00:00+07:00",
      "end_at": "2026-08-10T12:00:00+07:00",
      "is_active": true,
      "is_locked": false,
      "is_hidden": false,
      "is_tiered": false,
      "is_auto_assign_session": true,
      "is_show_score": true,
      "final_score_type": 2,
      "final_score_type_label": "Rata-Rata Tes Ujian",
      "paid_type": 1,
      "paid_type_label": "Gratis",
      "registration_quota": 500,
      "participants_count": 120,
      "created_at": "2026-07-01T08:00:00+07:00",
      "updated_at": "2026-07-30T08:00:00+07:00"
    }
  ],
  "meta": {
    "pagination": { "total": 1, "per_page": 25, "current_page": 1, "last_page": 1, "from": 1, "to": 1 }
  }
}

GET /exams/{exam} — Detail ujian

Parameter

Nama	Lokasi	Wajib	Tipe	Keterangan
`exam`	Path	Ya	integer	ID ujian.

Contoh request

curl -X GET "https://app.indolat.com/api/v1/exams/12" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Accept: application/json"

Contoh response

{
  "success": true,
  "message": null,
  "data": {
    "id": 12,
    "name": "Tes Masuk 2026",
    "name_short": "TPA",
    "slug": "tes-masuk-2026",
    "description": "Seleksi penerimaan peserta didik baru.",
    "price": 0,
    "start_at": "2026-08-10T08:00:00+07:00",
    "end_at": "2026-08-10T12:00:00+07:00",
    "is_active": true,
    "is_locked": false,
    "is_hidden": false,
    "is_tiered": false,
    "is_auto_assign_session": true,
    "is_must_be_in_order": false,
    "is_force_complete": false,
    "is_show_score": true,
    "edition": "professional",
    "final_score_type": 2,
    "final_score_type_label": "Rata-Rata Tes Ujian",
    "paid_type": 1,
    "paid_type_label": "Gratis",
    "registration_quota": 500,
    "exam_quizzes": [
      {
        "id": 45,
        "exam_id": 12,
        "name": "Tes Potensi Akademik",
        "level": 1,
        "duration_minutes": 90,
        "exam_type": "cbt",
        "exam_type_label": "Computer Based Test (CBT)",
        "score_type": "score",
        "score_type_label": "Perhitungan Skor Soal (Akumulasi Benar/Salah)",
        "price": 0,
        "description": null,
        "is_show_score": false,
        "is_show_summary": false,
        "is_show_explanation_per_question": false,
        "is_switch_tab_proctoring": true,
        "is_camera_proctoring": false,
        "is_screen_proctoring": false,
        "is_dual_screen_proctoring": false,
        "is_audio_question_only_once": false,
        "is_audio_answer_only_once": false,
        "sessions": [
          {
            "id": 91,
            "exam_quiz_id": 45,
            "name": "Sesi Pagi",
            "start_at": "2026-08-10T08:00:00+07:00",
            "end_at": "2026-08-10T10:00:00+07:00",
            "question_bank_id": 88
          }
        ],
        "created_at": "2026-07-01T08:00:00+07:00",
        "updated_at": "2026-07-01T08:00:00+07:00"
      }
    ],
    "participants_count": 120,
    "created_at": "2026-07-01T08:00:00+07:00",
    "updated_at": "2026-07-30T08:00:00+07:00"
  }
}

GET /exams/{exam}/quizzes — Daftar tes dalam ujian

Tes diurutkan berdasarkan level, lalu ID.

Parameter

Nama	Lokasi	Wajib	Tipe	Keterangan
`exam`	Path	Ya	integer	ID ujian.

Contoh request

curl -X GET "https://app.indolat.com/api/v1/exams/12/quizzes" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Accept: application/json"

Contoh response

{
  "success": true,
  "message": null,
  "data": [
    {
      "id": 45,
      "exam_id": 12,
      "name": "Tes Potensi Akademik",
      "level": 1,
      "duration_minutes": 90,
      "exam_type": "cbt",
      "exam_type_label": "Computer Based Test (CBT)",
      "score_type": "score",
      "score_type_label": "Perhitungan Skor Soal (Akumulasi Benar/Salah)",
      "price": 0,
      "description": null,
      "is_show_score": false,
      "is_show_summary": false,
      "is_show_explanation_per_question": false,
      "is_switch_tab_proctoring": true,
      "is_camera_proctoring": false,
      "is_screen_proctoring": false,
      "is_dual_screen_proctoring": false,
      "is_audio_question_only_once": false,
      "is_audio_answer_only_once": false,
      "sessions": [
        {
          "id": 91,
          "exam_quiz_id": 45,
          "name": "Sesi Pagi",
          "start_at": "2026-08-10T08:00:00+07:00",
          "end_at": "2026-08-10T10:00:00+07:00",
          "question_bank_id": 88
        }
      ],
      "created_at": "2026-07-01T08:00:00+07:00",
      "updated_at": "2026-07-01T08:00:00+07:00"
    }
  ]
}

GET /exams/{exam}/sessions — Daftar sesi ujian

Berisi sesi dari seluruh tes dalam ujian, diurutkan berdasarkan waktu mulai.

Parameter

Nama	Lokasi	Wajib	Tipe	Keterangan
`exam`	Path	Ya	integer	ID ujian.

Contoh request

curl -X GET "https://app.indolat.com/api/v1/exams/12/sessions" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Accept: application/json"

Contoh response

{
  "success": true,
  "message": null,
  "data": [
    {
      "id": 91,
      "exam_quiz_id": 45,
      "name": "Sesi Pagi",
      "start_at": "2026-08-10T08:00:00+07:00",
      "end_at": "2026-08-10T10:00:00+07:00",
      "question_bank_id": 88
    }
  ]
}

GET /exams/{exam}/registration-link — Link pendaftaran mandiri

Membutuhkan add-on Halaman Pendaftaran Ujian dan Pembayaran Otomatis. Jika add-on tidak aktif, permintaan ditolak dengan status 403. Link yang dikembalikan adalah link pendek yang mengarah ke halaman pendaftaran mandiri ujian.

Parameter

Nama	Lokasi	Wajib	Tipe	Keterangan
`exam`	Path	Ya	integer	ID ujian.

Contoh request

curl -X GET "https://app.indolat.com/api/v1/exams/12/registration-link" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Accept: application/json"

Contoh response

{
  "success": true,
  "message": null,
  "data": {
    "exam_id": 12,
    "registration_url": "https://app.indolat.com/link/aB3xZ"
  }
}

​Endpoint ujian

​Field penting pada ujian

​Parameter

​Contoh request

​Contoh response

​Parameter

​Contoh request

​Contoh response

​Parameter

​Contoh request

​Contoh response

​Parameter

​Contoh request

​Contoh response

​Parameter

​Contoh request

​Contoh response

Endpoint ujian

Field penting pada ujian

Parameter

Contoh request

Contoh response

Parameter

Contoh request

Contoh response

Parameter

Contoh request

Contoh response

Parameter

Contoh request

Contoh response

Parameter

Contoh request

Contoh response