Kesiswaan.

Sumber Foto Aplikasi Lain

Daftar aplikasi (BK, prestasi, ekstrakurikuler, dll.) yang fotonya ditampilkan di tab Foto pada detail siswa. Jumlahnya tidak dibatasi. Aplikasi tersebut harus mengikuti standar API foto di bawah.

+ Tambah Sumber Foto

Belum ada sumber foto. Klik Tambah Sumber Foto untuk menghubungkan aplikasi lain.

Standar API Foto Siswa (versi 1.0)

Ringkasan untuk pembuat aplikasi lain. Dokumen lengkap: docs/STANDAR-API-FOTO-SISWA.md.

  1. Permintaan: Kesiswaan memanggil GET {URL API} dengan header Authorization: Bearer {token} dan Accept: application/json. Di URL, {nisn}, {nipd}, atau {id} diganti data siswa. Contoh: https://bk.smknsituraja.sch.id/api/foto-siswa?nisn={nisn}
  2. Jawaban (HTTP 200, JSON): 
    {
  "versi": "1.0",
  "nisn": "0012345678",
  "data": [
    {
      "id": "kegiatan-77",
      "judul": "Juara 1 LKS Web Technology",
      "tanggal": "2026-08-17",
      "kategori": "Prestasi",
      "foto_url": "https://prestasi.sekolah.sch.id/foto/77.jpg",
      "thumbnail_url": "https://prestasi.sekolah.sch.id/foto/77-kecil.jpg",
      "keterangan": "Tingkat kabupaten",
      "tautan": "https://prestasi.sekolah.sch.id/prestasi/77"
    }
  ]
}
    Wajib: data dan foto_url setiap baris. Kosongkan data jika tidak ada foto. Maksimal 200 foto, terbaru dulu.
  3. File foto diambil server Kesiswaan dengan token yang sama (boleh dilindungi token), harus berada di domain URL API atau domain yang didaftarkan di kolom Domain Foto. JPG / PNG / WEBP / GIF, maks. 5 MB.
  4. Kode status: 401/403 = token ditolak; 404 = dianggap tidak ada foto; lainnya / lebih dari 5 detik = gagal.
  5. Privasi: kirim hanya foto siswa yang diminta, tanpa NIK / alamat / nomor HP. Gunakan HTTPS.