API Documentation
Dokumentasi lengkap untuk SSO Malinau API. Integrasikan aplikasi Anda dengan sistem Single Sign-On kami.
Base URL
https://api.sso.malinau.go.id/api-v1Authentication
POST
/auth/loginLogin
Melakukan login dan mendapatkan OTP yang dikirim ke email
Headers
Application-Keyyour-app-keyRequired
Content-Typeapplication/jsonRequired
Request Body
json
{
"identity": "1000000000000001"
}POST
/auth/registerRegister
Mendaftarkan user baru ke sistem
Headers
Application-Keyyour-app-keyRequired
Content-Typeapplication/jsonRequired
Request Body
json
{
"name": "Jhon Doe",
"email": "admin@admin.com",
"password": "admin123",
"phone": "085732787328",
"type": "NIP",
"identity": "1000000000000001"
}POST
/auth/verifyVerify OTP
Memverifikasi OTP dan mendapatkan access token
Headers
Application-Keyyour-app-keyRequired
Content-Typeapplication/jsonRequired
Request Body
json
{
"userId": "8bf36ce8-742f-4358-aad2-ecb8fd57f560",
"otp": "123456"
}POST
/auth/logoutLogout
Logout dan invalidate refresh token
Headers
AuthorizationBearer your-access-tokenRequired
Content-Typeapplication/jsonRequired
Request Body
json
{
"refreshToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}POST
/auth/refresh-tokenRefresh Token
Mendapatkan access token baru menggunakan refresh token
Headers
Content-Typeapplication/jsonRequired
Request Body
json
{
"refreshToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}User Profile (Me)
GET
/meGet My Profile
Mendapatkan informasi profil user yang sedang login
Headers
AuthorizationBearer your-access-tokenRequired
PATCH
/meUpdate My Profile
Mengupdate informasi profil user yang sedang login
Headers
AuthorizationBearer your-access-tokenRequired
Content-Typeapplication/jsonRequired
Request Body
json
{
"phone": "082177521111",
"email": "admin@admin.com",
"profile": {
"name": "Jhon Doe",
"externalId": "1",
"address": "JL Merdeka Update",
"village": "Gedung Nasional Update",
"district": "Taman Sari Update",
"city": "Pangkalpinang Update",
"province": "Bangka Belitung Update"
}
}Error Codes
4xx Client Errors
400- Bad Request401- Unauthorized403- Forbidden404- Not Found422- Unprocessable Entity
5xx Server Errors
500- Internal Server Error502- Bad Gateway503- Service Unavailable
Next.js Middleware Package
npm i sso-malinau-nextjs-middleware
Package middleware untuk validasi autentikasi SSO Kabupaten Malinau pada aplikasi Next.js (App Router)
Butuh Bantuan?
Jika Anda memiliki pertanyaan atau membutuhkan bantuan dalam integrasi API, silakan hubungi tim support kami.