Memulai
Sumber daya inti
Lainnya

Riwayat Karir

Info
Riwayat Karier hanya didukung di API versi 2 (/api/partner/v2/add/requests/career_history). Permintaan memerlukan cakupan OAuth write.career_history.

Deskripsi kolom

Lihat spesifikasi OpenAPI untuk skema lengkap (termasuk bidang opsional).
{
  "credential_id": { "type": "string" }, // (Required) Unique identifier for this credential payload
  "fields": { // { "type": "object" }, (Required)
    "full_name": { "type": "string" }, // (Required)
    "employment" : [
      {
        "organisation": { "type": "string" }, // (Required) Name of the company or employer
        "role_classification": { "type": "string" }, // Category or type of the position held
        "role_title": { "type": "string" }, // Official job title for the employment period
        "start_date": { "type": "string", "format": "date" }, // (Required) Date employment began, Date format: "YYYY-MM"
        "end_date": { "anyOf": [ { "type": "string", "format": "date"}, { "type": "null" }] }, // Date employment ended, Date format: "YYYY-MM"
        "last_processed_month": { "type": "string", "format": "date" }, // (Required) Most recent month for which employment data was updated, Date format: "YYYY-MM"
      }
    ]
  },
  "partner_chain": { "type": ["array", "null"] } // (Optional unless otherwise specified) Array of objects to specifiy partner institutions, e.g. [{ "name": "Partner Organization" }]
}

Memanfaatkan kolom Riwayat Karier

Berikut adalah penjelasan detail untuk setiap kolom dalam Kredensial Riwayat Karier. Deskripsi ini dimaksudkan untuk membantu mitra memahami tujuan dan penggunaan yang benar untuk setiap kolom:

Kolom objek kredensial

  • full_name: Nama lengkap resmi individu yang riwayat kariernya sedang dijelaskan. Ini harus sesuai dengan nama yang tercantum pada dokumen resmi.
  • employment: Array berisi catatan pekerjaan, masing-masing mewakili periode kerja yang berbeda.

Kolom objek pekerjaan

  • organisation: Nama perusahaan atau pemberi kerja tempat individu tersebut bekerja. Ini harus merupakan nama resmi atau nama yang umum dikenal dari organisasi tersebut.
  • role_classification: Kategori atau klasifikasi umum dari jabatan yang dipegang. Ini harus berupa label standar yang luas untuk menjelaskan jenis pekerjaan yang dilakukan, seperti "Software Engineer", "Accountant", "Project Manager", atau "Sales Representative".
  • role_title: Nama jabatan spesifik yang dipegang individu tersebut selama periode kerja ini. Ini harus merupakan jabatan resmi yang digunakan oleh pemberi kerja, seperti "Associate Software Engineer", "Senior Manager", atau "Sales Executive". Ini mencerminkan nama posisi yang tepat seperti tercatat dalam kontrak kerja, slip gaji, atau dokumen resmi lainnya.
Catatan: Setidaknya salah satu dari role_classification atau role_title harus disediakan untuk setiap catatan pekerjaan. Mengisi keduanya disarankan agar lebih jelas, tetapi jika hanya salah satu yang tersedia, pastikan kolom tersebut diisi.
  • start_date: Bulan dan tahun saat pekerjaan dimulai, dengan format "YYYY-MM". Kolom ini wajib diisi.
  • end_date: Bulan dan tahun saat pekerjaan berakhir, dengan format "YYYY-MM". Jika individu tersebut masih bekerja, kolom ini boleh dikosongkan.
  • last_processed_month: Bulan terbaru saat data pekerjaan diperbarui, dengan format "YYYY-MM". Kolom ini wajib diisi dan harus mencerminkan bulan terbaru saat status atau detail pekerjaan dikonfirmasi.
Catatan: Semua kolom tanggal harus menggunakan format "YYYY-MM" (misalnya, "2023-01").

Rantai mitra

Kolom partner_chain mencatat hubungan perantara dalam hierarki mitra berlapis yang tidak direpresentasikan di bagian lain dalam integrasi. Ini meningkatkan granularitas analitik yang dapat diberikan SEEK Pass kepada Anda.Klik di sini untuk detail lebih lanjut.

Contoh payload

{
  "credential_id": "fa651300-b91a-49cb-8ee7-cac68b3fdf74",
  "fields": {
    "full_name": "John Doe",
    "employment": [
      {
        "organisation": "Company A",
        "role_classification": "Software Engineer",
        "role_title": "Associate Software Engineer",
        "start_date": "2020-01",
        "end_date": "2022-12",
        "last_processed_month": "2023-01"
      },
      {
        "organisation": "Company B",
        "role_classification": "Software Engineer",
        "role_title": "Senior Software Engineer",
        "start_date": "2023-02",
        "last_processed_month": "2024-05"
      }
    ]
  }
}