Put Institution

Request

Path Params

id

string

required

Primary key unik milik client yang digunakan untuk mengidentifikasi lembaga. 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:

2024-12-19T11:13:49Z

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 lembaga (maksimum 255 karakter).

address

string

required

Alamat lengkap lembaga.

phone

string

required

No. telepon lembaga (maksimum 20 karakter).

email

string | null

optional

Alamat email lembaga (maksimum 100 karakter).

logo_uri

string

required

URL logo lembaga.

Example

{
    "region": {
        "type": "city",
        "id": "73c670c2-bd42-491a-a76b-f17c2edb6680",
        "country_code": null
    },
    "name": "KEMNAKER TESTING",
    "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": "081213956825",
    "email": null,
    "logo_uri": "https://kemnaker-dev.kemnaker.go.id/kelembagaan/institution_logos/f38a8e36-05b9-44b9-8de3-a44478ab8265/632e66cc5f233.png"
}

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location -g --request PUT 'https://toss.kemnaker.go.id/api/v1/institutions/f67556be-8d02-4b93-9b25-9b46d8db38c1' \
--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": "KEMNAKER TESTING",
    "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": "081213956825",
    "email": null,
    "logo_uri": "https://kemnaker-dev.kemnaker.go.id/kelembagaan/institution_logos/f38a8e36-05b9-44b9-8de3-a44478ab8265/632e66cc5f233.png"
}'

Responses

🟢200Success

application/json

Body

data

object

required

id

string

required

reference

string

required

name

string

required

created_at

string

required