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-v1

Authentication

POST

/auth/login

Melakukan login dan mendapatkan OTP yang dikirim ke email

Headers

Application-Keyyour-app-key

Required

Content-Typeapplication/json

Required

Request Body

json

{
  "identity": "1000000000000001"
}

POST

/auth/register

Mendaftarkan user baru ke sistem

Headers

Application-Keyyour-app-key

Required

Content-Typeapplication/json

Required

Request Body

json

{
  "name": "Jhon Doe",
  "email": "admin@admin.com",
  "password": "admin123",
  "phone": "085732787328",
  "type": "NIP",
  "identity": "1000000000000001"
}

POST

/auth/verify

Verify OTP

Memverifikasi OTP dan mendapatkan access token

Headers

Application-Keyyour-app-key

Required

Content-Typeapplication/json

Required

Request Body

json

{
  "userId": "8bf36ce8-742f-4358-aad2-ecb8fd57f560",
  "otp": "123456"
}

POST

/auth/logout

Logout

Logout dan invalidate refresh token

Headers

AuthorizationBearer your-access-token

Required

Content-Typeapplication/json

Required

Request Body

json

{
  "refreshToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}

POST

/auth/refresh-token

Refresh Token

Mendapatkan access token baru menggunakan refresh token

Headers

Content-Typeapplication/json

Required

Request Body

json

{
  "refreshToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}

User Profile (Me)

GET

/me

Get My Profile

Mendapatkan informasi profil user yang sedang login

Headers

AuthorizationBearer your-access-token

Required

PATCH

/me

Update My Profile

Mengupdate informasi profil user yang sedang login

Headers

AuthorizationBearer your-access-token

Required

Content-Typeapplication/json

Required

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 Request
401 - Unauthorized
403 - Forbidden
404 - Not Found
422 - Unprocessable Entity

5xx Server Errors

500 - Internal Server Error
502 - Bad Gateway
503 - Service Unavailable

Next.js Middleware Package

npm i saget-auth-middleware

Package middleware untuk validasi autentikasi SSO Kabupaten Malinau pada aplikasi Next.js (App Router)

Instalasi

https://www.npmjs.com/package/saget-auth-middleware

Butuh Bantuan?

Jika Anda memiliki pertanyaan atau membutuhkan bantuan dalam integrasi API, silakan hubungi tim support kami.

{ "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" } }