Pendaftaran dan Link Ujian

Seluruh request pada halaman ini membutuhkan Bearer API Key.

Endpoint pendaftaran

GET /exams/{exam}/participants — Daftar peserta terdaftar

Parameter

Nama	Lokasi	Wajib	Tipe	Keterangan
`exam`	Path	Ya	integer	ID ujian.
`status`	Query	Tidak	integer	Status pendaftaran: `0` perlu diverifikasi, `1` aktif, `2` ditangguhkan, `3` perlu ditinjau, `4` selesai.
`search`	Query	Tidak	string	Mencari kode peserta atau nama peserta.
`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/12/participants?status=1&search=Budi&page=1&per_page=25" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Accept: application/json"

Contoh response

{
  "success": true,
  "message": null,
  "data": [
    {
      "user_exam_id": 4410,
      "participant_id": 340,
      "exam_id": 12,
      "participant_code": "TPA0000021",
      "status": 1,
      "status_label": "Aktif",
      "participant": {
        "id": 340,
        "name": "Budi Santoso",
        "email": "budi@sekolah.sch.id",
        "is_active": true,
        "is_verified": true,
        "verified_at": "2026-07-30T09:00:00+07:00",
        "label": { "id": 8, "name": "Kelas XII IPA" },
        "created_at": "2026-07-30T09:00:00+07:00",
        "updated_at": "2026-07-30T09:00:00+07:00"
      },
      "registered_at": "2026-07-30T10:00:00+07:00"
    }
  ],
  "meta": {
    "pagination": { "total": 1, "per_page": 25, "current_page": 1, "last_page": 1, "from": 1, "to": 1 }
  }
}

POST /exams/{exam}/participants — Mendaftarkan peserta ke ujian

Request ini aman untuk diulang. Peserta yang sudah terdaftar tidak didaftarkan dua kali, tetapi dilaporkan pada already_registered. Setiap pendaftaran baru mengirim webhook exam_participant.registered.Saat peserta didaftarkan:

Peserta mendapat kode peserta (participant_code) dan satu data hasil untuk setiap tes dalam ujian.
Pada ujian berjenjang, hanya tes pada jenjang pertama yang langsung aktif. Tes pada jenjang berikutnya terbuka setelah jenjang sebelumnya selesai.
Jika ujian memakai pembagian sesi otomatis (is_auto_assign_session: true), peserta ditempatkan pada sesi yang paling awal dibuat untuk setiap tes. Jika tidak, admin perlu menempatkan peserta ke sesi melalui panel sebelum peserta dapat mengerjakan tes. Sampai saat itu, link akses melaporkan locked_reason: "no_session".

Ujian yang sudah dikunci (is_locked: true) menolak pendaftaran dengan status 409. ID peserta yang tidak ditemukan pada projek dilaporkan pada rejected, misalnya { "participant_id": 999, "reason": "Peserta tidak ditemukan pada projek ini." }.

Parameter

Nama	Lokasi	Wajib	Tipe	Keterangan
`exam`	Path	Ya	integer	ID ujian.
`participant_ids`	Body	Ya	integer[]	Berisi 1–500 ID peserta.
`participant_ids.*`	Body	Ya	integer	ID peserta.

Contoh request

curl -X POST "https://app.indolat.com/api/v1/exams/12/participants" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{ "participant_ids": [340, 341, 342] }'

Contoh response

Status 201.

{
  "success": true,
  "message": "2 peserta didaftarkan, 1 sudah terdaftar, 0 ditolak.",
  "data": {
    "registered": [
      {
        "user_exam_id": 4410,
        "participant_id": 340,
        "exam_id": 12,
        "participant_code": "TPA0000021",
        "status": 1,
        "status_label": "Aktif",
        "participant": {
          "id": 340,
          "name": "Budi Santoso",
          "email": "budi@sekolah.sch.id",
          "is_active": true,
          "is_verified": true,
          "verified_at": "2026-07-30T09:00:00+07:00",
          "created_at": "2026-07-30T09:00:00+07:00",
          "updated_at": "2026-07-30T09:00:00+07:00"
        },
        "registered_at": "2026-08-03T10:00:00+07:00"
      },
      {
        "user_exam_id": 4411,
        "participant_id": 341,
        "exam_id": 12,
        "participant_code": "TPA0000022",
        "status": 1,
        "status_label": "Aktif",
        "participant": {
          "id": 341,
          "name": "Siti Aminah",
          "email": "siti@sekolah.sch.id",
          "is_active": true,
          "is_verified": true,
          "verified_at": "2026-07-30T09:00:00+07:00",
          "created_at": "2026-07-30T09:00:00+07:00",
          "updated_at": "2026-07-30T09:00:00+07:00"
        },
        "registered_at": "2026-08-03T10:00:00+07:00"
      }
    ],
    "already_registered": [342],
    "rejected": []
  },
  "meta": {
    "summary": { "registered": 2, "already_registered": 1, "rejected": 0 }
  }
}

GET /exams/{exam}/participants/{participant} — Status pendaftaran peserta

Respons memuat results, yaitu satu data hasil untuk setiap tes dalam ujian. Struktur setiap item sama dengan API Hasil Ujian.

Parameter

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

Contoh request

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

Contoh response

{
  "success": true,
  "message": null,
  "data": {
    "user_exam_id": 4410,
    "participant_id": 340,
    "exam_id": 12,
    "participant_code": "TPA0000021",
    "status": 1,
    "status_label": "Aktif",
    "participant": {
      "id": 340,
      "name": "Budi Santoso",
      "email": "budi@sekolah.sch.id",
      "is_active": true,
      "is_verified": true,
      "verified_at": "2026-07-30T09:00:00+07:00",
      "created_at": "2026-07-30T09:00:00+07:00",
      "updated_at": "2026-07-30T09:00:00+07:00"
    },
    "results": [
      {
        "id": 9812,
        "uuid": "9f1c2a2d-9739-4c2f-9a94-312a9cc1b4ad",
        "user_exam_id": 4410,
        "exam_quiz_id": 45,
        "exam_quiz_name": "Tes Potensi Akademik",
        "status": 1,
        "status_label": "Aktif",
        "score": null,
        "meta_score": null,
        "start_at": null,
        "end_at": null,
        "duration_seconds": null,
        "created_at": "2026-07-30T10:00:00+07:00",
        "updated_at": "2026-07-30T10:00:00+07:00"
      }
    ],
    "registered_at": "2026-07-30T10:00:00+07:00"
  }
}

DELETE /exams/{exam}/participants/{participant} — Membatalkan pendaftaran

Permintaan ditolak dengan status 409 apabila peserta sudah menyelesaikan salah satu tes atau sudah memiliki nilai pada ujian ini. Pembatalan menghapus kode peserta beserta seluruh data tes peserta pada ujian tersebut, lalu mengirim webhook exam_participant.unregistered.

Parameter

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

Contoh request

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

Contoh response

{
  "success": true,
  "message": "Pendaftaran peserta pada ujian berhasil dibatalkan.",
  "data": null
}

POST /exams/{exam}/participants/{participant}/access-links — Membuat link akses ujian

Menghasilkan satu link untuk setiap tes dalam ujian. Link tersebut membuat peserta langsung masuk tanpa mengetik kata sandi, lalu membuka halaman persiapan tes.Perilaku link:

Setiap link hanya dapat dipakai satu kali, dan harus dipakai sebelum expires_at. Masa berlaku default 1.440 menit (24 jam), maksimal 10.080 menit (7 hari). Link yang sudah dipakai atau sudah kedaluwarsa menampilkan pesan bahwa link tidak berlaku lagi.
Jika peserta perlu masuk kembali, misalnya setelah menutup tab, berpindah perangkat, atau koneksi terputus, buat link baru. Link baru untuk tes yang sedang dikerjakan melanjutkan pengerjaan yang sama, bukan memulai ulang.
Link yang dibuat sebelumnya tetap berlaku sampai dipakai atau kedaluwarsa.
exam_url tetap dikembalikan walaupun tes belum dapat dikerjakan. Periksa can_start sebelum mengarahkan peserta. Link untuk tes dengan can_start: false tidak membuka tes; peserta diarahkan ke dashboard CBT atau mendapat halaman tidak ditemukan.
Satu peserta hanya dapat memiliki satu sesi login aktif. Membuka link di perangkat lain mengakhiri sesi di perangkat sebelumnya.
Peserta nonaktif tidak dapat masuk melalui link. Link tetap dibuat, dan message pada respons menjelaskan bahwa peserta sedang nonaktif.
Jika return_url dikirim, halaman Tes Selesai menampilkan tombol Lanjutkan yang membawa peserta ke URL tersebut setelah tes terakhir dalam pengerjaan itu selesai. Tanpa return_url, halaman tersebut tetap menampilkan tombol Kembali ke Daftar Tes.

Link akses dirancang untuk alur redirect dari aplikasi Anda, misalnya tombol “Mulai Ujian”. Buat link tepat saat peserta menekan tombol dengan expires_in_minutes yang singkat (misalnya 5–15 menit), lalu langsung redirect peserta. Jangan menyimpan link atau mengirimkannya melalui email atau chat: beberapa aplikasi chat dan email membuka link secara otomatis untuk pratinjau, sehingga link sudah terpakai sebelum peserta mengkliknya.

Parameter

Nama	Lokasi	Wajib	Tipe	Keterangan
`exam`	Path	Ya	integer	ID ujian.
`participant`	Path	Ya	integer	ID peserta yang telah terdaftar.
`expires_in_minutes`	Body	Tidak	integer	Masa berlaku link, `1–10080`. Default `1440`.
`return_url`	Body	Tidak	string	URL lengkap tujuan tombol Lanjutkan setelah tes selesai, maksimal 2.048 karakter. Wajib `https://`, dan domainnya harus terdaftar (lihat di bawah). Path dan query string bebas.

Daftarkan domain return_url pada kolom Domain Redirect Setelah Ujian di Pengaturan Aplikasi → Integrasi API. Tulis nama domain saja tanpa https:// dan tanpa path, pisahkan dengan koma, misalnya portal.smanusantara.example.com, ujian.smanusantara.example.com. Domain dicocokkan persis: mendaftarkan smanusantara.example.com tidak otomatis mengizinkan subdomainnya, jadi daftarkan setiap subdomain yang dipakai. Port pada return_url tidak ikut dicocokkan.

Field respons per link

Field	Keterangan
`exam_quiz_id`, `exam_quiz_name`	Tes yang dibuka oleh link.
`user_result_exam_uuid`	ID pengerjaan tes peserta, sama dengan `uuid` pada API Hasil Ujian.
`status`	Status hasil tes: `0` pending, `1` aktif, `2` selesai, `3` ditolak.
`progress`	`not_started`, `in_progress`, atau `finished`.
`has_session`	`true` jika peserta sudah ditempatkan pada sesi.
`session`	Jadwal sesi (`start_at`, `end_at`), atau `null` jika belum ada sesi.
`can_start`	`true` jika peserta dapat memulai atau melanjutkan tes ini sekarang.
`locked_reason`	Penyebab tes belum dapat dikerjakan, atau `null` jika `can_start` bernilai `true`.
`exam_url`	Link akses tes.
`expires_at`	Waktu kedaluwarsa link.

Nilai locked_reason:

finished — tes sudah selesai dikerjakan.
unavailable — ujian di luar jadwal atau diarsipkan, pendaftaran peserta ditangguhkan atau sudah selesai, atau tes ditolak.
payment — tes menunggu pembayaran.
pending — jenjang tes belum terbuka, atau pendaftaran masih menunggu verifikasi.
order — tes harus dikerjakan berurutan dan tes sebelumnya belum selesai.
no_session — peserta belum ditempatkan pada sesi, atau sesinya belum memiliki paket soal.
no_questions — paket soal pada sesi belum berisi soal.
outside_session — waktu saat ini berada di luar jadwal sesi.

Status 404 dikembalikan jika ujian atau peserta tidak ditemukan, atau peserta belum terdaftar pada ujian. Status 422 dikembalikan jika ujian belum memiliki tes, atau jika return_url tidak memakai https:// atau domainnya belum terdaftar.

Contoh request

curl -X POST "https://app.indolat.com/api/v1/exams/12/participants/340/access-links" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{ "expires_in_minutes": 10, "return_url": "https://portal.smanusantara.example.com/ujian/selesai" }'

Contoh response

{
  "success": true,
  "message": null,
  "data": {
    "participant_id": 340,
    "exam_id": 12,
    "links": [
      {
        "exam_quiz_id": 45,
        "exam_quiz_name": "Tes Potensi Akademik",
        "user_result_exam_uuid": "9f1c2a2d-9739-4c2f-9a94-312a9cc1b4ad",
        "status": 1,
        "progress": "not_started",
        "has_session": true,
        "session": {
          "start_at": "2026-08-10T08:00:00+07:00",
          "end_at": "2026-08-10T10:00:00+07:00"
        },
        "can_start": true,
        "locked_reason": null,
        "exam_url": "https://smanusantara.cbt.example.com/auth/ssologin?payload=...",
        "expires_at": "2026-08-10T08:15:00+07:00"
      },
      {
        "exam_quiz_id": 46,
        "exam_quiz_name": "Tes Bahasa Inggris",
        "user_result_exam_uuid": "3b7e5d10-1c2f-4a8e-b0e4-6a2f1d9c7e21",
        "status": 1,
        "progress": "not_started",
        "has_session": true,
        "session": {
          "start_at": "2026-08-10T08:00:00+07:00",
          "end_at": "2026-08-10T10:00:00+07:00"
        },
        "can_start": false,
        "locked_reason": "order",
        "exam_url": "https://smanusantara.cbt.example.com/auth/ssologin?payload=...",
        "expires_at": "2026-08-10T08:15:00+07:00"
      }
    ]
  }
}

​Endpoint pendaftaran

​Parameter

​Contoh request

​Contoh response

​Parameter

​Contoh request

​Contoh response

​Parameter

​Contoh request

​Contoh response

​Parameter

​Contoh request

​Contoh response

​Parameter

​Field respons per link

​Contoh request

​Contoh response

Endpoint pendaftaran

Parameter

Contoh request

Contoh response

Parameter

Contoh request

Contoh response

Parameter

Contoh request

Contoh response

Parameter

Contoh request

Contoh response

Parameter

Field respons per link

Contoh request

Contoh response