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

Put Company

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

Request

Path Params
id
string 
required
Primary key unik milik client yang digunakan untuk mengidentifikasi perusahaan. Panjang maksimum 50 karakter.
Example:
f67556be-8d02-4b93-9b25-9b46d8db38c1
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
region
object 
required
type
enum<string> 
required
Tipe wilayah yang digunakan untuk mengklasifikasikan lokasi.
Allowed values:
countryprovincecitysub_districtvillage
id
string 
required
UUID yang mewakili wilayah yang dipetakan dari data master wilayah Kemnaker.
country_code
string  | null 
optional
Kode negara menggunakan dua huruf sesuai standar internasional, misalnya id untuk Indonesia, jp untuk Jepang, dan seterusnya.
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  | null 
optional
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  | null 
optional
Website perusahaan (maksimum 100 karakter).
latitude
string  | null 
optional
Koordinat lokasi latitude perusahaan.
longitude
string  | null 
optional
Koordinat lokasi longitude perusahaan.
logo_uri
string 
required
URL logo perusahaan.
cover_uri
string 
required
URL cover perusahaan.
Example
{
  "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"
}

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/employers/f67556be-8d02-4b93-9b25-9b46d8db38c1/company' \
--header 'Client-Id;' \
--header 'Request-Id;' \
--header 'Request-Timestamp;' \
--header 'Signature;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "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"
}'

Responses

🟢200Success
application/json
Body
data
object 
required
id
string 
required
name
string 
required
reference
string 
required
created_at
string 
required
meta
object 
required
client_ip
string 
required
hostname
string 
required
version
string 
required
Example
{
  "data": {
    "id": "91b9dabd-5d0e-4acc-aa8e-5586b3edd21f",
    "name": "PT Testing",
    "reference": "1edd9893-f1a3-45dd-89d4-bc4dc9a071d0",
    "created_at": "2025-01-16 23:31:42"
  },
  "meta": {
    "client_ip": "10.233.79.152",
    "hostname": "joss-api-99c56989f-9szds",
    "version": "v1"
  }
}
Previous
Referensi Data
Next
Find Company
Built with