TOSS
  1. Pelatihan
TOSS
  • Gambaran Umum
  • Autentikasi
  • Referensi Data
  • Endpoint API
    • Lembaga
      • Put Institution
      • Find Institution
      • Delete Institution
    • Pelatihan
      • Put Training
        PUT
      • Find Training
        GET
      • Delete Training
        DELETE
  1. Pelatihan

Find Training

Testing
GET
{{base_url}}/api/v1/trainings/{id}
API ini digunakan untuk melihat detail informasi pelatihan berdasarkan ID yang diberikan. Dengan menggunakan ID, pengguna dapat mengakses data lengkap tentang pelatihan yang terdaftar di sistem.

Request

Path Params
id
string 
required
ID unik yang digunakan untuk mengidentifikasi pelatihan dalam sistem klien. Ini adalah primary key yang diberikan untuk setiap entri pelatihan 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:
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
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location -g --request GET 'https://toss.kemnaker.go.id/api/v1/trainings/9e026c9e-0d8a-4c42-979c-989dde40d40c' \
--header 'Client-Id;' \
--header 'Request-Id;' \
--header 'Request-Timestamp;' \
--header 'Signature;'

Responses

🟢200Success
application/json
Body
data
object 
required
id
string 
required
reference
string 
required
title
string 
required
description
string 
required
address
null 
required
media
string 
required
difficulty_level
string 
required
price
integer 
required
certified
boolean 
required
bnsp_certified
boolean 
required
quota
integer 
required
start_date
string 
required
finish_date
string 
required
expired_date
string 
required
status
string 
required
client_url
string 
required
cover_uri
string 
required
institution
object 
required
sub_vocational
object 
required
region
object 
required
competencies
array [object {5}] 
required
instructors
array [object {9}] 
required
meta
object 
required
client_ip
string 
required
hostname
string 
required
version
string 
required
Example
{
    "data": {
        "id": "348178eb-1917-4a4b-adc1-37864baad97a",
        "reference": "088738e6-d1ab-46fd-a11e-c357d5159eeb",
        "title": "Social Media Marketing",
        "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.",
        "address": null,
        "type": "online",
        "difficulty_level": "beginner",
        "price": 250000,
        "certified": true,
        "bnsp_certified": false,
        "quota": 10,
        "start_date": "2025-03-01",
        "finish_date": "2025-05-31",
        "expired_date": "2025-02-28",
        "status": "open",
        "client_url": "https://www.komdigi.go.id/",
        "cover_uri": "https://kemnaker-dev.oss-accelerate.aliyuncs.com/training-cover-images/client-c186e1e8-df25-4656-bff6-a16739bca233/training-088738e6-d1ab-46fd-a11e-c357d5159eeb/088738e6-d1ab-46fd-a11e-c357d5159eeb-social-media-marketing-cover.jpeg",
        "institution": {
            "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"
            }
        },
        "sub_vocational": {
            "id": "855070b6-e8a6-40ec-84bd-70c8a34c2be9",
            "name": "IT GOVERNANCE",
            "vocational": {
                "id": "3bacd8da-2eb7-4fbb-8c26-b0dd36feaca2",
                "code": "TIK",
                "name": "TEKNOLOGI INFORMASI DAN KOMUNIKASI",
                "description": "Pelajari tentang segala software dan hardware untuk menyampaikan informasi antar media.",
                "vocational_group": {
                    "id": "dbaefe0f-3014-4bb6-9b0d-a5c1dde3fb39",
                    "name": "TATA NIAGA"
                }
            }
        },
        "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"
        },
        "competencies": [
            {
                "id": "964e52d1-7461-427f-9c94-ece069c3afc3",
                "training_id": "348178eb-1917-4a4b-adc1-37864baad97a",
                "name": "Marketing",
                "created_at": "2025-01-17 10:42:02",
                "updated_at": "2025-01-17 10:42:02"
            },
            {
                "id": "fc710fd7-7c46-4c81-bda2-c447ff95ad96",
                "training_id": "348178eb-1917-4a4b-adc1-37864baad97a",
                "name": "Communication",
                "created_at": "2025-01-17 10:42:02",
                "updated_at": "2025-01-17 10:42:02"
            }
        ],
        "instructors": [
            {
                "id": "e38af3c0-3327-4319-b281-26a50e0fcc0f",
                "training_id": "348178eb-1917-4a4b-adc1-37864baad97a",
                "name": "Test",
                "email": "abc@gmail.com",
                "resume_url": null,
                "photo_id": "84e26b0b-a345-44f2-b6cb-c5326d6f2fb5",
                "photo_origin_url": "https://kemnaker-dev.kemnaker.go.id/kelembagaan/institution_logos/f38a8e36-05b9-44b9-8de3-a44478ab8265/632e66cc5f233.png",
                "created_at": "2025-01-17 10:42:02",
                "updated_at": "2025-01-17 10:42:07"
            }
        ]
    },
    "meta": {
        "client_ip": "10.233.95.245",
        "hostname": "toss-backend-api-578b48b99c-pn4q9",
        "version": "v1"
    }
}
Previous
Put Training
Next
Delete Training
Built with