Ready · /generic/v1/punch

Generic Webhook JSON

Untuk middleware, brand planned (Fingerspot/Hikvision/Dahua), atau integrator custom yang bisa POST JSON.

Persiapan

Admin → Device ADMS → brand Lainnya / Integrator (atau brand planned).
Salin webhook_token device (ikon key untuk regenerate).
Endpoint: https://api-adms.absendigital.app/generic/v1/punch

Autentikasi

Authorization: Bearer adms_xxxxxxxx
X-ADMS-Token: adms_xxxxxxxx

Body — satu punch

POST /generic/v1/punch
Content-Type: application/json

{
  "pin": "1",
  "punched_at": "2026-11-14 08:00:00",
  "type": "MASUK"
}

Body — batch

{
  "serial_number": "OPSIONAL",
  "punches": [
    { "pin": "1", "punched_at": "2026-11-14 08:00:00", "type": "MASUK" },
    { "pin": "1", "punched_at": "2026-11-14 17:05:00", "type": "PULANG" }
  ]
}

Field

Field	Wajib	Keterangan
`pin`	Ya	User ID di mesin / sumber punch
`punched_at`	Ya	`YYYY-MM-DD HH:MM:SS` atau RFC3339
`type`	Tidak	`MASUK` / `PULANG`
`status_code`	Tidak	0=masuk, 1/5=pulang
`serial_number`	Tidak	Jika diisi harus cocok dengan device token

Contoh curl

curl -X POST https://api-adms.absendigital.app/generic/v1/punch \
  -H "Authorization: Bearer adms_TOKEN_ANDA" \
  -H "Content-Type: application/json" \
  -d '{"pin":"1","punched_at":"2026-11-14 08:00:00","type":"MASUK"}'

accepted bisa 0 jika PIN belum dimapping — punch tetap tercatat di log mentah.