Job Application Succeed Notification

Deskripsi

Webhook ini berfungsi untuk memberitahu sistem eksternal bahwa ada lamaran baru yang telah masuk dari Karirhub.
Melalui webhook ini, sistem penerima dapat:

mencatat data lamaran,

menampilkan notifikasi kepada kandidat atau perusahaan, dan

melakukan proses bisnis lanjutan seperti verifikasi data pelamar atau penjadwalan wawancara.

Keamanan dan Validasi Webhook

Disarankan bagi klien untuk memvalidasi setiap request webhook yang diterima dengan melakukan verifikasi terhadap nilai Signature yang dikirim di header permintaan.
Langkah ini penting untuk memastikan bahwa permintaan tersebut benar-benar berasal dari sistem resmi Karirhub dan bukan dari pihak yang tidak berwenang.

Webhook akan selalu mengirimkan header berikut:

Header Name	Deskripsi
`Client-Id`	Digunakan untuk mengidentifikasi klien yang terdaftar dalam sistem Kemnaker.
`Request-Id`	String unik untuk mencegah pemrosesan duplikat pada permintaan webhook.
`Request-Timestamp`	Waktu pengiriman request dalam format ISO8601 (UTC+0) untuk memastikan keabsahan waktu permintaan.
`Signature`	Token keamanan yang digunakan untuk memverifikasi integritas dan keaslian data.

Klien wajib melakukan verifikasi Signature menggunakan algoritma HMAC-SHA256 sesuai panduan keamanan yang diberikan.
Dengan validasi ini, sistem penerima dapat memastikan bahwa data yang diterima:

Tidak dimodifikasi selama transmisi, dan

Berasal dari sumber yang sah serta terlindungi dari akses tidak berwenang.

Request

Header Params

Body Params application/json

Example

{
  "id": "d6d3dca7-7bb8-41c5-a197-c5b235e94010",
  "applied_at": "2025-10-14 22:00:00",
  "job": {
    "id": "4721992b-dbf5-4e6e-83c6-79fe31497c80",
    "title": "Fullstack Developer"
  },
  "job_seeker": {
    "name": "Budi Setiadi",
    "age": 28,
    "pob": "Sabang",
    "gender": "male",
    "province": "SUMATERA UTARA",
    "city": "KOTA GUNUNGSITOLI"
  },
  "experiences": [
    {
      "id": "fb9b2677-412d-47e2-8168-d0dedcd38ebd",
      "job": "Fullstack Developer",
      "region": "Cilandak Barat, Cilandak, Kota Jakarta Selatan, DKI Jakarta, Indonesia",
      "company": "PT. MAJU MUNDUR SEJAHTERA",
      "job_type": "full_time",
      "start_year": 2021,
      "finish_year": 2023,
      "start_month": 1,
      "finish_month": 12
    }
  ],
  "trainings": [
    {
      "id": "1d6c0166-1392-4889-bacf-51a229710371",
      "region": "Mampang Prapatan, Mampang Prapatan, Jakarta Selatan, DKI Jakarta, Indonesia",
      "start_year": 2018,
      "vocational": "TEKNOLOGI INFORMASI DAN KOMUNIKASI",
      "finish_year": 2018,
      "start_month": 6,
      "finish_month": 9,
      "sub_vocational": "PEMROGRAMAN",
      "training_center": "Badan Sertifikasi Nasional",
      "training_program": "Fullstack Developer"
    }
  ],
  "educations": [
    {
      "id": "30805eda-163b-4040-8d2b-f4af3c01afeb",
      "grade": "3",
      "school": "Universitas Indonesia",
      "graduate": "S1",
      "activities": null,
      "start_year": 2010,
      "description": null,
      "finish_year": 2014,
      "study_field": "Sarjana Teknik Informatika"
    }
  ],
  "certifications": [
    {
      "id": "e1ab6abf-58f0-4462-98ba-f391866ff4db",
      "program": "Enterprise Software",
      "scoring": "90",
      "expire_year": 2027,
      "institution": "BSN",
      "issued_year": 2024,
      "expire_month": 12,
      "issued_month": 4
    }
  ],
  "achievements": [
    {
      "id": "5e0efe3f-a4b0-4a08-81d6-e7511eceb6d8",
      "name": "Terpilih sebagai Developer Terbaik",
      "organizer": "IT Telkom Bandung",
      "description": null,
      "achieved_at_year": 2021,
      "achieved_at_month": 5
    }
  ],
  "skills": [
    "Software Development",
    "SQL",
    "Google Cloud Platform",
    "Bertukar pendapat",
    "Mengumpulkan data",
    "Keterampilan negosiasi",
    "Bootstrap (Web Application Framework)",
    "Laravel Framework",
    "Spring Framework (Java)",
    "Kemampuan pemecahan masalah",
    "Backend Development"
  ],
  "languages": [
    {
      "id": "95fef248-a7f2-41d5-adcb-408fd926ca12",
      "name": "English",
      "proficiency": "Tingkat Menengah"
    }
  ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://your-api-server.com' \
--header 'Client-Id;' \
--header 'Request-Id;' \
--header 'Request-Timestamp;' \
--header 'Signature;' \
--header 'Content-Type: application/json' \
--data-raw '{
  "id": "d6d3dca7-7bb8-41c5-a197-c5b235e94010",
  "applied_at": "2025-10-14 22:00:00",
  "job": {
    "id": "4721992b-dbf5-4e6e-83c6-79fe31497c80",
    "title": "Fullstack Developer"
  },
  "job_seeker": {
    "name": "Budi Setiadi",
    "age": 28,
    "pob": "Sabang",
    "gender": "male",
    "province": "SUMATERA UTARA",
    "city": "KOTA GUNUNGSITOLI"
  },
  "experiences": [
    {
      "id": "fb9b2677-412d-47e2-8168-d0dedcd38ebd",
      "job": "Fullstack Developer",
      "region": "Cilandak Barat, Cilandak, Kota Jakarta Selatan, DKI Jakarta, Indonesia",
      "company": "PT. MAJU MUNDUR SEJAHTERA",
      "job_type": "full_time",
      "start_year": 2021,
      "finish_year": 2023,
      "start_month": 1,
      "finish_month": 12
    }
  ],
  "trainings": [
    {
      "id": "1d6c0166-1392-4889-bacf-51a229710371",
      "region": "Mampang Prapatan, Mampang Prapatan, Jakarta Selatan, DKI Jakarta, Indonesia",
      "start_year": 2018,
      "vocational": "TEKNOLOGI INFORMASI DAN KOMUNIKASI",
      "finish_year": 2018,
      "start_month": 6,
      "finish_month": 9,
      "sub_vocational": "PEMROGRAMAN",
      "training_center": "Badan Sertifikasi Nasional",
      "training_program": "Fullstack Developer"
    }
  ],
  "educations": [
    {
      "id": "30805eda-163b-4040-8d2b-f4af3c01afeb",
      "grade": "3",
      "school": "Universitas Indonesia",
      "graduate": "S1",
      "activities": null,
      "start_year": 2010,
      "description": null,
      "finish_year": 2014,
      "study_field": "Sarjana Teknik Informatika"
    }
  ],
  "certifications": [
    {
      "id": "e1ab6abf-58f0-4462-98ba-f391866ff4db",
      "program": "Enterprise Software",
      "scoring": "90",
      "expire_year": 2027,
      "institution": "BSN",
      "issued_year": 2024,
      "expire_month": 12,
      "issued_month": 4
    }
  ],
  "achievements": [
    {
      "id": "5e0efe3f-a4b0-4a08-81d6-e7511eceb6d8",
      "name": "Terpilih sebagai Developer Terbaik",
      "organizer": "IT Telkom Bandung",
      "description": null,
      "achieved_at_year": 2021,
      "achieved_at_month": 5
    }
  ],
  "skills": [
    "Software Development",
    "SQL",
    "Google Cloud Platform",
    "Bertukar pendapat",
    "Mengumpulkan data",
    "Keterampilan negosiasi",
    "Bootstrap (Web Application Framework)",
    "Laravel Framework",
    "Spring Framework (Java)",
    "Kemampuan pemecahan masalah",
    "Backend Development"
  ],
  "languages": [
    {
      "id": "95fef248-a7f2-41d5-adcb-408fd926ca12",
      "name": "English",
      "proficiency": "Tingkat Menengah"
    }
  ]
}'

Job Application Succeed Notification

Deskripsi#

Keamanan dan Validasi Webhook#

Request

Request Code Samples

Responses

Deskripsi

Keamanan dan Validasi Webhook