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: Salah satu dari role_classification atau role_title harus disediakan untuk setiap catatan pekerjaan jika data tersebut tersedia. Menyediakan keduanya disarankan untuk kejelasan, tetapi jika hanya salah satunya yang tersedia, pastikan bidang tersebut diisi. Jika keduanya tidak tersedia, kedua bidang dapat dihilangkan.
  • 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, diformat sebagai "YYYY-MM". Kolom ini wajib diisi dan harus mencerminkan bulan terbaru saat status atau detail pekerjaan dikonfirmasi. end_date tidak akan ditampilkan kecuali last_processed_month berada setelah end_date,
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"
      }
    ]
  }
}