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

Put Training

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

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
Body Params application/json
title
string 
required
Judul pelatihan (maksimum 255 karakter).
description
string 
required
Deskripsi pelatihan.
address
string  | null 
optional
Lokasi alamat pelatihan.
region
object  | null 
optional
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.
media
enum<string> 
required
Media pelatihan.
Allowed values:
onlineofflineblended
difficulty_level
enum<string> 
required
Tingkat kesulitan pelatihan.
Allowed values:
beginnerintermediateexpert
price
integer  | null 
optional
Biaya mengikuti pelatihan.
certified
boolean 
required
Apakah pelatihan akan mendapatkan sertifikat?
bnsp_certified
boolean 
required
Apakah pelatihan akan mendapatkan sertifikat BNSP?
quota
integer 
required
Kuota peserta pelatihan.
expired_date
string <date>
required
Tanggal pelatihan berakhir tayang. Format: Y-m-d.
start_date
string <date>
required
Tanggal mulai pelatihan. Format: Y-m-d.
finish_date
string <date>
required
Tanggal selesai pelatihan. Format: Y-m-d.
cover_uri
string 
required
URL cover pelatihan.
sub_vocational
string 
required
UUID sub-kejuruan yang dipetakan dari data Kemnaker.
status
enum<string> 
required
Status pelatihan.
Allowed values:
openclosedexpired
client_url
string 
required
URL pelatihan klien.
institution
object 
required
id
string 
required
Primary key unik milik client yang digunakan untuk mengidentifikasi lembaga. Panjang maksimum 50 karakter.
region
object 
required
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.
competencies
array[string | null] | null 
optional
Unit kompetensi pelatihan.
instructors
array [object {4}]  | null 
optional
Instruktur pelatihan.
name
string 
required
Nama instruktur.
email
string 
required
Alamat email instruktur.
photo_url
string  | null 
optional
URL foto instruktur.
resume_url
string  | null 
optional
URL cv/biodata instruktur.
Example
{
    "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,
    "region": {
        "type": "city",
        "id": "73c670c2-bd42-491a-a76b-f17c2edb6680"
    },
    "media": "online",
    "difficulty_level": "beginner",
    "price": 250000,
    "certified": true,
    "bnsp_certified": false,
    "quota": 10,
    "expired_date": "2025-02-28",
    "start_date": "2025-03-01",
    "finish_date": "2025-05-31",
    "cover_uri": "https://kemnaker-dev.kemnaker.go.id/kelembagaan/institution_pictures/da59aa44-e013-4292-a6da-6b99c6b5c732/62e5104925f6d.jpg",
    "sub_vocational": "855070b6-e8a6-40ec-84bd-70c8a34c2be9",
    "status": "open",
    "client_url": "https://www.komdigi.go.id/",
    "institution": {
        "id": "d34ba41d-7d6a-44f3-ad9e-662cac011861",
        "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"
    },
    "competencies": [
        "Marketing",
        "Communication"
    ],
    "instructors": [
        {
            "name": "Test",
            "email": "abc@gmail.com",
            "photo_url": "https://kemnaker-dev.kemnaker.go.id/kelembagaan/institution_logos/f38a8e36-05b9-44b9-8de3-a44478ab8265/632e66cc5f233.png",
            "resume_url": null
        }
    ]
}

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://toss.kemnaker.go.id/api/v1/trainings/9e026c9e-0d8a-4c42-979c-989dde40d40c' \
--header 'Client-Id;' \
--header 'Request-Id;' \
--header 'Request-Timestamp;' \
--header 'Signature;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "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,
    "region": {
        "type": "city",
        "id": "73c670c2-bd42-491a-a76b-f17c2edb6680"
    },
    "media": "online",
    "difficulty_level": "beginner",
    "price": 250000,
    "certified": true,
    "bnsp_certified": false,
    "quota": 10,
    "expired_date": "2025-02-28",
    "start_date": "2025-03-01",
    "finish_date": "2025-05-31",
    "cover_uri": "https://kemnaker-dev.kemnaker.go.id/kelembagaan/institution_pictures/da59aa44-e013-4292-a6da-6b99c6b5c732/62e5104925f6d.jpg",
    "sub_vocational": "855070b6-e8a6-40ec-84bd-70c8a34c2be9",
    "status": "open",
    "client_url": "https://www.komdigi.go.id/",
    "institution": {
        "id": "d34ba41d-7d6a-44f3-ad9e-662cac011861",
        "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"
    },
    "competencies": [
        "Marketing",
        "Communication"
    ],
    "instructors": [
        {
            "name": "Test",
            "email": "abc@gmail.com",
            "photo_url": "https://kemnaker-dev.kemnaker.go.id/kelembagaan/institution_logos/f38a8e36-05b9-44b9-8de3-a44478ab8265/632e66cc5f233.png",
            "resume_url": null
        }
    ]
}'

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": "348178eb-1917-4a4b-adc1-37864baad97a",
        "reference": "088738e6-d1ab-46fd-a11e-c357d5159eeb",
        "title": "Social Media Marketing",
        "created_at": "2025-01-17 02:35:19"
    },
    "meta": {
        "client_ip": "10.233.79.152",
        "hostname": "toss-backend-api-98d6cf864-2fctc",
        "version": "v1"
    }
}
Previous
Delete Institution
Next
Find Training
Built with