JOSS
  1. Lowongan Pekerjaan
JOSS
  • Gambaran Umum
  • Autentikasi
  • Referensi Data
  • Endpoint API
    • Perusahaan
      • Put Company
      • Find Company
      • Delete Company
    • Lowongan Pekerjaan
      • Put Job Vacancy
        PUT
      • Find Job Vacancy
        GET
      • Delete Job Vacancy
        DELETE
  1. Lowongan Pekerjaan

Put Job Vacancy

Testing
PUT
{{base_url}}/api/v1/jobs/{id}/industrial-vacancy
API ini digunakan untuk membuat atau memperbarui data lowongan pekerjaan berdasarkan ID yang diberikan. Jika ID sudah ada, data lowongan pekerjaan yang sesuai akan diperbarui. Jika tidak ada lowongan pekerjaan dengan ID tersebut, API akan membuat lowongan pekerjaan baru dengan data yang diberikan. API ini dirancang agar dapat diakses (dihit) berulang kali, memungkinkan pembaruan data lowongan pekerjaan secara berkala atau berulang untuk memastikan informasi tetap terkini.

Request

Path Params
id
string 
required
ID unik yang digunakan untuk mengidentifikasi lowongan pekerjaan dalam sistem klien. Ini adalah primary key yang diberikan untuk setiap entri lowongan pekerjaan yang terdaftar di sistem. Maksimal panjangnya adalah 50 karakter.
Example:
9e026c9e-0d8a-4c42-979c-989dde40d40c
Header Params
Client-Id
string 
required
ID unik yang diperoleh dari Kementerian Ketenagakerjaan Indonesia (Kemnaker) yang digunakan untuk mengidentifikasi klien yang terdaftar dalam sistem Kemnaker.
Example:
0a253dab-2f55-42f0-b623-fa4e604a786b
Request-Id
string 
required
String acak yang dihasilkan di sisi klien untuk melindungi dari permintaan duplikat. String ini memastikan bahwa setiap permintaan yang dikirimkan memiliki identifikasi unik, mencegah pemrosesan berulang yang tidak disengaja.
Example:
db9948e4-8a27-4431-a0d0-1466677fa30a
Request-Timestamp
string 
required
Waktu permintaan yang tercatat dalam format ISO8601 menggunakan UTC+0 (UTC). Untuk melakukan transaksi pada zona waktu UTC+7 (WIB), klien harus mengurangi waktu dengan 7 jam. Misalnya, untuk transaksi pada 22 September 2022 pukul 08:51:00 WIB, timestamp yang dikirimkan harus berupa 2022-09-22T01:51:00Z (UTC+0).
Example:
2022-09-22T01:51:00Z
Signature
string 
required
Parameter keamanan yang perlu dihasilkan di sisi backend klien dan dimasukkan ke dalam header permintaan untuk memastikan bahwa permintaan tersebut berasal dari klien yang sah. Parameter ini biasanya berupa token atau signature yang diverifikasi oleh server untuk menghindari akses yang tidak sah.
Example:
HMACSHA256=82b1344baf72ae139038ad0113994fbb7197acb17d66ac10e5885d557ddfd82b
Body Params application/json
title
string 
required
Judul lowongan pekerjaan (maksimum 255 karakter).
employer
object 
required
id
string 
required
Primary key unik milik client yang digunakan untuk mengidentifikasi perusahaan. Panjang maksimum 50 karakter.
region
object 
required
name
string 
required
Nama perusahaan (maksimum 255 karakter).
postal_code
string 
required
Kode pos perusahaan (maksimum 20 karakter).
address
string 
required
Alamat perusahaan.
phone
string 
required
No. telepon perusahaan (maksimum 20 karakter).
email
string 
required
Alamat email perusahaan (maksimum 100 karakter).
license_number
string 
required
NIB perusahaan dari OSS (maksimum 20 karakter).
industry
string 
required
UUID yang mewakili kategori industri perusahaan, diambil dari data master Industri Kemnaker.
about
string 
required
Deskripsi perusahaan.
website
string 
required
Website perusahaan (maksimum 100 karakter).
latitude
string 
required
Koordinat lokasi latitude perusahaan.
longitude
string 
required
Koordinat lokasi longitude perusahaan.
logo_uri
string 
required
URL logo perusahaan.
cover_uri
string 
required
URL cover perusahaan.
description
string 
required
Deskripsi lowongan pekerjaan.
quota
integer 
required
Kuota lowongan pekerjaan (minimal 1).
qualification
string 
required
Informasi kualifikasi lowongan pekerjaan.
industry
string 
required
UUID industri untuk lowongan pekerjaan dari Kemnaker.
job_type
string 
required
UUID tipe pekerjaan untuk lowongan pekerjaan dari Kemnaker.
job_function
string 
required
UUID bidang usaha untuk lowongan pekerjaan dari Kemnaker
region
object 
required
type
enum<string> 
required
Tipe wilayah yang digunakan untuk mengklasifikasikan lokasi.
Allowed values:
citysub_districtvillage
id
string 
required
UUID yang mewakili wilayah yang dipetakan dari data master wilayah Kemnaker.
country_code
null 
required
Kode negara menggunakan dua huruf sesuai standar internasional, misalnya id untuk Indonesia, jp untuk Jepang, dan seterusnya.
gender
enum<string>  | enum<null> 
optional
Jenis kelamin untuk lowongan pekerjaan.
Allowed values:
malefemale
min_education
string  | null 
optional
UUID pendidikan minimum untuk lowongan pekerjaan dari Kemnaker.
min_salary
object  | null 
optional
Gaji minimum untuk lowongan pekerjaan.
currency
string 
required
Mata uang untuk gaji minimum lowongan pekerjaan.
amount
integer 
required
Jumlah gaji minimum untuk lowongan pekerjaan
max_salary
object  | null 
optional
Gaji maksimal untuk lowongan pekerjaan.
currency
string 
required
Mata uang untuk gaji maksimal lowongan pekerjaan.
amount
integer 
required
Jumlah gaji maksimal untuk lowongan pekerjaan
marital
enum<string>  | enum<null> 
optional
Status pernikahan untuk lowongan pekerjaan.
Allowed values:
singlemarried
min_age
integer  | null 
optional
Usia minimum untuk lowongan pekerjaan.
max_age
integer  | null 
optional
Usia maksimal untuk lowongan pekerjaan.
min_experience
null 
optional
Pengalaman kerja minimum (tahun) untuk lowongan pekerjaan.
disability_allowed
boolean 
required
Disabilitas diperbolehkan untuk lowongan pekerjaan.
skills
array[string]
required
Keterampilan untuk lowongan pekerjaan.
client_url
string 
required
URL lowongan pekerjaan klien.
expire_at
string 
required
Tanggal terakhir lowongan pekerjaan tayang.
status
enum<string> 
required
Status lowongan pekerjaan.
Allowed values:
openclosedexpired
Example
{
  "title": "Junior Administrator",
  "employer": {
    "id": "1edd9893-f1a3-45dd-89d4-bc4dc9a071d0",
    "region": {
      "type": "city",
      "id": "73c670c2-bd42-491a-a76b-f17c2edb6680",
      "country_code": null
    },
    "name": "PT Testing",
    "postal_code": "12850",
    "address": "Gedung Semanggi Square, Jl. Semanggi Raya No.1A, RT.1/RW.5, Semanggi, Kec. Karet, Kota Jakarta Selatan, Daerah Khusus Ibukota Jakarta 12850",
    "phone": "021-8791124",
    "email": "info@testing.com",
    "license_number": "909201921212",
    "industry": "898b0b80-4ce3-4b6f-3413-f6b518e9c557",
    "about": "PT Testing adalah perusahaan yang berfokus pada pengelolaan kelapa sawit.",
    "website": "https://www.testing.com",
    "latitude": "-6.238028583492814",
    "longitude": "106.82998199652216",
    "logo_uri": "https://kemnaker-dev.kemnaker.go.id/kelembagaan/institution_logos/f38a8e36-05b9-44b9-8de3-a44478ab8265/632e66cc5f233.png",
    "cover_uri": "https://kemnaker-dev.kemnaker.go.id/kelembagaan/institution_pictures/da59aa44-e013-4292-a6da-6b99c6b5c732/62e5104925f6d.jpg"
  },
  "description": "Lorem Ipsum is simply dummy text of the printing and typesetting industry. Lorem Ipsum has been the industry's standard dummy text ever since the 1500s, when an unknown printer took a galley of type and scrambled it to make a type specimen book. It has survived not only five centuries, but also the leap into electronic typesetting, remaining essentially unchanged. It was popularised in the 1960s with the release of Letraset sheets containing Lorem Ipsum passages, and more recently with desktop publishing software like Aldus PageMaker including versions of Lorem Ipsum.",
  "quota": 2,
  "qualification": "Lorem Ipsum is simply dummy text of the printing and typesetting industry. Lorem Ipsum has been the industry's standard dummy text ever since the 1500s, when an unknown printer took a galley of type and scrambled it to make a type specimen book. It has survived not only five centuries, but also the leap into electronic typesetting, remaining essentially unchanged. It was popularised in the 1960s with the release of Letraset sheets containing Lorem Ipsum passages, and more recently with desktop publishing software like Aldus PageMaker including versions of Lorem Ipsum.",
  "industry": "898b0b80-4ce3-4b6f-3413-f6b518e9c557",
  "job_type": "0dc1aaf7-9935-442b-ab32-8bae23284af9",
  "job_function": "b568e24e-40fc-001b-f03b-e48402007b44",
  "region": {
    "type": "city",
    "id": "73c670c2-bd42-491a-a76b-f17c2edb6680",
    "country_code": null
  },
  "gender": null,
  "min_education": "d9c9b6f2-6ee9-4ec7-9dfd-21904b711445",
  "min_salary": {
    "currency": "IDR",
    "amount": 5000000
  },
  "max_salary": {
    "currency": "IDR",
    "amount": 10000000
  },
  "marital": null,
  "min_age": 25,
  "max_age": 40,
  "min_experience": null,
  "disability_allowed": false,
  "skills": [
    "engineering",
    "microsoft_office",
    "management"
  ],
  "client_url": "https://www.komdigi.go.id/",
  "expire_at": "2025-02-15",
  "status": "open"
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location -g --request PUT 'https://joss.kemnaker.go.id/api/v1/jobs/9e026c9e-0d8a-4c42-979c-989dde40d40c/industrial-vacancy' \
--header 'Client-Id;' \
--header 'Request-Id;' \
--header 'Request-Timestamp;' \
--header 'Signature;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "title": "Junior Administrator",
    "employer": {
        "id": "1edd9893-f1a3-45dd-89d4-bc4dc9a071d0",
        "region": {
            "type": "city",
            "id": "73c670c2-bd42-491a-a76b-f17c2edb6680",
            "country_code": null
        },
        "name": "PT Testing",
        "postal_code": "12850",
        "address": "Gedung Semanggi Square, Jl. Semanggi Raya No.1A, RT.1/RW.5, Semanggi, Kec. Karet, Kota Jakarta Selatan, Daerah Khusus Ibukota Jakarta 12850",
        "phone": "021-8791124",
        "email": "info@testing.com",
        "license_number": "909201921212",
        "industry": "898b0b80-4ce3-4b6f-3413-f6b518e9c557",
        "about": "PT Testing adalah perusahaan yang berfokus pada pengelolaan kelapa sawit.",
        "website": "https://www.testing.com",
        "latitude": "-6.238028583492814",
        "longitude": "106.82998199652216",
        "logo_uri": "https://kemnaker-dev.kemnaker.go.id/kelembagaan/institution_logos/f38a8e36-05b9-44b9-8de3-a44478ab8265/632e66cc5f233.png",
        "cover_uri": "https://kemnaker-dev.kemnaker.go.id/kelembagaan/institution_pictures/da59aa44-e013-4292-a6da-6b99c6b5c732/62e5104925f6d.jpg"
    },
    "description": "Lorem Ipsum is simply dummy text of the printing and typesetting industry. Lorem Ipsum has been the industry'\''s standard dummy text ever since the 1500s, when an unknown printer took a galley of type and scrambled it to make a type specimen book. It has survived not only five centuries, but also the leap into electronic typesetting, remaining essentially unchanged. It was popularised in the 1960s with the release of Letraset sheets containing Lorem Ipsum passages, and more recently with desktop publishing software like Aldus PageMaker including versions of Lorem Ipsum.",
    "quota": 2,
    "qualification": "Lorem Ipsum is simply dummy text of the printing and typesetting industry. Lorem Ipsum has been the industry'\''s standard dummy text ever since the 1500s, when an unknown printer took a galley of type and scrambled it to make a type specimen book. It has survived not only five centuries, but also the leap into electronic typesetting, remaining essentially unchanged. It was popularised in the 1960s with the release of Letraset sheets containing Lorem Ipsum passages, and more recently with desktop publishing software like Aldus PageMaker including versions of Lorem Ipsum.",
    "industry": "898b0b80-4ce3-4b6f-3413-f6b518e9c557",
    "job_type": "0dc1aaf7-9935-442b-ab32-8bae23284af9",
    "job_function": "b568e24e-40fc-001b-f03b-e48402007b44",
    "region": {
        "type": "city",
        "id": "73c670c2-bd42-491a-a76b-f17c2edb6680",
        "country_code": null
    },
    "gender": null,
    "min_education": "d9c9b6f2-6ee9-4ec7-9dfd-21904b711445",
    "min_salary": {
        "currency": "IDR",
        "amount": 5000000
    },
    "max_salary": {
        "currency": "IDR",
        "amount": 10000000
    },
    "marital": null,
    "min_age": 25,
    "max_age": 40,
    "min_experience": null,
    "disability_allowed": false,
    "skills": [
        "engineering",
        "microsoft_office",
        "management"
    ],
    "client_url": "https://www.komdigi.go.id/",
    "expire_at": "2025-02-15",
    "status": "open"
}'

Responses

🟢200Success
application/json
Body
data
object 
required
id
string 
required
reference
string 
required
title
string 
required
created_at
string 
required
meta
object 
required
client_ip
string 
required
hostname
string 
required
version
string 
required
Example
{
  "data": {
    "id": "8fe2b729-93d1-4866-beb2-bba4a712b3eb",
    "reference": "8bf6ef74-ebd4-41f8-8b3a-c55277a973b8",
    "title": "Junior Administrator",
    "created_at": "2025-01-17 00:13:50"
  },
  "meta": {
    "client_ip": "10.233.79.152",
    "hostname": "joss-api-857d4c5fc5-wcjkb",
    "version": "v1"
  }
}
Previous
Delete Company
Next
Find Job Vacancy
Built with