Dokumentasi API

Menghubungkan dan Bekerja dengan API Shifton

API Shifton memberi Anda akses ke semua fitur utama dari platform ini — mulai dari pengelolaan jadwal hingga integrasi dengan HR, payroll, dan sistem analitik eksternal..
Dengan menggunakan API, Anda dapat mengotomatisasi proses dan menghubungkan Shifton dengan layanan internal perusahaan Anda.


Dokumentasi API

Kami mendukung dua versi dokumentasi kami:


Memulai

Dapatkan Kunci API

Di pengaturan perusahaan Anda di platform Shifton, buat kunci API.
Otorisasi dilakukan melalui header:

Authorization: Bearer {your_api_key}

Buat Permintaan Pertama Anda

Sebagai contoh, untuk mengambil daftar karyawan:

GET /api/v1/employees
Host: api2.shifton.com
Authorization: Bearer {your_api_key}

Contoh respons:

{
"data": [
{
"id": 101,
"name": "Alice Johnson",
"position": "HR Manager"
},
{
"id": 102,
"name": "Bob Smith",
"position": "Cashier"
}
]
}

Integrasikan API ke dalam Alur Kerja Anda

  • Buat dan modifikasi shift secara otomatis

  • Kelola permintaan cuti dan sakit

  • Ekspor data ke sistem payroll

  • Bangun dasbor dan laporan kustom


Kemampuan API Inti

  • Karyawan – tambah, edit, dan kelola peran

  • Jadwal – buat, sesuaikan shift, rencanakan pekerjaan

  • Cuti & Ketidakhadiran – kelola permintaan cuti dan sakit

  • Pelaporan – ekspor data waktu, penggajian, dan kehadiran


Kode Kesalahan

API Shifton menggunakan standarKode status HTTP:

  • 200 — Permintaan berhasil

  • 201 — Objek berhasil dibuat

  • 400 — Parameter tidak valid

  • 401 — Kesalahan otorisasi (kunci API tidak valid)

  • 403 — Akses ditolak

  • 404 — Sumber daya tidak ditemukan

  • 500 — Kesalahan server


Tips Penggunaan

  • Selalu gunakanversi API terbaru untuk integrasi baru

  • Gunakan Postman atau curl untuk pengujian

  • Hormati batasan tingkat untuk menghindari pemblokiran

  • Perbarui integrasi yang masih bergantung pada dokumentasi lama


Bagikan postingan ini