Find Institution

API ini digunakan untuk melihat detail informasi lembaga berdasarkan ID yang diberikan. Dengan menggunakan ID, pengguna dapat mengakses data lengkap tentang lembaga yang terdaftar di sistem.

Request

Path Params

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

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Body

data

object

required

string

required

reference

string

required

name

string

required

null

required

phone

string

required

address

string

required

logo_uri

string

required

region

object

required

meta

object

required

client_ip

string

required

hostname

string

required

version

string

required

Example

{
    "data": {
        "id": "0ba09c6e-4e27-4421-906b-16d3979c0583",
        "reference": "d34ba41d-7d6a-44f3-ad9e-662cac011861",
        "name": "KEMNAKER TESTING",
        "email": null,
        "phone": "081213956825",
        "address": "Gedung Semanggi Square, Jl. Semanggi Raya No.1A, RT.1/RW.5, Semanggi, Kec. Karet, Kota Jakarta Selatan, Daerah Khusus Ibukota Jakarta 12850",
        "logo_uri": "https://kemnaker-dev.oss-accelerate.aliyuncs.com/institution-logos/client-c186e1e8-df25-4656-bff6-a16739bca233/institution-d34ba41d-7d6a-44f3-ad9e-662cac011861/d34ba41d-7d6a-44f3-ad9e-662cac011861-kemnaker-testing-logo.png",
        "region": {
            "id": "40a9b9eb-fc07-42a4-8611-4154e18ee707",
            "regionable_type": "city",
            "regionable_id": "73c670c2-bd42-491a-a76b-f17c2edb6680",
            "key": "kota-jakarta-selatan-dki-jakarta-indonesia",
            "name": "Kota Jakarta Selatan, DKI Jakarta, Indonesia",
            "created_at": "2024-12-27 15:51:57",
            "updated_at": "2024-12-27 15:51:57"
        }
    },
    "meta": {
        "client_ip": "10.233.95.245",
        "hostname": "toss-backend-api-98d6cf864-2fctc",
        "version": "v1"
    }
}